codebase-design
Shared vocabulary and patterns for designing deep modules with narrow interfaces and clean seams. Use when designing module interfaces, finding deepening opportunities, deciding where seams go, or making code more testable and AI-navigable — even if the user says "improve this module". Do NOT use for whole-codebase architectural surveys.
Pinned to revision c17bbea17056, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/codebase-design/SKILL.md
- skills/codebase-design/DEEPENING.md
- skills/codebase-design/DESIGN-IT-TWICE.md
- skills/codebase-design/agents/openai.yaml
Every link opens the file at its source, pinned to the revision this page describes.