Cartographer

Purpose

To create a living document (docs/CODEBASE_MAP.md ) that serves as the architectural "Source of Truth" for the project.

Workflow

Phase 1: Reconnaissance

• Tree Scan: Execute a file listing command (e.g., find . -maxdepth 2 -not -path '/.' ) to visualize the high-level structure.

• Config Check: Read package.json and tsconfig.json to identify the stack.

Phase 2: Iterative Analysis

Exclusion Protocol: You must strictly ignore:

• Folders in .gitignore (specifically node_modules/ , .next/ , dist/ , build/ ).

• Lock files (package-lock.json , yarn.lock ).

• Public assets (public/images/ ).

Loop: For each relevant major directory (e.g., app/ , lib/ , components/ ):

• Read the entry point files.

• Apply the Inspection Rubric (references/inspection-rubric.md ).

• Store findings in memory.

Phase 3: Synthesis

Create or Overwrite docs/CODEBASE_MAP.md using the strict template in references/map-template.md .

Critical Constraints

• Mermaid Diagrams: You MUST generate a Mermaid graph for the high-level architecture.

• No Fluff: Do not summarize code line-by-line. Focus on intent.

• Linkage: Every mention of a file in the map must be a clickable relative link.