Agent Docs System Map
Agent docs are the bridge between the wiki brain and portable agent context: hand-written quickrefs explain source systems, while generated packs compile task-specific execution bundles from current wiki truth.
Use this page before creating, merging, or splitting pages under wiki/agent-docs/, or before editing scripts/generate-agent-packs.ts. Use Agent Doc Pack Index to choose packs. Use Wiki Capsules And Agent Doc Packs for the capsule model. Use Generated Surface Contract for source/projection closeout.
Surface Model
| Surface | Path | Ownership |
|---|---|---|
| Hand-written agent-doc quickrefs | wiki/agent-docs/*.md except generated indexes |
Portable setup/checklist docs. They summarize canonical source pages without replacing them. |
| Generated pack index | wiki/agent-docs/README.md and agent-docs/README.md |
Generated by scripts/generate-agent-packs.ts; do not hand-edit. |
| Generated pack files | agent-docs/packs/*.md |
Task-specific execution bundles. Regenerate from source pages and generator definitions. |
| Capsule manifest/index | agent-docs/capsules.json, wiki/meta/brain-capsules.md |
Generated public brain interface. |
| Corpus/consolidation ledgers | wiki/meta/agent-pack-corpus-audit.*, wiki/meta/page-consolidation-audit.* |
Generated review queues with stateful decisions. |
Page Families
| Family | Pages | Job |
|---|---|---|
| Pack and capsule model | Agent Doc Pack Index, this page, Wiki Capsules And Agent Doc Packs, Brain Capsules | Explain generated pack/capsule boundaries and source/projection rules. |
| Bootstrap and config | Bootstrap Sync, Cursor Rules Overview, Tool Hierarchy Compact, Pre-Commit Hooks | Portable setup and harness projection docs. |
| Wiki reader deployment | Bundle Wiki Prebuild, Password Gate Setup, Public Categories Env, Vercel Deploy Checklist | Deploy and privacy controls for the Next.js wiki reader. |
| Ingest, search, and state | Capture Ingest Quickref, QMD Search Setup, State JSON Contract, Integration Recipes Index | Quick routes for adding sources, searching the brain, and keeping sync state visible. |
| Skills and validation | Personal Skills Taxonomy, Dedalus Skills Taxonomy, Wiki Doctor Contract | Skill taxonomy, generated registry, doctors, and validation. |
Merge Decisions
No agent-doc pages were deleted in the 2026-07-01 pass. The quickrefs overlap with canonical pages by design, but their durable job is different: they are portable agent setup and operation cards.
| Cluster | Decision | Reason |
|---|---|---|
| Agent Doc Pack Index, Brain Capsules, Wiki Capsules And Agent Doc Packs, this page | Keep distinct | Generated pack index, generated capsule index, capsule operating model, and directory map answer different questions. |
| Personal Skills Taxonomy and Dedalus Skills Taxonomy | Keep distinct | Personal/default skills and Dedalus-origin skills have different provenance and workspace routing. |
| Bootstrap Sync, Pre-Commit Hooks, and Cursor Rules Overview | Keep distinct | Setup, commit-time validation, and Cursor rule projection fail in different ways. |
| Bundle Wiki Prebuild, Password Gate Setup, Public Categories Env, and Vercel Deploy Checklist | Keep distinct | Build bundling, auth/privacy, visibility filtering, and deployment are separate production gates. |
Page Contract
Every hand-written agent-doc page should state:
- The canonical source page or script.
- When an agent should open the quickref.
- What portable action or checklist it provides.
- What proof or closeout command keeps the surface current.
- What generated pack/source page must be refreshed if behavior changes.
Do not let quickrefs become private forks of source truth. If facts drift, update the canonical page or script first, then update the quickref and regenerate packs.
Closeout
For changes to hand-written quickrefs, run npm run build-index and qmd update && qmd embed. For changes that affect generated packs, capsules, pack definitions, or pack source weighting, run npm run agent-packs:refresh and npm run agent-packs:check before final index/qmd/log closeout.
Timeline
- 2026-07-01 | Created as the category-level map for AGENT DOCS, with surface ownership, page families, no-merge decisions, and the page contract. Source: User request, 2026-07-01