Codebase Design: скилл-словарь для проектирования модулей

mattpocock/skills· Проверено 13.11.2026· 323,4 тыс.на GitHub

Скилл-справочник Мэтта Пококка по проектированию «глубоких» модулей: агент получает точные слова — модуль, интерфейс, глубина, шов, адаптер — и правила, где ставить границу.

Как установить Codebase Design

Личные скиллы лежат в ~/.claude/skills/, проектные — в .claude/skills/ репозитория. Проверка: команда /skills в сессии, вызов по имени — /codebase-design.

# плагином, внутри Claude Code
/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocock

# или вручную
git clone --depth 1 https://github.com/mattpocock/skills.git /tmp/codebase-design
mkdir -p ~/.claude/skills/codebase-design
cp -r /tmp/codebase-design/skills/engineering/codebase-design/. ~/.claude/skills/codebase-design/

Общая папка ~/.agents/skills/ (в проекте — .agents/skills/) читают Codex, Cursor, VS Code Copilot, Gemini CLI, Antigravity, OpenCode, Kilo Code, Goose, Qwen Code.

git clone --depth 1 https://github.com/mattpocock/skills.git /tmp/codebase-design
mkdir -p ~/.agents/skills/codebase-design
cp -r /tmp/codebase-design/skills/engineering/codebase-design/. ~/.agents/skills/codebase-design/

Установщик скиллов от Vercel, нужен Node.js 22.20 или новее. Без -g скилл ставится в текущий проект; флаг -a выбирает агента.

npx skills add mattpocock/skills --skill codebase-design -a claude-code

# для всех проектов
npx skills add mattpocock/skills --skill codebase-design -g

Нужен тариф Pro, Max, Team или Enterprise с включённым выполнением кода.

Скачайте папку скилла с GitHub и упакуйте её в ZIP.
claude.ai → Customize → Skills → + → Create skill → Upload a skill
Загрузите ZIP и включите скилл переключателем.

Gemini CLI ставит скиллы из git-репозитория и хранит их в ~/.gemini/skills/.

gemini skills install https://github.com/mattpocock/skills.git --consent

# проверка
gemini skills list

Что умеет

Спроектировать или упростить интерфейс модуля: меньше методов, проще параметры

Решить, где поставить шов и нужен ли он вообще

Проверить модуль тестом удаления: исчезнет ли сложность вместе с ним

Сделать код удобнее для тестов: зависимости приходят снаружи, функции возвращают результат

Набросать несколько разных интерфейсов параллельными субагентами и сравнить их

Основа скилла — глоссарий терминов с запретом на синонимы: вместо component, service, API и boundary — модуль, интерфейс и шов.

Принципы: глубина — свойство интерфейса; интерфейс и есть поверхность для тестов; один адаптер — шов гипотетический, два — настоящий.

Подробности вынесены в DEEPENING.md (как углублять группу модулей с учётом зависимостей) и DESIGN-IT-TWICE.md (три и больше субагентов проектируют интерфейс по-разному).

Процесса и вопросов у скилла нет. Агент вызывает его сам, его словарь берут другие скиллы набора.

Что нужно

АгентыРассчитан на Claude Code и Codex; параллельное проектирование в DESIGN-IT-TWICE.md опирается на инструмент Agent из Claude Code.

Что попросить агента

/codebase-design Где поставить шов между <модулем заказов> и платёжным шлюзом?Разберёт варианты в терминах шва, адаптера и глубины и объяснит, нужен ли второй адаптер

Сделай интерфейс <OrderService> глубжеПредложит сократить методы и параметры и спрятать сложность внутрь модуля

Design it twice: дай три разных интерфейса для <модуля кэша>Запустит параллельных субагентов и сравнит варианты по глубине, локальности и месту шва

Ограничения

Без чёткой задачи агент сам придумывает процесс и тратит много токенов на переделку того, о чём не просили

Параллельное проектирование вне Claude Code работает плохо: там может не быть инструмента Agent

Справочник по форме модулей: структуру папок и barrel-файлов он не задаёт

Описание из SKILL.md

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.

Частые вопросы

Как установить codebase design skill в Claude Code?

Через набор Пококка: claude plugin install mattpocock-skills@claude-plugins-official. Скилл подключается сам, когда речь о форме модуля.

Работает ли codebase design в Cursor?

Ставится через npx skills@latest add mattpocock/skills -a cursor. Параллельные субагенты из DESIGN-IT-TWICE.md рассчитаны на Claude Code.

Чем codebase-design отличается от domain-modeling?

Codebase-design про форму модуля: интерфейс, шов, глубину. Domain-modeling про слова предметной области и GLOSSARY.md.

Когда брать improve-codebase-architecture?

Когда вы ещё не знаете, какой модуль переделывать. Codebase-design нужен, когда модуль уже выбран.

Почему агент сжёг 100 тысяч токенов на редизайн?

Это известная проблема: скилл описывает словарь, но ничто не мешает агенту принять его за процесс. Давайте узкую задачу и конкретный модуль.

Сколько установок у codebase-design?

На skills.sh на 13.11.2026 — 949 698 установок, 26-е место в общем рейтинге.