## What problem does it solve?
Code-mapping provides hierarchical, cross-referenced documentation that helps AI agents and humans orient to a codebase, reducing search time and context-switch costs during tasks like onboarding, code reviews, and architecture validation.
## Core Features & Use Cases
- Hierarchical maps up to L3 (source code) with anchors for grep navigation.
- Validate links, anchors, and code references to ensure map fidelity during evolution.
- Use for onboarding, knowledge transfer, and engineering tasks requiring quick codebase orientation.
### Quick Start
- Generate maps from a Python codebase: uv run python $SKILL_PATH/scripts/code_map.py generate <src-dir> <map-dir>
- Validate an existing map: uv run python $SKILL_PATH/scripts/code_map.py validate <map-dir>
- Read and navigate the map under docs/map to locate anchors and code references.