#20 by installsCoding & architecture
codebase-design
Deep module design vocabulary for building testable, maintainable code with small interfaces
732K
43.8K
276.1K
Jun 4, 2026
Install
npx skills add https://github.com/mattpocock/skills --skill codebase-designWhat it does
Provides shared language and principles for designing modules that hide complexity behind clean interfaces. Use it when restructuring code, improving testability, deciding where architectural seams belong, or making codebases easier for AI to navigate. The vocabulary—module, interface, implementation, depth, seam, adapter—stays consistent across scales from functions to distributed systems.
- Design deep modules: large behaviour behind small interfaces, placed at clean seams
- Decide where architectural seams go and what adapters satisfy them
- Make code more testable by deepening interfaces and clarifying invariants and error modes
- Shared vocabulary ensures consistent design language across teams and AI tools
