Handbook

LCDL documentation migration map

Canonical paths are under nested docs/ folders. Legacy flat paths under docs/*.md are kept as stub pages (with hide_from_nav: true) that link forward to avoid breaking bookmarks and external links.

Updated

Migration table

Old path New canonical path Action
docs/WHAT-IS-LCDL.md docs/start/what-is-lcdl.md Move + stub
docs/GETTING-STARTED.md docs/start/getting-started.md Move + stub
docs/FIRST-HOUR.md docs/start/first-hour.md Move + stub
docs/ADOPTION.md docs/start/adoption.md Move + stub
docs/TROUBLESHOOTING.md docs/start/troubleshooting.md Move + stub
docs/CONTRACT-SPEC.md docs/reference/CONTRACT-SPEC.md Move + stub
docs/SCHEMAS.md docs/reference/SCHEMAS.md Move + stub
docs/CLIENT-API.md docs/reference/CLIENT-API.md Move + stub
docs/operators/** docs/reference/operators/** Move + stub dir
docs/EXECUTION-ENGINE.md docs/guides/EXECUTION-ENGINE.md Move + stub
docs/RAG.md docs/guides/RAG.md Move + stub
docs/VERIFICATION.md docs/guides/VERIFICATION.md Move + stub
docs/REPAIR-LOOPS.md docs/guides/REPAIR-LOOPS.md Move + stub
docs/MODEL-ROUTING.md docs/guides/MODEL-ROUTING.md Move + stub
docs/PROMPT-CACHING.md docs/guides/PROMPT-CACHING.md Move + stub
docs/TASK-PACKS.md docs/guides/TASK-PACKS.md Move + stub
docs/GRAPH.md docs/guides/GRAPH.md Move + stub
docs/CONTEXT-PACKS.md docs/guides/CONTEXT-PACKS.md Move + stub
docs/CODING-EXECUTOR.md docs/guides/CODING-EXECUTOR.md Move + stub
docs/PLAYWRIGHT-DISCOVERY.md docs/guides/PLAYWRIGHT-DISCOVERY.md Move + stub
docs/PAGE-MECHANICS.md docs/guides/PAGE-MECHANICS.md Move + stub
docs/EXTRACTION-CONVERGENCE.md docs/guides/EXTRACTION-CONVERGENCE.md Move + stub
docs/GAME-ENGINE.md docs/guides/GAME-ENGINE.md Move + stub
docs/GAMES-*.md docs/guides/GAMES-*.md Move + stubs
docs/FOR-AGENTS.md docs/agents/for-agents.md Move + stub
docs/CURSOR-INTEGRATION.md docs/agents/CURSOR-INTEGRATION.md Move + stub
docs/MCP-CLIENT.md docs/agents/MCP-CLIENT.md Move + stub
docs/MCP-SIDECAR.md docs/agents/MCP-SIDECAR.md Move + stub
docs/KNOWN-LIMITATIONS.md docs/enterprise/KNOWN-LIMITATIONS.md Move + stub
docs/ALPHA-ROADMAP.md docs/enterprise/ALPHA-ROADMAP.md Move + stub
docs/BENCHMARKS.md docs/enterprise/BENCHMARKS.md Move + stub
docs/CHEAP-MODEL-OPERATING-GUIDE.md docs/enterprise/CHEAP-MODEL-OPERATING-GUIDE.md Move + stub
docs/DOGFOODING.md docs/enterprise/DOGFOODING.md Move + stub
docs/RELEASE-CHECKLIST.md docs/contribute/RELEASE-CHECKLIST.md Move + stub
docs/WEBSITE-PUBLISHING.md docs/contribute/WEBSITE-PUBLISHING.md Move + stub

New pages (no prior path): docs/index.md, docs/start/choose-your-path.md, docs/start/installation.md, docs/start/first-task.md, docs/tutorials/**, docs/examples/index.md, docs/reference/index.md, docs/reference/task-catalog.md, docs/guides/README.md, docs/agents/index.md, docs/enterprise/index.md, docs/contribute/task-authoring.md, docs/DOCS-*.md, docs/SITEMAP.md, docs/site-meta.json.

Contract pages

No file moves. HTML remains built from src/forge_lcdl/contracts/**/contract.md. Sidebar suppression via nav_exclude_path_prefixes in forge-lcdl-website build.

Redirect metadata

Static Firebase site: prefer stub pages with prominent links. Optional <meta http-equiv="refresh"> not used by default in Markdown handbooks; stubs are sufficient for cutover.