# codebase-design

Agent skill by Matt Pocock (https://www.totaltypescript.com)

Gives the agent language for the thing most architecture conversations lack: where a seam belongs, what makes a module deep rather than wide, and why a narrow interface over real work is easier for both people and agents to navigate.

Topics: Architecture, Systems
Last updated: 2026-08-19 (28 days ago)
Source: https://github.com/mattpocock/skills
Repository: https://github.com/mattpocock/skills

## Install

```bash
npx skills add https://github.com/mattpocock/skills --skill codebase-design
```

## In the author's words

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

## Verification

- Source link: Resolved (HTTP 200) (pass)
- Repository: Resolves on GitHub (pass)
- Install command: Transcribed from the author's own page (pass)
- Maintenance: Last updated 28 days ago (pass)
- Attribution: Credited to Matt Pocock (pass)

Full page: https://stackskills.dev/library/codebase-design