diff --git a/docs/build.js b/docs/build.js
index 24e9b95d1..ba3e3cbb6 100644
--- a/docs/build.js
+++ b/docs/build.js
@@ -38,6 +38,8 @@ const SECTIONS = [
   { dir: 'features', title: 'Features' },
   { dir: 'reference', title: 'Reference' },
   { dir: 'scenarios', title: 'Scenarios' },
+  { dir: 'concepts', title: 'Concepts' },
+  { dir: 'cookbook', title: 'Cookbook' },
   { dir: 'blog', title: 'Blog' },
 ];
 
@@ -57,6 +59,8 @@ const SECTION_ORDER = {
   ],
   'reference': ['cli', 'sdk', 'config'],
   'scenarios': ['existing-repo', 'solo-dev', 'issue-driven-dev', 'monorepo', 'ci-cd-integration', 'team-of-humans', 'aspire-dashboard'],
+  'concepts': ['your-team', 'memory-and-knowledge', 'parallel-work', 'github-workflow', 'portability'],
+  'cookbook': ['recipes'],
 };
 
 // Parse optional YAML-style frontmatter (--- fenced)
diff --git a/docs/sdk-first-mode.md b/docs/sdk-first-mode.md
index 040e53a42..b60ecac48 100644
--- a/docs/sdk-first-mode.md
+++ b/docs/sdk-first-mode.md
@@ -832,5 +832,5 @@ export default defineSquad({
 ## See Also
 
 - [SDK Reference](./reference/sdk.md) — all SDK exports
-- [Routing Guide](./concepts/routing.md) — deep dive on routing tiers
+- [Routing Guide](./features/routing.md) — deep dive on routing tiers
 - [Governance & Hooks](./sdk/tools-and-hooks.md) — hook pipeline and governance