What problem does it solve? Codebases accumulate shallow modules whose interfaces are nearly as complex as their implementations, scattering logic across many small files and making the code hard to test and navigate. This Skill surfaces that architectural friction and proposes concrete deepening refactors grounded in the project's own domain language and ADRs. ## Core Features & Use Cases - Architecture exploration: Walks the codebase with CodeGraph tools to find shallow modules, leaking seams, and tightly-coupled clusters, applying the deletion test to each candidate. - HTML review report: Renders candidates as a self-contained HTML file with Tailwind and Mermaid before/after diagrams, recommendation-strength badges, and a top recommendation. - Grilling loop and interface design: After the user picks a candidate, runs a design conversation that updates CONTEXT.md, offers ADRs for rejected candidates, and spawns parallel sub-agents to propose radically different interfaces. - Use Case: Ask for an architecture review of a ticketing backend; receive an HTML report showing, for example, how an order intake pipeline of six shallow wrappers could collapse into one deep module with a single testable interface. ## Quick Start Ask the assistant to review this repository's architecture and produce a report of deepening opportunities.
