improve-codebase-architecture

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, presented visually rather than as a wall of prose. ## Core Features & Use Cases - Architecture exploration: Uses an Explore sub-agent plus git history hot-spot analysis to find shallow modules, seam leakage, and poor locality, applying the deletion test to validate candidates. - Visual HTML report: Writes a self-contained Tailwind + Mermaid HTML report to the OS temp directory with before/after diagrams, recommendation-strength badges, and ADR conflict callouts. - Decision grilling loop: After the user picks a candidate, runs a grilling workflow that updates CONTEXT.md, offers ADRs for rejected candidates, and supports design-it-twice interface exploration. - Use Case: Point it at a subsystem that keeps changing, review the rendered report of deepening candidates, pick one, and walk the decision tree until the refactor shape is settled. ## Quick Start Ask the assistant to review the architecture of the current codebase and show deepening opportunities as an HTML report.