Documenting Codebase

Create a structured docs/ directory as the system of record. A short AGENTS.md (or CLAUDE.md) serves as the map.

Workflow

Phase 1: Audit (Parallel Subagents)

Spawn 5 parallel subagents to audit the codebase. Each subagent analyzes a specific scope and returns a structured report.

1. Tech Stack — references/audit/tech-stack.md
2. Architecture — references/audit/architecture.md
3. Testing — references/audit/testing.md
4. API & Database — references/audit/api-database.md
5. DevOps — references/audit/devops.md

See references/audit/orchestration.md for how to spawn and synthesize.

Phase 2: Plan (Decision Tree)