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 surfaces that architectural friction and proposes concrete deepening refactors, presented visually rather than as a wall of prose. ## Core Features & Use Cases - Hot-spot-driven exploration: Scopes the scan using git history and user direction, then explores the codebase for shallow modules, seam leakage, and poor locality. - Visual HTML report: Generates 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 for each candidate. - Guided decision loop: After the user picks a candidate, runs a grilling workflow to refine the design, updates CONTEXT.md with new domain terms, and offers ADRs for load-bearing rejections. - Use Case: A team notices their order intake logic is scattered across six thin wrappers. Run this Skill to get a visual report of deepening candidates, pick one, and walk through the refactor decision tree. ## Quick Start Ask the agent to run the improve-codebase-architecture skill on the current repository and open the generated architecture review report.
