codebase-mapper

"Create accurate technical documentation by analyzing the codebase first -- API docs, architecture guides, component docs, or full project documentation" argument-hint: "<target path or description> [--api-only] [--architecture] [--format markdown|html] [--output <path>]". TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

"Audit and improve existing project documentation with ground truth verification and guided improvements". TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

"Rewrite existing documentation to be human-readable - removes AI-style density, applies progressive disclosure, improves scannability" argument-hint: "<path-to-docs>". TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

"Generate a human-readable codebase guide - explores the project, writes 10 narrative documents with Mermaid diagrams, and produces an INDEX.md entry point" argument-hint: "[target-path]". TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Phase 1 of codebase-mapper. Explores an unfamiliar project to build a context brief that writer agents will use to produce human-readable documentation. Reads README, configs, package manifests, entry points, and directory structure. Writes context-brief.md to .codebase-map/_internal/. Spawned by the map-codebase command. TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Phase 2 writer for codebase-mapper. Produces 10-configuration-guide.md from the context brief. Documents how to configure and use the project in practice - environment setup, configuration scenarios, common operations, and troubleshooting. Spawned in parallel with other writer agents. TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Rewrites existing documentation to follow human-centered writing guidelines. Takes dense, AI-style, or poorly structured docs and transforms them into clear, scannable, narrative documentation. TRIGGER WHEN: documentation exists but reads like a wall of text or AI output. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Expert documentation engineer for creating and maintaining accurate technical documentation. Bottom-up analysis ensures docs reflect actual code behavior. TRIGGER WHEN: documenting APIs, restructuring existing docs, creating tutorials, or auditing documentation accuracy DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Phase 2 writer for codebase-mapper. Produces 05-workflows.md and 06-data-model.md from the context brief. Documents user/system workflows with flowcharts and sequence diagrams, and data structures with ER diagrams. Spawned in parallel with other writer agents. TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Phase 3 of codebase-mapper. Reviews all 8 generated documents for consistency, adds cross-references, uniformizes tone, and produces INDEX.md. Flags gaps and contradictions. Spawned by the map-codebase command after all writer agents complete. TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Phase 2 writer for codebase-mapper. Produces 07-getting-started.md and 08-open-questions.md from the context brief. Documents developer onboarding steps and flags knowledge gaps. Spawned in parallel with other writer agents. TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Phase 2 writer for codebase-mapper. Produces 09-project-anatomy.md from the context brief. Documents configuration files, environment variables, startup scripts, directory tree with folder meanings, and everything needed for hands-on work. Spawned in parallel with other writer agents. TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Phase 2 writer for codebase-mapper. Produces 01-overview.md and 02-features.md from the context brief. Writes narrative project overview with mindmap diagram and detailed feature catalog. Spawned in parallel with other writer agents. TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Phase 2 writer for codebase-mapper. Produces 03-tech-stack.md and 04-architecture.md from the context brief. Documents technologies, dependencies, code organization, and architectural layers with component diagrams. Spawned in parallel with other writer agents. TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Knowledge base for the codebase-mapper plugin. Provides writing guidelines, tone rules, and diagram conventions for generating human-readable project guides. Referenced by all codebase-mapper agents during document generation. TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.