Log inSign up
Skills › Coding & architecture
mattpocock logo
#25 by installsCoding & architecturemattpocock/skills

codebase-design

Deep module design vocabulary for building testable, maintainable code with small interfaces

Installs
860K
all time
This week
37.7K
installs
Repo stars
276.1K
GitHub
First seen
Jun 4, 2026
on skills.sh
Install
npx skills add https://github.com/mattpocock/skills --skill codebase-design
Works with Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI and other agents that read SKILL.md.
What 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
Source on GitHub ↗On skills.sh ↗