Codebase Documentation

Generate clear, concise documentation for existing codebases. Docs serve both humans and AI agents as navigation aids — not prose novels.

Principles

• Code is the source of truth. Docs point to it, never duplicate it.
• Concise over comprehensive. Each doc earns its existence.
• Pointers over explanations. Link to files/functions, don't re-describe them.
• Mermaid diagrams for architecture, data flow, and sequences where they add clarity.
• One level of depth per document. AGENTS.md → topic docs → (code).

Document Hierarchy