Codebase Design is an agent skill by Matt Pocock that gives you and your agent the same words for code structure: modules, interfaces, depth, seams, and adapters.
What it does
Defines each term precisely, and names the loose words to avoid.
Explains deep modules: lots of behavior behind a small interface.
Covers designing for testability through the interface.
Backs several of his other skills, like TDD and Improve Codebase Architecture.
When to use it
Reach for it when designing or reshaping a module's interface, or deciding where a seam should go.
How to get it
The skill is free on GitHub under the MIT license, in Matt Pocock's skills repo. Your agent can reach for it on its own when the task fits, or you can call it by name.
more skills
Codebase Design is an agent skill by Matt Pocock that gives you and your agent the same words for code structure: modules, interfaces, depth, seams, and adapters.
What it does
Defines each term precisely, and names the loose words to avoid.
Explains deep modules: lots of behavior behind a small interface.
Covers designing for testability through the interface.
Backs several of his other skills, like TDD and Improve Codebase Architecture.
When to use it
Reach for it when designing or reshaping a module's interface, or deciding where a seam should go.
How to get it
The skill is free on GitHub under the MIT license, in Matt Pocock's skills repo. Your agent can reach for it on its own when the task fits, or you can call it by name.
more skills
Codebase Design is an agent skill by Matt Pocock that gives you and your agent the same words for code structure: modules, interfaces, depth, seams, and adapters.
What it does
Defines each term precisely, and names the loose words to avoid.
Explains deep modules: lots of behavior behind a small interface.
Covers designing for testability through the interface.
Backs several of his other skills, like TDD and Improve Codebase Architecture.
When to use it
Reach for it when designing or reshaping a module's interface, or deciding where a seam should go.
How to get it
The skill is free on GitHub under the MIT license, in Matt Pocock's skills repo. Your agent can reach for it on its own when the task fits, or you can call it by name.


