Codebase Design

A shared vocabulary for designing deep modules.

By

Matt Pocock

Price

Free

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

Matt Pocock

Code Review

Matt Pocock

Review a branch against your standards and the spec.

Matt Pocock

Prototype

Matt Pocock

Answer a design question with throwaway code.

Jakub Krehel

Better Typography

Jakub Krehel

Set the type scale, spacing, and wrapping right.

Matt Pocock

Improve Codebase Architecture

Matt Pocock

Find the refactors that make a codebase easier to change.

Codebase Design

A shared vocabulary for designing deep modules.

By

Matt Pocock

Price

Free

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

Matt Pocock

Code Review

Matt Pocock

Review a branch against your standards and the spec.

Matt Pocock

Prototype

Matt Pocock

Answer a design question with throwaway code.

Jakub Krehel

Better Typography

Jakub Krehel

Set the type scale, spacing, and wrapping right.

Matt Pocock

Improve Codebase Architecture

Matt Pocock

Find the refactors that make a codebase easier to change.

Codebase Design

A shared vocabulary for designing deep modules.

By

Matt Pocock

Price

Free

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

Matt Pocock

Code Review

Matt Pocock

Review a branch against your standards and the spec.

Matt Pocock

Prototype

Matt Pocock

Answer a design question with throwaway code.

Jakub Krehel

Better Typography

Jakub Krehel

Set the type scale, spacing, and wrapping right.

Matt Pocock

Improve Codebase Architecture

Matt Pocock

Find the refactors that make a codebase easier to change.