Cartographer

Maps codebases of any size using parallel Sonnet subagents with 1M token context windows.

CRITICAL: Opus orchestrates, Sonnet reads. Never have Opus read codebase files directly. Always delegate file reading to Sonnet subagents - even for small codebases. Opus plans the work, spawns subagents, and synthesizes their reports.

Quick Start

1. Run the scanner script to get file tree with token counts
2. Analyze the scan output to plan subagent work assignments
3. Spawn Sonnet subagents in parallel to read and analyze file groups
4. Synthesize subagent reports into docs/CODEBASE_MAP.md
5. Update CLAUDE.md with summary pointing to the map

Workflow

Step 1: Check for Existing Map

First, check if docs/CODEBASE_MAP.md already exists: