What problem does it solve? Codebases accumulate shallow modules whose interfaces are nearly as complex as their implementations, making code hard to test and navigate. This Skill finds those architecture friction points and presents concrete refactoring candidates instead of vague advice. ## Core Features & Use Cases - Hotspot-guided exploration: Uses git history to find frequently changed areas, then applies the deletion test to identify shallow modules, leaking seams, and missing locality. - Visual HTML report: Renders each candidate as a card with before/after diagrams (Mermaid plus hand-built SVG), recommendation strength badges, and ADR conflict warnings, written to the OS temp directory. - Follow-up decision loop: After you pick a candidate, it drives a grilling-style conversation about constraints, seams, and tests, updating CONTEXT.md and offering ADRs along the way. - Use Case: Run it on a service that has grown messy over months of feature work; it opens an HTML report showing, for example, that your order intake pipeline is six shallow layers that should be merged into one deep module. ## Quick Start Ask the agent to review this repository's architecture and show deepening opportunities in an HTML report.
