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 vague cleanup advice. ## Core Features & Use Cases - Architecture exploration: Walks the codebase (optionally via a sub-agent), weights recently changed hot spots from git history, and applies the deletion test to find shallow modules, leaky seams, and poor locality. - Visual HTML report: Renders each candidate refactor as a self-contained HTML file in the OS temp directory with Tailwind and Mermaid diagrams, before/after visualizations, recommendation-strength badges, and ADR conflict callouts. - Grilling loop: After the user picks a candidate, drives a decision-tree conversation about constraints, dependencies, and the deepened module's shape, keeping CONTEXT.md and ADRs current. - Use Case: Point it at a service whose handlers, validators, and repositories have multiplied into thin wrappers; it produces a report showing how to collapse them into one deep module with a single testable interface. ## Quick Start Ask the assistant to review this repository for architecture improvements and show the deepening candidates as an HTML report.
