Skip to content

docs: index dor-browser.md spec in AGENTS.md#144

Open
dormouse-bot wants to merge 3 commits into
mainfrom
docs/index-surface-specs
Open

docs: index dor-browser.md spec in AGENTS.md#144
dormouse-bot wants to merge 3 commits into
mainfrom
docs/index-surface-specs

Conversation

@dormouse-bot

Copy link
Copy Markdown
Collaborator

Nightly sweep finding: the AGENTS.md "Specs" index — explicitly meant to point agents to "read the relevant spec before modifying a feature it covers" — was missing two surface specs.

Both build on the surface handle model in the already-indexed dor-cli.md and cross-reference each other, so an agent touching IframePanel.tsx or AgentBrowserPanel.tsx had no index pointer to the spec describing the invariants. This adds two entries matching the existing "Read this when touching:" style.

Docs-only, so no test. Scoped deliberately to the two surface specs; a few other specs (mobile-ui.md, shortcuts.md, auto-update.md, deploy.md) are also absent from the index, but those read more as reference/process docs than "read before touching code X" guidance — happy to fold them in if you'd like the index to be exhaustive.

Both surface specs were missing from the AGENTS.md spec index that points
agents to "read the relevant spec before modifying a feature it covers."
dor-iframe.md (added 2026-06-16, extended by #143) and dor-agent-browser.md
(added 2026-06-12) parallel the already-indexed dor-cli.md they build on.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 18, 2026

Copy link
Copy Markdown

Deploying mouseterm with  Cloudflare Pages  Cloudflare Pages

Latest commit: 603b612
Status: ✅  Deploy successful!
Preview URL: https://084b0cd9.mouseterm.pages.dev
Branch Preview URL: https://docs-index-surface-specs.mouseterm.pages.dev

View logs

@nedtwigg

Copy link
Copy Markdown
Member

@dormouse-bot as you can see in #156, dor-agent-browser.md and dor-iframe.md were both removed, and replaced with dor-browser.md. Please update this PR appropriately.

dormouse-bot and others added 2 commits June 19, 2026 23:03
#156 removed dor-iframe.md and dor-agent-browser.md, replacing both with
dor-browser.md. Merge main and collapse the two index entries into one
pointing at the unified browser surface spec.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@dormouse-bot

Copy link
Copy Markdown
Collaborator Author

Done. Merged main (which carried #156) into this branch and collapsed the two now-removed entries into a single one for the unified spec:

  • dor-agent-browser.md and dor-iframe.md are gone; the new entry points at docs/specs/dor-browser.md and describes the single BrowserPanel (surfaceType: 'browser') with its swappable renderMode (ab-screencast / ab-popout / iframe), covering both the agent-browser screencast viewer and the iframe transparent-proxy renderer.
  • The "Read this when touching:" pointer was rebuilt against Unify iframe + agent-browser into one swappable-renderer browser surface #156's file layout (e.g. BrowserPanel.tsx, browser-surface.ts, SurfacePaneHeader.tsx, the agent-browser-* modules, the iframe-proxy* host/registry files) — all 24 paths verified to exist on the merged branch.

Net change is now one index entry instead of two.

@dormouse-bot dormouse-bot changed the title docs: index dor-iframe and dor-agent-browser specs in AGENTS.md docs: index dor-browser.md spec in AGENTS.md Jun 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants