#4 by installsCoding & architecture
improve-codebase-architecture
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
1.0M
42.8K
276.1K
Mar 13, 2026
Install
npx skills add https://github.com/mattpocock/skills --skill improve-codebase-architectureWhat it does
Analyze codebases for architectural friction and propose module-deepening refactors as testability improvements. Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
- Explores codebases organically to surface shallow modules, tightly-coupled components, and untested seams rather than following rigid heuristics
- Applies John Ousterhout's "deep module" principle: small interfaces hiding large implementations for better testability and AI navigability
- Generates multiple radically different interface designs (minimalist, flexible, caller-optimized, ports & adapters) via parallel sub-agents, then recommends the strongest approach
