docs: reorganize site to v2-only navigation

novatechflow · novatechflow · commit 9777f670d6ac · 2026-02-18T10:46:34.000+01:00
diff --git a/docs/architecture.html b/docs/architecture.html
@@ -1,6 +1,7 @@
 ---
 layout: default
 title: KafClaw Architecture
+nav_exclude: true
 ---
 
 <style>
diff --git a/docs/concepts/how-agents-work.md b/docs/concepts/how-agents-work.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # How Agents Work
 
 This page describes the live runtime path from message input to response output.
diff --git a/docs/concepts/runtime-tools.md b/docs/concepts/runtime-tools.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # Runtime Tools and Capabilities
 
 This is the runtime-accurate tool view for current Go agent loop behavior.
diff --git a/docs/concepts/soul-identity-tools.md b/docs/concepts/soul-identity-tools.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # Soul and Identity Files
 
 KafClaw agents are shaped by a workspace-level file set scaffolded during onboarding.
diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # Getting Started
 
 This guide gets KafClaw from zero to a working setup, with focus on onboarding and workspace identity files.
diff --git a/docs/index.md b/docs/index.md
@@ -1,84 +1,34 @@
-# KafClaw Documentation
+---
+title: Home
+nav_order: 1
+---
 
-<p align="center">
-  <img src="./assets/kafclaw.png" alt="KafClaw Logo" width="320" />
-</p>
+# KafClaw Documentation (v2)
 
-KafClaw is a Go-based agent runtime with three practical deployment modes:
-
-- `local`: personal assistant on one machine
-- `local-kafka`: local runtime connected to Kafka/group orchestration
-- `remote`: headless gateway reachable over network (token required)
-
-## Ecosystem
-
-- **KafScale** ([github.com/kafscale](https://github.com/kafscale), [kafscale.io](https://kafscale.io)): Kafka-compatible and S3-compatible data plane used for durable event transport and large artifact flows in agent systems.
-- **GitClaw** (in this KafClaw repository): agentic, self-hosted GitHub replacement focused on autonomous repository workflows and automation.
-- **KafClaw**: runtime and coordination layer for local, Kafka-connected, and remote/headless agents.
-
-## Why KafClaw
-
-KafClaw gives teams an enterprise-ready way to run and coordinate autonomous agents over Apache Kafka.
-Instead of locking agents to one model, one language, or one SDK, it uses a typed Kafka message protocol so any runtime that can read and write JSON envelopes can participate.
-
-What this enables in practice:
-
-- Reliable multi-agent collaboration with correlation IDs, timestamps, and trace-friendly envelopes
-- Group and hierarchy orchestration with role boundaries and scoped visibility
-- Shared memory and skill routing so agents can reuse knowledge across sessions
-- Flexible deployment from a single local assistant to a Kafka-connected production gateway
-
-In short: Kafka is the backbone, and KafClaw is the coordination layer that keeps heterogeneous agents working together safely and observably.
+This documentation site is organized around the **v2** reference set.
 
 ## Start Here
 
-- [Getting Started](./getting-started.md) - install, onboard, first run
-- [Manage KafClaw](./manage-kafclaw.md) - operator runbook for CLI, health checks, group and bridge operations
-- [Operations and Maintenance](./maintenance.md) - runbook for updates, checks, backups, troubleshooting
-- [Architecture Visual (HTML)](./architecture.html) - system overview diagram and component map
-
-## Agent Concepts
-
-- [How Agents Work](./concepts/how-agents-work.md) - end-to-end runtime flow from inbound message to outbound response
-- [Soul and Identity Files](./concepts/soul-identity-tools.md) - what `AGENTS.md`, `SOUL.md`, `USER.md`, `TOOLS.md`, `IDENTITY.md` do
-- [Runtime Tools and Capabilities](./concepts/runtime-tools.md) - actual tools registered by the Go runtime
-
-## Integrations
-
-- [Slack and Teams Bridge](./v2/slack-teams-bridge.md)
-- [WhatsApp Setup](./v2/whatsapp-setup.md)
-- [WhatsApp Onboarding](./v2/whatsapp-onboarding.md)
-
-## Operations and Admin
-
+- [v2 Docs Index](./v2/index.md)
+- [User Manual](./v2/user-manual.md)
 - [Admin Guide](./v2/admin-guide.md)
 - [Operations Guide](./v2/operations-guide.md)
-- [Docker Deployment](./v2/docker-deployment.md)
-- [Release Guide](./v2/release.md)
 
-## Architecture and Security
+## Architecture
 
 - [Architecture Overview](./v2/architecture.md)
 - [Detailed Architecture](./v2/architecture-detailed.md)
 - [Timeline Architecture](./v2/architecture-timeline.md)
-- [Security Risks](./v2/security-risks.md)
-- [Subagents Threat Model](./v2/subagents-threat-model.md)
-
-## Full v2 Reference Set
-
-- [v2 Index](./v2/index.md)
-- [User Manual](./v2/user-manual.md)
 
-## Security Baseline
+## Security and Risk
 
-- Default bind is loopback: `127.0.0.1`
-- Remote/headless mode should use auth token for dashboard API
-- When `gateway.authToken` is set, both dashboard API and `POST /chat` require bearer auth (dashboard keeps `/api/v1/status` open for health checks)
-- Use `kafclaw doctor` for diagnostics
-- Use `kafclaw doctor --fix` for env merge and permissions hygiene
+- [Security Risks](./v2/security-risks.md)
+- [Subagents Threat Model](./v2/subagents-threat-model.md)
 
-## Repository Docs Areas
+## Integrations and Deployment
 
-- `docs/concepts/` - runtime behavior and core mental models
-- `docs/v2/` - full product and operations reference set
-- `docs/security/` - security audits and roadmap
+- [Slack and Teams Bridge](./v2/slack-teams-bridge.md)
+- [WhatsApp Setup](./v2/whatsapp-setup.md)
+- [WhatsApp Onboarding](./v2/whatsapp-onboarding.md)
+- [Docker Deployment](./v2/docker-deployment.md)
+- [Release Guide](./v2/release.md)
diff --git a/docs/maintenance.md b/docs/maintenance.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # Operations and Maintenance
 
 Operational runbook for keeping KafClaw healthy in dev and production-like setups.
diff --git a/docs/manage-kafclaw.md b/docs/manage-kafclaw.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # KafClaw Management Guide
 
 Operator-focused guide for managing KafClaw from CLI and runtime endpoints.
diff --git a/docs/security/sec-002-owasp-audit/auth-token-concept.md b/docs/security/sec-002-owasp-audit/auth-token-concept.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # Authentication and Authorization via Tokens - KafClaw
 
 **Date:** 2026-02-16
diff --git a/docs/security/sec-002-owasp-audit/bot-identity-proposal.md b/docs/security/sec-002-owasp-audit/bot-identity-proposal.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # Bot Identity Proposal - KafClaw
 
 **Date:** 2026-02-16
diff --git a/docs/security/sec-002-owasp-audit/electron-audit.md b/docs/security/sec-002-owasp-audit/electron-audit.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # Electron App Security Audit - KafClaw
 
 **Date:** 2026-02-16
diff --git a/docs/security/sec-002-owasp-audit/owasp-audit.md b/docs/security/sec-002-owasp-audit/owasp-audit.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # OWASP Security Audit - KafClaw
 
 **Date:** 2026-02-16
diff --git a/docs/security/sec-002-owasp-audit/readme.md b/docs/security/sec-002-owasp-audit/readme.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # KafClaw Security Documentation
 
 **Created:** 2026-02-16
diff --git a/docs/security/security-roadmap.md b/docs/security/security-roadmap.md
@@ -1,3 +1,7 @@
+---
+nav_exclude: true
+---
+
 # KafClaw Security Roadmap
 
 > Date: 2026-02-16 | Status: Active | Owner: Core Team
diff --git a/docs/v2/admin-guide.md b/docs/v2/admin-guide.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # KafClaw Administration Guide
 
 Comprehensive reference for deploying, configuring, securing, and operating KafClaw.
diff --git a/docs/v2/architecture-detailed.md b/docs/v2/architecture-detailed.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # KafClaw System Architecture — Detailed Reference
 
 > For the quick overview, see [architecture.md](./architecture.md).
diff --git a/docs/v2/architecture-timeline.md b/docs/v2/architecture-timeline.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # Architecture: Timeline and Memory
 
 > See also: [FR-019 Memory Architecture](../requirements/FR-019-memory-architecture.md), [FR-020 Memory Research Insights](../requirements/FR-020-memory-research-insights.md)
diff --git a/docs/v2/architecture.md b/docs/v2/architecture.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # KafClaw Architecture — Overview
 
 A quick reference for the KafClaw system architecture. For the comprehensive deep-dive, see [architecture-detailed.md](./architecture-detailed.md).
diff --git a/docs/v2/docker-deployment.md b/docs/v2/docker-deployment.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # Docker Compose Deployment
 
 > See also: [FR-024 Standalone Mode](../requirements/FR-024-standalone-mode.md) for deployment mode details
diff --git a/docs/v2/index.md b/docs/v2/index.md
@@ -1,17 +1,13 @@
+---
+title: v2 Docs
+nav_order: 2
+has_children: true
+---
+
 # KafClaw Documentation (v2)
 
 Primary v2 reference set for KafClaw.
 
-## Quick Links
-
-- [Docs Home](../index.md)
-- [Getting Started](../getting-started.md)
-- [Manage KafClaw](../manage-kafclaw.md)
-- [Operations and Maintenance](../maintenance.md)
-- [How Agents Work](../concepts/how-agents-work.md)
-- [Soul and Identity Files](../concepts/soul-identity-tools.md)
-- [Runtime Tools and Capabilities](../concepts/runtime-tools.md)
-
 ## Guides
 
 | Guide | Description |
@@ -36,4 +32,3 @@ Primary v2 reference set for KafClaw.
 ## Scope
 
 - `docs/v2/` is the current documentation set.
-- `docs/security/` keeps security audits and roadmap notes.
diff --git a/docs/v2/memory-notes.md b/docs/v2/memory-notes.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # Memory Notes
 
 Personal context notes for the KafClaw agent.
diff --git a/docs/v2/operations-guide.md b/docs/v2/operations-guide.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # KafClaw Operations Guide
 
 Build, deploy, monitor, and operate KafClaw.
diff --git a/docs/v2/release.md b/docs/v2/release.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # Release Process
 
 > See also: [FR-017 Build/Test Strategy](../requirements/FR-017-build-test-strategy.md)
diff --git a/docs/v2/security-risks.md b/docs/v2/security-risks.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # KafClaw Security Risks
 
 Giving an AI agent access to your shell and filesystem is powerful but carries inherent risks. KafClaw is designed with a "secure by default" philosophy, but you must be aware of potential vulnerabilities.
diff --git a/docs/v2/slack-teams-bridge.md b/docs/v2/slack-teams-bridge.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # Slack + Teams Bridge
 
 This bridge provides pairing and message flow for Slack and Microsoft Teams with KafClaw.
diff --git a/docs/v2/subagents-threat-model.md b/docs/v2/subagents-threat-model.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # Subagents Threat Model
 
 ## Scope
diff --git a/docs/v2/user-manual.md b/docs/v2/user-manual.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # KafClaw User Manual
 
 A comprehensive guide to installing, configuring, and using KafClaw — a personal AI assistant framework written in Go with an Electron desktop frontend.
diff --git a/docs/v2/whatsapp-onboarding.md b/docs/v2/whatsapp-onboarding.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # WhatsApp Onboarding — Buddy Access
 
 End-to-end guide for connecting a buddy to your KafClaw instance via WhatsApp.
diff --git a/docs/v2/whatsapp-setup.md b/docs/v2/whatsapp-setup.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # WhatsApp Setup (Default Deny)
 
 > See also: [FR-001 WhatsApp Auth Flow](../requirements/FR-001-whatsapp-auth-flow.md)
diff --git a/docs/v2/workshop-setup.md b/docs/v2/workshop-setup.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # Workshop Setup — 4-Agent Group Deployment
 
 Deploy a KafClaw Workshop: 1 desktop Electron agent (Mac) + 3 headless Docker agents sharing one gateway and one KafScale bus.
diff --git a/docs/v2/workspace-policy.md b/docs/v2/workspace-policy.md
@@ -1,3 +1,7 @@
+---
+parent: v2 Docs
+---
+
 # Workspace Policy
 
 > See also: [FR-025 Workspace Policy](../requirements/FR-025-workspace-policy.md)
