What problem does it solve? Codebases accumulate shallow modules whose interfaces are nearly as complex as their implementations, scattering logic across tightly-coupled files and making testing and navigation difficult. This Skill surfaces that architectural friction and proposes concrete deepening refactors grounded in your project's domain language and existing ADRs. ## Core Features & Use Cases - Architecture Exploration: Uses an Explore sub-agent to walk the codebase and detect shallow modules, pass-through abstractions, and tightly-coupled seams, applying the deletion test to validate candidates. - Deepening Proposals: Presents a numbered list of refactoring opportunities with files, problems, solutions, and benefits framed in terms of leverage and locality, while respecting existing ADRs. - Guided Design Conversation: Runs a grilling loop on the chosen candidate, updates CONTEXT.md with new domain terms, offers ADRs for rejected candidates, and can spawn parallel sub-agents to design alternative interfaces. - Use Case: Ask the Skill to review a service layer where logic is split across many small handlers; it identifies consolidation candidates, then helps you design a deep module with a small interface and testable seam. ## Quick Start Ask the assistant to review this codebase for architecture improvements and propose deepening opportunities for the most tightly-coupled modules.
