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 and navigate. This Skill surfaces that architectural friction and proposes concrete deepening refactors grounded in a shared design vocabulary. ## Core Features & Use Cases - Hot-spot-driven exploration: Scopes the review using git history and user direction, then spawns a sub-agent to find shallow modules, seam leakage, and poor locality. - Visual HTML report: Renders each candidate as a before/after card in a self-contained HTML file using Tailwind and Mermaid via CDN, with recommendation-strength badges and ADR conflict callouts. - Grilling loop: After the user picks a candidate, walks the decision tree with companion skills (grilling, domain-modeling, codebase-design) and keeps CONTEXT.md and ADRs current. - Use Case: Point it at a recently churned subsystem; it identifies that the Order intake pipeline is shallow, shows a before/after diagram collapsing six wrappers into one deep module, and grills you through the refactor decisions. ## Quick Start Ask the agent to review the architecture of the current codebase and present deepening opportunities as an HTML report.