diff --git a/astro.config.mjs b/astro.config.mjs
index 45eff6a..06e7563 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -73,45 +73,34 @@ export default defineConfig({
           href: 'https://github.com/constructorfabric/gears-rust',
         },
       ],
-      // Sidebar skeleton — the nine top-level sections from the IA.
-      // Each section is autogenerated from its directory for now (Phase 1).
-      // Explicit ordering/labels are tightened in Phase 3.
+      // Sidebar — the top-level sections from docs/web-docs/toc.md (in the
+      // gears-rust repo). Each section is autogenerated from its directory;
+      // per-page order comes from each page's `sidebar.order` frontmatter. The
+      // CLI section is synced from the cargo-gears repo, not authored here.
       sidebar: [
         {
           label: 'Introduction',
           items: [{ autogenerate: { directory: 'introduction' } }],
         },
         {
-          label: 'Getting Started',
-          items: [{ autogenerate: { directory: 'get-started' } }],
+          label: 'Capabilities',
+          items: [{ autogenerate: { directory: 'capabilities' } }],
         },
         {
-          label: 'CLI',
-          items: [{ autogenerate: { directory: 'cli' } }],
+          label: 'Build with Gears',
+          items: [{ autogenerate: { directory: 'build-with-gears' } }],
         },
         {
           label: 'Concepts',
           items: [{ autogenerate: { directory: 'concepts' } }],
         },
         {
-          label: 'Guides',
-          items: [{ autogenerate: { directory: 'guides' } }],
-        },
-        {
-          label: 'Architecture',
-          items: [{ autogenerate: { directory: 'architecture' } }],
-        },
-        {
-          label: 'Reference',
-          items: [{ autogenerate: { directory: 'reference' } }],
-        },
-        {
-          label: 'Examples',
-          items: [{ autogenerate: { directory: 'examples' } }],
+          label: 'cargo gears CLI',
+          items: [{ autogenerate: { directory: 'cli' } }],
         },
         {
-          label: 'Contributing',
-          items: [{ autogenerate: { directory: 'contributing' } }],
+          label: 'Contribute',
+          items: [{ autogenerate: { directory: 'contribute' } }],
         },
       ],
     }),