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 that architectural friction and proposes concrete deepening refactors grounded in a shared design vocabulary. ## Core Features & Use Cases - Hot-spot-driven exploration: Scopes the scan using commit history or a user-named direction, then applies the deletion test to find shallow modules, seam leakage, and poor locality. - Visual HTML report: Renders each candidate as a self-contained HTML file (Tailwind and Mermaid via CDN) with 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, keeps CONTEXT.md and ADRs current, and can run design-it-twice exploration via /codebase-design. - Use Case: Point it at a subsystem where pricing logic leaks across modules; it produces a report showing the shallow call chain and a deepened alternative with one interface and one place to test. ## Quick Start Ask the assistant to run the improve-codebase-architecture skill on the order intake subsystem and show the deepening candidates.
