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 presents concrete deepening refactors as a visual report, then walks you through the trade-offs of whichever one you pick. ## Core Features & Use Cases - Hot-spot-driven exploration: Scopes the scan using recent commit history (git log) or a user-named direction, then spawns a sub-agent to find shallow modules, seam leakage, and poor locality. - Visual HTML report: Writes a self-contained Tailwind + Mermaid HTML file to the OS temp directory with before/after diagrams, recommendation-strength badges, and ADR conflict callouts for each candidate. - Guided decision loop: After you pick a candidate, runs a grilling workflow to explore constraints and dependencies, updating CONTEXT.md and offering ADRs as decisions crystallize. - Use Case: Point it at a subsystem where bugs keep recurring; it identifies that the Order intake module is shallow, shows a before/after diagram collapsing six wrappers into one deep module, and grills you on the new interface shape. ## Quick Start Ask the assistant to run the improve-codebase-architecture flow on the part of the codebase that has changed most recently and open the resulting HTML report.
