I
improve-codebase-architecture
bymattpocock·#16 trending
Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve…
119,700stars
First seenMar 13, 2026
Installation
Send this command to your AI agent:
npx skills add https://github.com/mattpocock/skills --skill improve-codebase-architectureDocumentation
Analyze codebases for architectural friction and propose module-deepening refactors as testability improvements.
- 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
- Creates GitHub issue RFCs documenting the problem space, design trade-offs, and refactoring rationale