databayt · abdout · May 18, 2026
diff --git a/content/docs/agents.mdx → content/docs/engine/agents/index.mdx b/content/docs/agents.mdx → content/docs/engine/agents/index.mdx
@@ -3,7 +3,6 @@ title: Agents
 description: 40 agents across 4 tiers — from captain to specialists
 ---
 
-# Agents
 
 40 specialized agents organized in a 4-tier hierarchy. The top 9 leadership agents manage business, product, and technical strategy. The bottom 31 specialist agents handle execution across stack, design, UI, DevOps, VCS, and domain expertise.
 

diff --git a/content/docs/engine/agents/meta.json b/content/docs/engine/agents/meta.json
@@ -0,0 +1,4 @@
+{
+  "title": "Agents",
+  "pages": ["index"]
+}
diff --git a/content/docs/claude-md.mdx → content/docs/engine/claude-md.mdx b/content/docs/claude-md.mdx → content/docs/engine/claude-md.mdx
@@ -3,7 +3,6 @@ title: CLAUDE.md
 description: Project instructions that shape every response — the 3-layer hierarchy
 ---
 
-# CLAUDE.md
 
 The most powerful configuration primitive in Claude Code. A markdown file that shapes every response, every agent, every workflow. Kun uses a 3-layer hierarchy that cascades from global preferences down to repo-specific operations.
 

diff --git a/content/docs/commands.mdx → content/docs/engine/commands.mdx b/content/docs/commands.mdx → content/docs/engine/commands.mdx
@@ -3,7 +3,6 @@ title: Commands
 description: Slash commands for rapid workflows
 ---
 
-# Commands
 
 Type `/command` in Claude Code to trigger a complete workflow. Commands are markdown templates in `~/.claude/commands/` that expand into full prompts with agent routing and MCP integration.
 

diff --git a/content/docs/hooks.mdx → content/docs/engine/hooks.mdx b/content/docs/hooks.mdx → content/docs/engine/hooks.mdx
@@ -3,7 +3,6 @@ title: Hooks
 description: Lifecycle automations that trigger on events
 ---
 
-# Hooks
 
 5 hooks that automate repetitive actions across the development lifecycle. They fire on specific events — before a tool runs, after a file changes, when a session ends.
 

diff --git a/content/docs/keywords.mdx → content/docs/engine/keywords.mdx b/content/docs/keywords.mdx → content/docs/engine/keywords.mdx
@@ -3,7 +3,6 @@ title: The Standard Book of Spells
 description: 114 incantations that bend code to your will — the complete Kun spellbook
 ---
 
-# The Standard Book of Spells
 
 > *"It does not do to dwell on documentation and forget to ship."*
 

diff --git a/content/docs/mcp.mdx → content/docs/engine/mcp.mdx b/content/docs/mcp.mdx → content/docs/engine/mcp.mdx
@@ -3,7 +3,6 @@ title: MCP
 description: 18 MCP servers connecting Claude Code to external services
 ---
 
-# MCP Servers
 
 18 Model Context Protocol servers that connect Claude Code to external services — from design tools to databases to deployment platforms.
 

diff --git a/content/docs/memory.mdx → content/docs/engine/memory.mdx b/content/docs/memory.mdx → content/docs/engine/memory.mdx
@@ -3,7 +3,6 @@ title: Memory
 description: Persistent files that carry context across sessions
 ---
 
-# Memory
 
 6 memory files that persist across conversations. They store component registries, team profiles, and project state — so Claude never forgets what was built, who's on the team, or what patterns exist.
 

diff --git a/content/docs/engine/meta.json b/content/docs/engine/meta.json
@@ -0,0 +1,14 @@
+{
+  "title": "Engine",
+  "pages": [
+    "claude-md",
+    "agents",
+    "skills",
+    "commands",
+    "mcp",
+    "hooks",
+    "rules",
+    "memory",
+    "keywords"
+  ]
+}
diff --git a/content/docs/rules.mdx → content/docs/engine/rules.mdx b/content/docs/rules.mdx → content/docs/engine/rules.mdx
@@ -3,7 +3,6 @@ title: Rules
 description: Path-scoped rules that activate on file touch
 ---
 
-# Rules
 
 8 rules that auto-activate when you touch specific file patterns. Each rule injects domain knowledge and constraints for its area — authentication, i18n, database, styling, testing, deployment.
 

diff --git a/content/docs/skills.mdx → content/docs/engine/skills.mdx b/content/docs/skills.mdx → content/docs/engine/skills.mdx
@@ -3,7 +3,6 @@ title: Skills
 description: 25 reusable skills with keyword triggers
 ---
 
-# Skills
 
 25 slash commands that trigger complete workflows. Say a keyword or type `/command` — the engine handles the rest.
 

diff --git a/content/docs/index.mdx b/content/docs/index.mdx
@@ -3,7 +3,6 @@ title: Introduction
 description: Kun (كن) — The Databayt Engine
 ---
 
-# Kun (كن)
 
 > The optimal configuration that makes Claude Code, Claude Desktop, Cowork, and the Agent SDK work together as a single engine running both the technical and business sides of **Databayt**.
 

diff --git a/content/docs/claude-code.mdx → content/docs/installation/claude-code.mdx b/content/docs/claude-code.mdx → content/docs/installation/claude-code.mdx
diff --git a/content/docs/onboarding.mdx → content/docs/installation/index.mdx b/content/docs/onboarding.mdx → content/docs/installation/index.mdx
@@ -3,7 +3,6 @@ title: Onboarding
 description: Install Cowork, let it do the rest
 ---
 
-# Onboarding
 
 > One install, one paste, one watch. Cowork drives every other step.
 
@@ -151,19 +150,19 @@ For hogwarts, your team contact shares the `.env` out-of-band (no `.env.example`
 | Open a GitHub issue | `c "/issue"` |
 | Verify a production deploy | `c "/watch"` |
 
-Full keyword list: [keywords](/docs/keywords).
+Full keyword list: [keywords](/docs/engine/keywords).
 
 ---
 
 ## Reference
 
 - [Computer use in Desktop](https://code.claude.com/docs/en/desktop#let-claude-use-your-computer)
-- [Claude Code — install detail](/docs/claude-code)
-- [Captain — decisions and delegation](/docs/captain)
-- [Cowork ↔ Code bridge](/docs/cowork)
-- [Connectors — MCP catalog](/docs/connectors)
+- [Claude Code — install detail](/docs/installation/claude-code)
+- [Captain — decisions and delegation](/docs/operations/captain)
+- [Cowork ↔ Code bridge](/docs/operations/cowork)
+- [Connectors — MCP catalog](/docs/operations/connectors)
 - [Anthropic Directory](https://claude.ai/directory)
-- [Keywords — full vocabulary](/docs/keywords)
-- [Team — roles](/docs/team)
-- [Repositories — full org map](/docs/repositories)
+- [Keywords — full vocabulary](/docs/engine/keywords)
+- [Team — roles](/docs/operations/team)
+- [Repositories — full org map](/docs/reference/repositories)
 - [Contributing — github-workflow rule](https://github.com/databayt/kun/blob/main/.claude/rules/github-workflow.md)
diff --git a/content/docs/installation/meta.json b/content/docs/installation/meta.json
@@ -0,0 +1,4 @@
+{
+  "title": "Installation",
+  "pages": ["index", "claude-code", "self-hosting"]
+}
diff --git a/content/docs/self-hosting.mdx → content/docs/installation/self-hosting.mdx b/content/docs/self-hosting.mdx → content/docs/installation/self-hosting.mdx
@@ -3,7 +3,6 @@ title: Self-Hosting
 description: Optional infrastructure for air-gapped or dedicated server deployments
 ---
 
-# Self-Hosting (Optional)
 
 > **Status**: Optional appendix. Anthropic-native products handle 90%+ of use cases.
 > **When relevant**: Air-gapped environments, data residency, or dedicated server preference.

diff --git a/content/docs/meta.json b/content/docs/meta.json
@@ -2,43 +2,15 @@
   "title": "Documentation",
   "pages": [
     "index",
+    "---Getting Started---",
+    "installation",
     "---Engine---",
-    "claude-md",
-    "agents",
-    "skills",
-    "commands",
-    "mcp",
-    "hooks",
-    "rules",
-    "memory",
+    "engine",
     "---Operations---",
-    "captain",
-    "team",
-    "onboarding",
-    "dispatch",
-    "context",
-    "cowork",
-    "voice",
-    "credentials",
-    "connectors",
-    "apps",
-    "issue",
+    "operations",
     "---Reference---",
-    "keywords",
-    "tips",
-    "tweets",
-    "configuration",
-    "architecture",
-    "workflows",
-    "products",
-    "prd",
-    "epics",
-    "claude-code",
-    "secrets",
-    "slack",
-    "stack",
-    "repositories",
-    "projects",
-    "self-hosting"
+    "reference",
+    "---Resources---",
+    "resources"
   ]
 }
diff --git a/content/docs/apps.mdx → content/docs/operations/apps.mdx b/content/docs/apps.mdx → content/docs/operations/apps.mdx
@@ -3,7 +3,6 @@ title: Apps
 description: Claude in Slack, Figma, and Asana
 ---
 
-# Claude Apps
 
 Anthropic's native integrations that bring Claude directly into the tools your team already uses.
 

diff --git a/content/docs/captain.mdx → content/docs/operations/captain.mdx b/content/docs/captain.mdx → content/docs/operations/captain.mdx
@@ -3,7 +3,6 @@ title: Captain
 description: CEO brain — delegates across 40 agents and 4 humans
 ---
 
-# Captain
 
 The apex agent. Captain is Databayt's CEO brain — it knows every product, every person, every dollar, every deadline. It makes the calls: what to build, who works on what, when to ship, when to cut scope.
 

diff --git a/content/docs/connectors.mdx → content/docs/operations/connectors.mdx b/content/docs/connectors.mdx → content/docs/operations/connectors.mdx
@@ -3,7 +3,6 @@ title: Connectors
 description: GitHub, Figma, Slack, Linear and service integrations
 ---
 
-# Connectors
 
 Service integrations that connect Kun to external platforms. Each connector is backed by an MCP server and triggered by keywords.
 

diff --git a/content/docs/context.mdx → content/docs/operations/context.mdx b/content/docs/context.mdx → content/docs/operations/context.mdx
@@ -3,7 +3,6 @@ title: Context
 description: Cloud tag control room — sprint-aware, contributor-aware keyword dispatch for all 4 team members
 ---
 
-# Context
 
 Cloud tag UI where any team member clicks a keyword and dispatches a workflow. The cloud adapts to who's viewing and what stories are active — keywords grow or shrink based on relevance.
 

diff --git a/content/docs/cowork.mdx → content/docs/operations/cowork.mdx b/content/docs/cowork.mdx → content/docs/operations/cowork.mdx
@@ -3,7 +3,6 @@ title: Cowork
 description: Same brain, two modes — one thinks, one acts
 ---
 
-# Cowork
 
 Cowork and Claude Code are two modes of the same brain. They share everything in `~/.claude/` — agents, memory, settings, rules. The difference is posture.
 

diff --git a/content/docs/credentials.mdx → content/docs/operations/credentials.mdx b/content/docs/credentials.mdx → content/docs/operations/credentials.mdx
@@ -3,7 +3,6 @@ title: Credentials
 description: Keychain-based API key management for 18 services
 ---
 
-# Credentials
 
 macOS Keychain-based credential management. API keys stored encrypted, retrieved via the `security` command, never in plain text files.
 

diff --git a/content/docs/dispatch.mdx → content/docs/operations/dispatch.mdx b/content/docs/dispatch.mdx → content/docs/operations/dispatch.mdx
@@ -3,7 +3,6 @@ title: Dispatch
 description: Apple Notes async communication — 3 channels for team coordination
 ---
 
-# Dispatch
 
 Async communication via Apple Notes. Three notes in a Dispatch folder, synced via iCloud to all Apple devices. Captain writes updates, Cowork bridges think/do, Abdout leaves instructions.
 

diff --git a/content/docs/issue.mdx → content/docs/operations/issue.mdx b/content/docs/issue.mdx → content/docs/operations/issue.mdx
@@ -3,7 +3,6 @@ title: Issue
 description: Issue pipeline — from user report to auto-fix, including Report an Issue dialog, report agent, and scheduled automation
 ---
 
-# Issue
 
 The issue pipeline connects user-reported bugs to automated fixes. Users click "Report an Issue" in the UI, a GitHub issue is created, and the report agent processes it.
 

diff --git a/content/docs/operations/meta.json b/content/docs/operations/meta.json
@@ -0,0 +1,15 @@
+{
+  "title": "Operations",
+  "pages": [
+    "captain",
+    "team",
+    "dispatch",
+    "context",
+    "cowork",
+    "voice",
+    "credentials",
+    "connectors",
+    "apps",
+    "issue"
+  ]
+}
diff --git a/content/docs/team.mdx → content/docs/operations/team.mdx b/content/docs/team.mdx → content/docs/operations/team.mdx
@@ -3,7 +3,6 @@ title: Team
 description: 4 roles with tailored MCP configs and agent indexes
 ---
 
-# Team
 
 4 humans with tailored tools. Each role gets a specific MCP config, skill set, and agent index — so everyone has exactly the tools they need, nothing more.
 

diff --git a/content/docs/voice.mdx → content/docs/operations/voice.mdx b/content/docs/voice.mdx → content/docs/operations/voice.mdx
@@ -3,7 +3,6 @@ title: Voice
 description: Speak commands instead of typing them
 ---
 
-# Voice
 
 Voice input across all Anthropic surfaces — Claude Desktop, iOS, and system-level dictation. Say what you want, Claude does it.
 

diff --git a/content/docs/architecture.mdx → content/docs/reference/architecture.mdx b/content/docs/architecture.mdx → content/docs/reference/architecture.mdx
@@ -3,7 +3,6 @@ title: Architecture
 description: 5-layer Anthropic-native engine architecture for Databayt
 ---
 
-# Architecture
 
 Kun is a **configuration engine** — not a server. It sits as the configuration layer on top of Anthropic's product suite, running both technical and business sides of **Databayt**.
 

diff --git a/content/docs/configuration.mdx → content/docs/reference/configuration.mdx b/content/docs/configuration.mdx → content/docs/reference/configuration.mdx
@@ -3,7 +3,6 @@ title: Configuration
 description: The engine blueprint — every setting, agent, skill, hook, MCP, rule, and memory
 ---
 
-# Configuration Blueprint
 
 This IS the engine. Every setting, agent, skill, hook, MCP server, rule, and memory file that transforms Anthropic's products into Databayt's operating system.
 

diff --git a/content/docs/epics.mdx → content/docs/reference/epics.mdx b/content/docs/epics.mdx → content/docs/reference/epics.mdx
@@ -3,7 +3,6 @@ title: Epics
 description: 57 stories across 12 epics with sprint plan for April-June 2026
 ---
 
-# Epics & Stories
 
 57 stories across 12 epics, organized by phase. Sprints run April-June 2026.
 

diff --git a/content/docs/reference/meta.json b/content/docs/reference/meta.json
@@ -0,0 +1,16 @@
+{
+  "title": "Reference",
+  "pages": [
+    "configuration",
+    "architecture",
+    "workflows",
+    "products",
+    "prd",
+    "epics",
+    "repositories",
+    "projects",
+    "stack",
+    "slack",
+    "secrets"
+  ]
+}
diff --git a/content/docs/prd.mdx → content/docs/reference/prd.mdx b/content/docs/prd.mdx → content/docs/reference/prd.mdx
@@ -3,7 +3,6 @@ title: PRD
 description: Configuration requirements by phase for the Kun engine
 ---
 
-# Product Requirements
 
 Requirements for Kun — the configuration engine running Databayt's operations across a 4-person team, 14 repositories, and 5 products.
 

diff --git a/content/docs/products.mdx → content/docs/reference/products.mdx b/content/docs/products.mdx → content/docs/reference/products.mdx
@@ -3,7 +3,6 @@ title: Anthropic Products
 description: Complete product catalog mapped to Databayt's team and operations
 ---
 
-# Anthropic Product Catalog
 
 Every Anthropic product mapped to its role in Databayt's operations — who uses what and why.
 

diff --git a/content/docs/projects.mdx → content/docs/reference/projects.mdx b/content/docs/projects.mdx → content/docs/reference/projects.mdx
@@ -3,7 +3,6 @@ title: Projects
 description: Browse and clone open projects from the databayt organization
 ---
 
-# Open Projects
 
 All projects in the [databayt](https://github.com/databayt) organization are available for team development.
 

diff --git a/content/docs/repositories.mdx → content/docs/reference/repositories.mdx b/content/docs/repositories.mdx → content/docs/reference/repositories.mdx
diff --git a/content/docs/secrets.mdx → content/docs/reference/secrets.mdx b/content/docs/secrets.mdx → content/docs/reference/secrets.mdx
@@ -3,7 +3,6 @@ title: Secrets
 description: API keys, tokens, and environment setup for the Kun engine
 ---
 
-# Secrets & Environment
 
 Secrets needed for the Kun engine's MCP servers and Anthropic products.
 

diff --git a/content/docs/slack.mdx → content/docs/reference/slack.mdx b/content/docs/slack.mdx → content/docs/reference/slack.mdx
@@ -3,7 +3,6 @@ title: Slack
 description: Team communication setup — workspace, channels, MCP integration
 ---
 
-# Slack
 
 Team communication hub for Databayt. Connected to Claude Code via MCP for notifications, dispatch, and collaboration.
 

diff --git a/content/docs/stack.mdx → content/docs/reference/stack.mdx b/content/docs/stack.mdx → content/docs/reference/stack.mdx
@@ -3,7 +3,6 @@ title: Stack
 description: Unified technology stack across all Databayt repositories
 ---
 
-# Stack
 
 The unified technology stack across all 14 Databayt repositories.
 

diff --git a/content/docs/workflows.mdx → content/docs/reference/workflows.mdx b/content/docs/workflows.mdx → content/docs/reference/workflows.mdx
@@ -3,7 +3,6 @@ title: Workflows
 description: How keywords chain together — from morning start to production deploy
 ---
 
-# Workflows
 
 How keywords chain together into complete operations. Single words are charms. Sequences are rituals.
 

diff --git a/content/docs/resources/meta.json b/content/docs/resources/meta.json
@@ -0,0 +1,4 @@
+{
+  "title": "Resources",
+  "pages": ["tips", "tweets"]
+}
-Original file line number
+Diff line change
@@ Expand Up / @@ -3,7 +3,6 @@ title: Agents @@
     description: 40 agents across 4 tiers — from captain to specialists
     ---
-    # Agents
 specialized agents organized in a 4-tier hierarchy. The top 9 leadership agents manage business, product, and technical strategy. The bottom 31 specialist agents handle execution across stack, design, UI, DevOps, VCS, and domain expertise.
@@ Expand Down @@