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 grounded in a shared design vocabulary. ## Core Features & Use Cases - Hot-spot-driven exploration: Scopes the scan using git history and user direction, then explores the codebase for shallow modules, seam leakage, and poor testability. - Visual HTML report: Renders each candidate refactor as a self-contained HTML file with Tailwind and Mermaid before/after diagrams, recommendation-strength badges, and ADR conflict callouts. - Guided decision loop: After the user picks a candidate, runs a grilling workflow to walk constraints, dependencies, and the shape of the deepened module, with optional ADR recording. - Use Case: A team notices their order intake logic is scattered across six thin wrappers. Run this Skill to get a visual report of deepening candidates, pick one, and work through the refactor decision tree. ## Quick Start Ask the agent to review this codebase for architecture improvements and show the deepening candidates as an HTML report.
