docs: split guide lookup tables into grouped reference pages

[antfubot]

Intent

Adopt the Divio documentation system's separation of learning material from lookup material across the docs.

• Guide pages teach. Every pure lookup table in docs/content/1.guide/ (definition fields, options, enums, statuses, event lists, route tables — 30 tables across 14 pages) moves out; each guide keeps a one-or-two-sentence prose summary of the essentials plus a link to its reference section.
• Three new grouped reference pages list. Node-Side API (definition fields, CLI options, storage scopes, RPC function types, broadcast options, streaming lifecycle, remote assets, diagnostics prefixes, auth surface, MCP CLI), Browser-Side API (connectDevframe options, RPC client events, connection statuses, in-page channel error codes), and Hub API (subsystems, launcher fields, duplication strategies, dock categories, hub UI protocol, namespace routes, client runtime, client context, dock entry types). Each section opens by naming what it lists and linking the guide that teaches it.
• Comparison and decision tables stay in the guides — they are explanation, not reference ("in-page channel vs RPC", "shared state vs RPC", "streaming vs events vs shared state", "singular vs hub mounting", the ws/static backend contrast).
• Adapters, frameworks, helpers, and plugins pages keep their tables — each of those pages is already the reference for its own package.
• The duplicated CLI building-blocks table in the standalone-CLI guide now defers to the CLI adapter page; the "The protocol — what the hub UI provider sees" heading is renamed "The hub UI protocol" for a stable anchor.
• AGENTS.md codifies the split as documentation-style rule 4 so future doc edits keep guides and references separate.

All moved anchors were verified against github-slugger (what comark uses for heading ids); pnpm lint and the docs build pass.

---

This PR was created with the help of an agent.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
devframe	Ready	Preview	Aug 27, 2026 12:17pm