Codemap

Core Position

Create CodeMaps for agents, not CodeWiki for humans.

CodeMap saves context attention, not necessarily raw token count. It does not replace source code, tests, logs, or the current Spec. It routes the agent toward the right source-linked evidence, in the right order, with progressive disclosure.

Use a CodeMap as:

• Project CodeMap: breadth-first project terrain, capability index, module boundaries, dependency index, and drill-down pointers.
• Feature CodeMap: depth-first capability terrain from entry to effect, including branches, dependencies, risks, and validation entry points.

Workflow

1. Restate the requested scope and choose mode:
   • feature: capability, business feature, bug chain, API flow, function/class-centered investigation.
   • project: repository, service, package, subsystem, or first-time onboarding map.
2. Read references/principles.md when the output shape, boundary, or CodeWiki-vs-CodeMap distinction matters.