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 instead of leaving the analysis as vague intuition. ## Core Features & Use Cases - Hot-spot-driven exploration: Scopes the scan using git history and user direction, then applies the deletion test to identify shallow modules, seam leakage, and poor locality. - Visual HTML report: Renders each candidate refactor as a self-contained HTML file with Tailwind and Mermaid diagrams, before/after visualizations, recommendation-strength badges, and ADR conflict callouts. - Interactive grilling loop: After the user picks a candidate, walks the decision tree via the /grilling skill and keeps 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 report showing the call-graph collapse, then grill through the chosen deepening to define one deep module with a single testable interface. ## Quick Start Ask the agent to review this codebase for architecture improvements and show the deepening candidates as an HTML report.