Skip to content

docs: index dor-iframe and dor-agent-browser specs in AGENTS.md#144

Open
dormouse-bot wants to merge 1 commit into
mainfrom
docs/index-surface-specs
Open

docs: index dor-iframe and dor-agent-browser specs in AGENTS.md#144
dormouse-bot wants to merge 1 commit 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

Copy link
Copy Markdown

Deploying mouseterm with  Cloudflare Pages  Cloudflare Pages

Latest commit: a311e0f
Status: ✅  Deploy successful!
Preview URL: https://00852e43.mouseterm.pages.dev
Branch Preview URL: https://docs-index-surface-specs.mouseterm.pages.dev

View logs

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.

1 participant