What problem does it solve? Codebases accumulate shallow modules, leaky seams, and scattered logic that make testing and navigation painful. This Skill surfaces those architectural friction points and proposes concrete deepening refactors, so you can decide what to fix with evidence instead of gut feel. ## Core Features & Use Cases - Hot-spot-driven exploration: Scopes the scan using recent git history and user direction, then applies the deletion test to find shallow modules, leaked seams, and missing locality. - Visual HTML report: Generates a self-contained Tailwind + Mermaid report in the OS temp directory with before/after diagrams, recommendation-strength badges, and ADR conflict callouts for each candidate. - Guided decision loop: After you pick a candidate, it runs a grilling workflow to refine constraints and interfaces, updating CONTEXT.md and offering ADRs as decisions crystallize. - Use Case: Point it at a subsystem where bugs keep recurring; it identifies that the order intake pipeline is shallow, renders a before/after diagram showing the collapse into one deep module, and walks you through the refactor decision. ## Quick Start Ask the assistant to review this codebase for architecture improvements and show the candidates in an HTML report.
