| name | review-architecture |
| description | Find deep-module opportunities in a codebase. Use when the user wants to improve architecture, refactor, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable. |
Review Architecture
Surface architectural friction and propose deep-module opportunities — refactors that turn shallow modules into deep ones.
Load skill: code-design.
Load skill: deep-modules.
Process
1. Explore Codebase
- Read existing documentation.
- Explore the codebase using deep-module principles.
2. Present candidates
Present a numbered list of deep-module opportunities. For each candidate:
- Files — which files/modules are involved
- Problem — why the current architecture is causing friction
- Solution — plain English description of what would change
- Benefits — explained in terms of locality and leverage, and also in how tests would improve
Do NOT propose interfaces yet. Ask the user: "Which of these would you like to explore?"
3. Explore a candidate
Once the user picks a candidate, load and follow explore-design-space. Explore the selected deep-module opportunity as the plan or design under review.
