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 commit history (git log) to focus on recently changed areas, then spawns a sub-agent to find shallow modules, seam leakage, and poor locality. - Visual HTML report: Renders candidates as a self-contained HTML file in the OS temp directory using Tailwind and Mermaid via CDN, with before/after diagrams, recommendation-strength badges, and ADR conflict callouts. - Grilling loop: After the user picks a candidate, runs a structured decision-tree conversation and keeps CONTEXT.md and ADRs current as decisions crystallize. - Use Case: Point it at a subsystem where tests keep breaking across many small wrappers; it identifies the shallow modules, shows a before/after diagram of collapsing them into one deep module, and walks you through the refactor decision. ## Quick Start Ask the agent to review this codebase's architecture and show me deepening opportunities as an HTML report.
