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 identifies that architectural friction and proposes deepening refactors that consolidate tightly-coupled modules behind smaller interfaces. ## Core Features & Use Cases - Architecture exploration: Spawns a read-only exploration pass over the codebase, applying the deletion test to find shallow modules, leaked seams, and untestable areas. - Visual HTML report: Generates a self-contained HTML report (Tailwind and Mermaid via CDN) in the OS temp directory with before/after diagrams, recommendation-strength badges, and a top recommendation. - Guided design conversation: Runs a grilling loop on the chosen candidate, with optional parallel sub-agents producing radically different interface designs (Design It Twice), and records decisions in .claude/CONTEXT.md or SPEC files. - Use Case: A maintainer suspects the order intake pipeline is over-fragmented. Run the Skill to get a visual report of deepening candidates, pick one, and explore alternative interfaces before committing to a refactor. ## Quick Start Ask the assistant to run improve-codebase-architecture on this repository and open the generated architecture review report.
