What problem does it solve? Exploring a large repository repeatedly burns context because every session re-derives the same structural understanding from raw source files. This Skill maintains a hierarchy of per-directory codemap.md files so exploration-heavy tasks start from a written summary instead of re-scanning code. ## Core Features & Use Cases - Incremental regeneration: A shell script compares the current git state against a recorded baseline SHA and lists only the directories that changed, so rebuilds touch only stale maps. - Hierarchical maps: Each significant directory gets its own codemap.md describing its responsibility, key files, patterns, and connections, with a root codemap.md linking them all. - Fail-open staleness detection: On any git problem the script reports everything as stale, guaranteeing a safe full rebuild instead of silently skipping updates. - Use Case: Before refactoring a module in an unfamiliar monorepo, read the relevant codemap.md files to understand directory roles and wiring in under a minute, falling back to grep only for details the maps do not cover. ## Quick Start Ask the agent to build codemaps for this repository so future exploration tasks start from the generated directory summaries.
