What problem does it solve? Codebases accumulate shallow modules whose interfaces are nearly as complex as their implementations, making them hard to test and hard for humans and AI agents to navigate. This Skill surfaces that architectural friction and turns it into concrete, visualized refactoring candidates. ## Core Features & Use Cases - Architecture exploration: Walks the codebase (guided by recent commit hot spots, CONTEXT.md domain language, and existing ADRs) to find shallow modules, leaking seams, and untestable areas, applying the deletion test to each suspect. - Visual HTML report: Renders each candidate as a self-contained HTML file in the OS temp directory using Tailwind and Mermaid via CDN, with before/after diagrams, recommendation-strength badges, and ADR-conflict callouts. - Decision grilling loop: After you pick a candidate, it hands off to the grill-me skill to walk constraints, dependencies, and the shape of the deepened module, updating CONTEXT.md or proposing ADRs when decisions stick. - Use Case: Point it at a subsystem that keeps churning in git history; it produces a report showing, for example, that the Order intake pipeline is six shallow layers deep and proposes collapsing it into one deep module with a single testable interface. ## Quick Start Use the improve-codebase-architecture skill to review this repository and show me the top deepening opportunities in an HTML report.
