Handbook
LCDL documentation inventory
Date: 2026-05-16 (refactor baseline). Update when adding/removing pages.
Updated
Counts
| Category | Count | Location |
|---|---|---|
| Narrative / guide Markdown (handbook) | 49+ (reorganized + new) | docs/**/*.md |
| Contract Markdown | 39 | src/forge_lcdl/contracts/*/v1/contract.md |
| Contract JSON sidecars | 39 | src/forge_lcdl/contracts/*/v1/contract.json |
| Operator docs | 8 | docs/reference/operators/*.md (and README) |
| Example scripts | 10+ | examples/ (basic, contracts, operators, rag, mcp, games) |
Page status labels
| Area | Action |
|---|---|
| Onboarding (WHAT-IS, GETTING-STARTED, FIRST-HOUR, ADOPTION, TROUBLESHOOTING) | Keep — moved under docs/start/ + tutorial cross-links |
| Execution, RAG, verification, repair, routing, caching, packs, graph, context | Keep — moved under docs/guides/ or docs/reference/ |
| Schemas, ContractSpec, Client API | Keep — docs/reference/ |
| Operator pages | Keep — docs/reference/operators/ |
| Games cluster | Keep — docs/guides/ with GAMES- prefix filenames |
| FOR-AGENTS, Cursor, MCP | Keep — docs/agents/ |
| Enterprise / meta | Keep — docs/enterprise/, docs/contribute/ |
| Alpha / dogfooding | Keep — less prominent; enterprise/contribute |
| New | docs/index.md, docs/start/choose-your-path.md, docs/tutorials/**, docs/examples/index.md, docs/reference/task-catalog.md, agent/enterprise index pages |
Missing pages (filled by this refactor)
docs/index.md— handbook home.docs/tutorials/101/*.md,201/*.md,301/*.md— structured tutorials.docs/reference/task-catalog.md— grouped task index linking tocontract.mdfiles.docs/examples/index.md— cookbook entry.docs/agents/index.md,docs/enterprise/index.md— hub pages.scripts/audit_docs_site.py— site QA script.
Broken links
Run python3 scripts/audit_docs_site.py after editing docs. Fix reported broken relative links.