What problem does it solve? When inheriting or revisiting an existing codebase, teams lack a structured, up-to-date picture of system boundaries, modules, public interfaces, and technical constraints. This Skill performs a read-only scan of the repository and produces a standardized inventory report without modifying any code. ## Core Features & Use Cases - Read-only codebase scanning: Detects language/framework, maps directory structure and module boundaries, extracts routes, handlers, ORM models, and configuration constraints. - Commit-hash caching: Skips redundant scans by comparing the stored commit hash and schema version against the current HEAD, with a --force flag for full rescans. - Multi-repo support: Inventories multiple code roots with label-prefixed modules and produces a cross-repository relationship section covering dependency direction and version coupling. - Use Case: Before planning a refactor or writing a project baseline, run the scan to get docs/codebase-insight.md listing 5 modules, 23 interfaces, and 8 data objects with their tech stack constraints. ## Quick Start Ask the AI to run a read-only inventory of the current repository and generate the codebase-insight report under the docs directory.
