{
  "id": "page:docs-user-guide-navigation",
  "_kind": "Page",
  "_file": "wiki/docs/user-guide/navigation.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/user-guide/navigation.md",
    "sourceKind": "repo-docs",
    "title": "Navigation Configuration",
    "displayName": "Navigation Configuration",
    "slug": "docs/user-guide/navigation",
    "articlePath": "wiki/docs/user-guide/navigation.md",
    "article": "\n# Navigation Configuration\n\nThis document defines the navigation structure for the Babysitter User Guide documentation.\n\n---\n\n## Primary Navigation (Header)\n\n```\n+------------------------------------------------------------------------+\n|  [Logo] Babysitter Docs                                                 |\n+------------------------------------------------------------------------+\n|  Home  |  Getting Started  |  Ecosystem  |  Architecture  |  Tutorials  |  Features  |  Harnesses  |  Reference  |  [Search]  |\n+------------------------------------------------------------------------+\n```\n\n---\n\n## Sidebar Navigation\n\n### Getting Started\n\n```yaml\n- section: Getting Started\n  path: /getting-started/\n  items:\n    - title: Overview\n      path: /getting-started/README.md\n    - title: Installation\n      path: /getting-started/installation.md\n    - title: Quickstart\n      path: /getting-started/quickstart.md\n    - title: First Run\n      path: /getting-started/first-run.md\n    - title: Migration (Prod to v6)\n      path: /getting-started/migration.md\n    - title: Upgrade to v6\n      path: /getting-started/upgrade-to-v6.md\n```\n\n### Tutorials\n\n```yaml\n- section: Tutorials\n  path: /tutorials/\n  items:\n    - title: Tutorials Overview\n      path: /tutorials/index.md\n    - title: Build a REST API\n      path: /tutorials/beginner-rest-api.md\n      level: beginner\n    - title: Custom Process\n      path: /tutorials/intermediate-custom-process.md\n      level: intermediate\n    - title: Multi-Phase Workflows\n      path: /tutorials/advanced-multi-phase.md\n      level: advanced\n```\n\n### Ecosystem\n\n```yaml\n- section: Ecosystem\n  path: /ecosystem/\n  items:\n    - title: Ecosystem Overview\n      path: /ecosystem/overview.md\n    - title: babysitter-sdk (core engine)\n      path: /ecosystem/babysitter-sdk.md\n    - title: adapters (the family)\n      path: /ecosystem/adapters.md\n    - title: atlas (catalog & knowledge graph)\n      path: /ecosystem/atlas.md\n    - title: genty (agent runtime)\n      path: /ecosystem/genty.md\n    - title: observer-dashboard\n      path: /ecosystem/observer-dashboard.md\n    - title: kradle (K8s Git forge — MVP)\n      path: /ecosystem/kradle.md\n    - title: kip-sdk (memory substrate — spec only)\n      path: /ecosystem/kip-sdk.md\n```\n\n### Architecture\n\n```yaml\n- section: Architecture\n  path: /architecture.md\n  items:\n    - title: Architecture & How It Fits Together\n      path: /architecture.md\n```\n\n### Features\n\n```yaml\n- section: Features\n  path: /features/\n  items:\n    - title: Features Overview\n      path: /features/index.md\n    - title: Architecture Overview\n      path: /features/architecture-overview.md\n    - title: Two-Loops Architecture\n      path: /features/two-loops-architecture.md\n      highlight: true\n    - title: Adapters\n      path: /features/adapters.md\n      highlight: true\n    - title: Process Library\n      path: /features/process-library.md\n      highlight: true\n    - title: Process Definitions\n      path: /features/process-definitions.md\n    - title: Quality Convergence\n      path: /features/quality-convergence.md\n      highlight: true\n    - title: Best Practices Guide\n      path: /features/best-practices.md\n      highlight: true\n    - title: Breakpoints\n      path: /features/breakpoints.md\n    - title: Hooks\n      path: /features/hooks.md\n    - title: Journal System\n      path: /features/journal-system.md\n    - title: Run Resumption\n      path: /features/run-resumption.md\n    - title: Parallel Execution\n      path: /features/parallel-execution.md\n```\n\n### Harnesses\n\n```yaml\n- section: Harnesses\n  path: /harnesses/\n  items:\n    - title: Install Matrix\n      path: /harnesses/install-matrix.md\n    - title: Claude Code\n      path: /harnesses/claude-code.md\n    - title: Codex\n      path: /harnesses/codex.md\n```\n\n### Reference\n\n```yaml\n- section: Reference\n  path: /reference/\n  items:\n    - title: Reference Overview\n      path: /reference/index.md\n    - title: Adapter Types (all 20)\n      path: /reference/adapter-types.md\n    - title: Slash Commands\n      path: /reference/slash-commands.md\n      highlight: true\n    - title: CLI Reference\n      path: /reference/cli-reference.md\n    - title: Adapters CLI\n      path: /reference/adapters-cli.md\n    - title: Configuration\n      path: /reference/configuration.md\n    - title: Security\n      path: /reference/security.md\n    - title: Error Catalog\n      path: /reference/error-catalog.md\n    - title: Glossary\n      path: /reference/glossary.md\n    - title: FAQ\n      path: /reference/faq.md\n    - title: Troubleshooting\n      path: /reference/troubleshooting.md\n```\n\n---\n\n## Navigation JSON Configuration\n\nFor documentation platforms that use JSON configuration (e.g., Docusaurus, VitePress):\n\n```json\n{\n  \"navbar\": {\n    \"title\": \"Babysitter Docs\",\n    \"logo\": {\n      \"alt\": \"Babysitter Logo\",\n      \"src\": \"img/logo.svg\"\n    },\n    \"items\": [\n      {\n        \"type\": \"doc\",\n        \"docId\": \"index\",\n        \"position\": \"left\",\n        \"label\": \"Home\"\n      },\n      {\n        \"type\": \"doc\",\n        \"docId\": \"getting-started/README\",\n        \"position\": \"left\",\n        \"label\": \"Getting Started\"\n      },\n      {\n        \"type\": \"dropdown\",\n        \"label\": \"Tutorials\",\n        \"position\": \"left\",\n        \"items\": [\n          { \"label\": \"Tutorials Overview\", \"to\": \"/tutorials/\" },\n          { \"label\": \"Build a REST API\", \"to\": \"/tutorials/beginner-rest-api\" },\n          { \"label\": \"Custom Process\", \"to\": \"/tutorials/intermediate-custom-process\" },\n          { \"label\": \"Multi-Phase Workflows\", \"to\": \"/tutorials/advanced-multi-phase\" }\n        ]\n      },\n      {\n        \"type\": \"dropdown\",\n        \"label\": \"Ecosystem\",\n        \"position\": \"left\",\n        \"items\": [\n          { \"label\": \"Ecosystem Overview\", \"to\": \"/ecosystem/overview\" },\n          { \"label\": \"babysitter-sdk (core engine)\", \"to\": \"/ecosystem/babysitter-sdk\" },\n          { \"label\": \"adapters (the family)\", \"to\": \"/ecosystem/adapters\" },\n          { \"label\": \"atlas (catalog & knowledge graph)\", \"to\": \"/ecosystem/atlas\" },\n          { \"label\": \"genty (agent runtime)\", \"to\": \"/ecosystem/genty\" },\n          { \"label\": \"observer-dashboard\", \"to\": \"/ecosystem/observer-dashboard\" },\n          { \"label\": \"kradle (K8s Git forge — MVP)\", \"to\": \"/ecosystem/kradle\" },\n          { \"label\": \"kip-sdk (memory substrate — spec only)\", \"to\": \"/ecosystem/kip-sdk\" }\n        ]\n      },\n      {\n        \"type\": \"doc\",\n        \"docId\": \"architecture\",\n        \"position\": \"left\",\n        \"label\": \"Architecture\"\n      },\n      {\n        \"type\": \"dropdown\",\n        \"label\": \"Features\",\n        \"position\": \"left\",\n        \"items\": [\n          { \"label\": \"Features Overview\", \"to\": \"/features/\" },\n          { \"label\": \"Architecture Overview\", \"to\": \"/features/architecture-overview\" },\n          { \"label\": \"Two-Loops Architecture\", \"to\": \"/features/two-loops-architecture\" },\n          { \"label\": \"Adapters\", \"to\": \"/features/adapters\" },\n          { \"label\": \"Process Library\", \"to\": \"/features/process-library\" },\n          { \"label\": \"Process Definitions\", \"to\": \"/features/process-definitions\" },\n          { \"label\": \"Quality Convergence\", \"to\": \"/features/quality-convergence\" },\n          { \"label\": \"Best Practices Guide\", \"to\": \"/features/best-practices\" },\n          { \"label\": \"Breakpoints\", \"to\": \"/features/breakpoints\" },\n          { \"label\": \"Hooks\", \"to\": \"/features/hooks\" },\n          { \"label\": \"Journal System\", \"to\": \"/features/journal-system\" },\n          { \"label\": \"Run Resumption\", \"to\": \"/features/run-resumption\" },\n          { \"label\": \"Parallel Execution\", \"to\": \"/features/parallel-execution\" }\n        ]\n      },\n      {\n        \"type\": \"dropdown\",\n        \"label\": \"Harnesses\",\n        \"position\": \"left\",\n        \"items\": [\n          { \"label\": \"Install Matrix\", \"to\": \"/harnesses/install-matrix\" },\n          { \"label\": \"Claude Code\", \"to\": \"/harnesses/claude-code\" },\n          { \"label\": \"Codex\", \"to\": \"/harnesses/codex\" }\n        ]\n      },\n      {\n        \"type\": \"dropdown\",\n        \"label\": \"Reference\",\n        \"position\": \"left\",\n        \"items\": [\n          { \"label\": \"Reference Overview\", \"to\": \"/reference/\" },\n          { \"label\": \"Adapter Types (all 20)\", \"to\": \"/reference/adapter-types\" },\n          { \"label\": \"Slash Commands\", \"to\": \"/reference/slash-commands\" },\n          { \"label\": \"CLI Reference\", \"to\": \"/reference/cli-reference\" },\n          { \"label\": \"Adapters CLI\", \"to\": \"/reference/adapters-cli\" },\n          { \"label\": \"Configuration\", \"to\": \"/reference/configuration\" },\n          { \"label\": \"Security\", \"to\": \"/reference/security\" },\n          { \"label\": \"Error Catalog\", \"to\": \"/reference/error-catalog\" },\n          { \"label\": \"Glossary\", \"to\": \"/reference/glossary\" },\n          { \"label\": \"FAQ\", \"to\": \"/reference/faq\" },\n          { \"label\": \"Troubleshooting\", \"to\": \"/reference/troubleshooting\" }\n        ]\n      },\n      {\n        \"type\": \"search\",\n        \"position\": \"right\"\n      }\n    ]\n  },\n  \"sidebar\": {\n    \"docs\": [\n      {\n        \"type\": \"doc\",\n        \"id\": \"index\",\n        \"label\": \"Home\"\n      },\n      {\n        \"type\": \"category\",\n        \"label\": \"Getting Started\",\n        \"collapsed\": false,\n        \"items\": [\n          \"getting-started/README\",\n          \"getting-started/installation\",\n          \"getting-started/quickstart\",\n          \"getting-started/first-run\",\n          \"getting-started/migration\",\n          \"getting-started/upgrade-to-v6\"\n        ]\n      },\n      {\n        \"type\": \"category\",\n        \"label\": \"Ecosystem\",\n        \"collapsed\": false,\n        \"items\": [\n          \"ecosystem/overview\",\n          \"ecosystem/babysitter-sdk\",\n          \"ecosystem/adapters\",\n          \"ecosystem/atlas\",\n          \"ecosystem/genty\",\n          \"ecosystem/observer-dashboard\",\n          \"ecosystem/kradle\",\n          \"ecosystem/kip-sdk\"\n        ]\n      },\n      {\n        \"type\": \"doc\",\n        \"id\": \"architecture\",\n        \"label\": \"Architecture\"\n      },\n      {\n        \"type\": \"category\",\n        \"label\": \"Tutorials\",\n        \"collapsed\": false,\n        \"link\": { \"type\": \"doc\", \"id\": \"tutorials/index\" },\n        \"items\": [\n          \"tutorials/beginner-rest-api\",\n          \"tutorials/intermediate-custom-process\",\n          \"tutorials/advanced-multi-phase\"\n        ]\n      },\n      {\n        \"type\": \"category\",\n        \"label\": \"Features\",\n        \"collapsed\": false,\n        \"link\": { \"type\": \"doc\", \"id\": \"features/index\" },\n        \"items\": [\n          \"features/architecture-overview\",\n          \"features/two-loops-architecture\",\n          \"features/adapters\",\n          \"features/process-library\",\n          \"features/process-definitions\",\n          \"features/quality-convergence\",\n          \"features/best-practices\",\n          \"features/breakpoints\",\n          \"features/hooks\",\n          \"features/journal-system\",\n          \"features/run-resumption\",\n          \"features/parallel-execution\"\n        ]\n      },\n      {\n        \"type\": \"category\",\n        \"label\": \"Harnesses\",\n        \"collapsed\": false,\n        \"items\": [\n          \"harnesses/install-matrix\",\n          \"harnesses/claude-code\",\n          \"harnesses/codex\"\n        ]\n      },\n      {\n        \"type\": \"category\",\n        \"label\": \"Reference\",\n        \"collapsed\": false,\n        \"link\": { \"type\": \"doc\", \"id\": \"reference/index\" },\n        \"items\": [\n          \"reference/adapter-types\",\n          \"reference/slash-commands\",\n          \"reference/cli-reference\",\n          \"reference/adapters-cli\",\n          \"reference/configuration\",\n          \"reference/security\",\n          \"reference/error-catalog\",\n          \"reference/glossary\",\n          \"reference/faq\",\n          \"reference/troubleshooting\"\n        ]\n      }\n    ]\n  }\n}\n```\n\n---\n\n## Mobile Navigation\n\n```\n+---------------------------+\n| [Hamburger] Babysitter    |\n+---------------------------+\n| [Search icon]             |\n+---------------------------+\n\n[Hamburger expanded:]\n+---------------------------+\n| Home                      |\n| Getting Started      [>]  |\n| Ecosystem            [>]  |\n| Architecture              |\n| Tutorials            [>]  |\n| Features             [>]  |\n| Harnesses            [>]  |\n| Reference            [>]  |\n+---------------------------+\n| Quick Links               |\n| - Installation            |\n| - Ecosystem Overview      |\n| - Architecture            |\n| - CLI Reference           |\n| - Glossary                |\n+---------------------------+\n```\n\n---\n\n## Footer Navigation\n\n```\n+-------------------------------------------------------------------------+\n| Getting Started   | Ecosystem      | Features          | Reference      |\n| - Installation    | - Overview     | - Two-Loops       | - CLI          |\n| - Quickstart      | - Adapters     | - Adapters        | - Adapter Types|\n| - First Run       | - genty        | - Quality Conv.   | - Config       |\n| - Architecture    | - kradle       | - Breakpoints     | - Glossary     |\n+-------------------------------------------------------------------------+\n| Resources                                                                |\n| GitHub | Issues | Discussions | Releases | Support                      |\n+-------------------------------------------------------------------------+\n```\n\n---\n\n## Breadcrumb Configuration\n\nEvery content page opens with a compact breadcrumb of the form `Docs › Section › Page`, rendered as Markdown links so it works on GitBook, Docusaurus, and plain GitHub. Examples:\n\n| Page | Breadcrumb Path |\n|------|-----------------|\n| Home | `Docs` |\n| Ecosystem Overview | `Docs › Ecosystem › Overview` |\n| babysitter-sdk | `Docs › Ecosystem › babysitter-sdk` |\n| Architecture | `Docs › Architecture` |\n| Adapter Types | `Docs › Reference › Adapter Types` |\n| Installation | `Docs › Getting Started › Installation` |\n| Two-Loops Architecture | `Docs › Features › Two-Loops Architecture` |\n| Process Library | `Docs › Features › Process Library` |\n| Best Practices Guide | `Docs › Features › Best Practices Guide` |\n| Breakpoints | `Docs › Features › Breakpoints` |\n| Hooks | `Docs › Features › Hooks` |\n| REST API Tutorial | `Docs › Tutorials › Build a REST API` |\n| Install Matrix | `Docs › Harnesses › Install Matrix` |\n| CLI Reference | `Docs › Reference › CLI Reference` |\n| Security | `Docs › Reference › Security` |\n| Glossary | `Docs › Reference › Glossary` |\n\n---\n\n## Quick Access Links\n\n### Pinned Pages\n\n1. [Installation](./getting-started/installation.md) - Get started quickly\n2. [CLI Reference](./reference/cli-reference.md) - Command lookup\n3. [Troubleshooting](./reference/troubleshooting.md) - Fix common issues\n4. [Glossary](./reference/glossary.md) - Understand terminology\n\n### Most Visited (Analytics-Based)\n\nConfigure based on actual usage data:\n- Getting Started\n- First Run\n- Breakpoints\n- CLI Reference\n\n---\n\n## Search Configuration\n\n```json\n{\n  \"search\": {\n    \"provider\": \"algolia\",\n    \"options\": {\n      \"indexName\": \"babysitter-docs\",\n      \"facetFilters\": [\n        \"category:tutorials\",\n        \"category:features\",\n        \"category:reference\",\n        \"level:beginner\",\n        \"level:intermediate\",\n        \"level:advanced\"\n      ],\n      \"searchParameters\": {\n        \"hitsPerPage\": 10,\n        \"attributesToSnippet\": [\"content:50\"],\n        \"snippetEllipsisText\": \"...\"\n      }\n    },\n    \"placeholders\": {\n      \"default\": \"Search documentation...\",\n      \"mobile\": \"Search...\"\n    },\n    \"shortcuts\": {\n      \"open\": [\"ctrl+k\", \"cmd+k\"],\n      \"close\": [\"esc\"]\n    }\n  }\n}\n```\n\n---\n\n## Versioning\n\nThe user guide currently tracks the current release only:\n\n```json\n{\n  \"versions\": {\n    \"current\": {\n      \"label\": \"v6 (6.0.0)\",\n      \"path\": \"/docs/\"\n    }\n  }\n}\n```\n\n---\n\n*Last updated: 2026-06-23*\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-user-guide",
      "to": "page:docs-user-guide-navigation",
      "kind": "contains_page"
    }
  ]
}