improve-codebase-architecture

Run this Skill to scan your codebase for shallow modules, leaky seams, and poor locality. It weights recently changed files from git history, then presents each candidate as a card in a visual HTML report with before/after diagrams.

A shallow module has an interface nearly as complex as its implementation, adding indirection without hiding complexity. The Skill applies the deletion test: if deleting the module would concentrate complexity rather than just move it, it is a deepening candidate.

The report is written as a self-contained HTML file to the OS temp directory ($TMPDIR, /tmp, or %TEMP%) named architecture-review-<timestamp>.html, so nothing lands in your repository. It is opened automatically in your browser.

Yes, the Skill reads ADRs in docs/adr/ before suggesting changes and avoids re-litigating recorded decisions. It only surfaces a candidate that contradicts an ADR when the friction is real enough to warrant reopening it, marked with a warning callout.

The Skill runs a grilling loop that walks the decision tree with you: constraints, dependencies, the deepened module's shape, and test impact. It updates CONTEXT.md with new domain terms and offers to record load-bearing rejections as ADRs.