What problem does it solve? Codebases accumulate shallow modules whose interfaces are nearly as complex as their implementations, making them hard to test and navigate. This Skill surfaces those architectural friction points and proposes concrete deepening refactors grounded in a shared design vocabulary. ## Core Features & Use Cases - Hot-spot-driven exploration: Scopes the review using git history and user direction, then explores the codebase for shallow modules, seam leakage, and poor locality. - Visual HTML report: Renders each candidate refactor as a self-contained HTML file with Tailwind and Mermaid before/after diagrams, recommendation-strength badges, and ADR conflict callouts, written to the OS temp directory. - Grilling loop: After the user picks a candidate, walks the decision tree via the /grilling skill, keeping CONTEXT.md and ADRs current through /domain-modeling. - Use Case: A team notices their order intake flow is spread across six thin wrappers. Run this Skill to get a visual report of deepening candidates, pick one, and grill through the design before writing any code. ## Quick Start Ask the agent to run the improve-codebase-architecture skill to review the current codebase and show architectural deepening candidates in an HTML report.
