Skip to content
Kitbay
Submit
Skill

codebase-design

MITUpdated on Nov 9, 2026321,493GitHub stars

A skill from Matt Pocock's collection that gives an agent a shared vocabulary for designing deep modules: a lot of behaviour behind a small interface, placed at a clean seam and tested through that interface.

InstallRepository Checked on Nov 15, 2026

What the skill teaches

A skill from Matt Pocock's collection that gives an agent a shared vocabulary for designing deep modules: a lot of behaviour behind a small interface, placed at a clean seam and tested through that interface. It defines module, interface, implementation, adapter, depth, seam, leverage and locality, and asks the agent to avoid looser words such as component or service. It offers a deletion test for pass-through modules, says tests should cross the same seam callers use, and suggests fewer methods, simpler parameters and injected dependencies. Two linked files cover deepening a cluster of code and designing an interface twice with parallel sub-agents. It has no scripts.

Capabilities

  • Find opportunities to deepen shallow modules
  • Decide where a seam and interface belong
  • Make code easier to test through its interface
  • Compare alternative interfaces with parallel sub-agents