improve-codebase-architecture

What problem does it solve? Codebases accumulate shallow modules whose interfaces are nearly as complex as their implementations, making them hard to test, navigate, and reason about. This Skill surfaces that architectural friction and proposes concrete deepening refactors grounded in the project's own domain language and recorded ADR decisions. ## Core Features & Use Cases - Architecture exploration: Walks the codebase with an Explore sub-agent to find shallow modules, leaking seams, and tightly-coupled clusters, applying the deletion test to validate candidates. - 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 section. - 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 design alternative interfaces. - Use Case: A team inherits a service where order processing logic is scattered across six thin wrappers. Run this Skill to get a visual report showing how to collapse them into one deep module with a single testable interface. ## Quick Start Ask the agent to review this repository for architectural deepening opportunities and produce an HTML report of the candidates.