What problem does it solve?
Mapping an unfamiliar or brownfield codebase is time-consuming and error-prone; this skill automates discovery to infer architecture, technology stack, conventions, and notable concerns so teams can onboard, plan, and prioritize work confidently.
Core Features & Use Cases
- Parallel dimension scanning: Runs four parallel analyzers to produce architecture.md, stack.md, conventions.md, and concerns.md for fast, focused insights.
- Synthesis for planning: Generates a single-page .planning/codebase/README.md that summarizes validated capabilities and links to detailed dimension files for programmatic consumption.
- Non-destructive auditing: Reads the repository only, documents issues and validated capabilities without modifying source code, and optionally commits the mapping artifacts.
- Use Cases: Taking over a client repo, adding new features to unfamiliar code, and running before project initialization to seed validated requirements.
Quick Start
Run the qualia-map skill in the project directory to produce a .planning/codebase README and four dimension files describing architecture, stack, conventions, and concerns.