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, so teams can decide what to fix before writing any code. ## Core Features & Use Cases - Architecture scan: Explores the codebase (weighted toward recently changed hot spots from git history) to find shallow modules, leaking seams, and poor locality, applying the deletion test to each candidate. - Visual HTML report: Renders each candidate as a self-contained HTML file in the OS temp directory with Tailwind and Mermaid via CDN, including before/after diagrams, recommendation-strength badges, and ADR-conflict callouts. - Grilling loop: After the user picks a candidate, runs the /grilling skill to walk the decision tree, updating CONTEXT.md and offering ADRs as decisions crystallize. - 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 grill through the design of the consolidated deep module. ## Quick Start Ask the agent to scan this repository for architecture improvements and show the candidates as an HTML report.
