Matt Pocock и его библиотека skills для инженеров: TDD, планирование и продакшн-воркфлоу

Matt Pocock, автор Total TypeScript и бывший инженер Vercel, опубликовал свою коллекцию AI-скиллов — mattpocock/skills. На июнь 2026 у репозитория больше 135 000 звёзд и 11 700 форков, текущая версия — v1.0.1. Это не очередная «набей-промпт-и-надейся» библиотека: набор построен вокруг четырёх конкретных failure mode и чётко разделяет user-invoked оркестраторы и model-invoked дисциплину.

Главная идея

Покок позиционирует свою работу как «skills for real engineers, straight from my .claude directory». Принципы:

• Маленькие, компонуемые, легко адаптируемые скиллы
• Работают с любой моделью, а не только с Claude
• Не забирают контроль у разработчика — в отличие от GSD, BMAD и Spec-Kit, которые «владеют процессом» целиком

Установка:

npx skills@latest add mattpocock/skills

После установки обязательно запустить /setup-matt-pocock-skills один раз на репозиторий — он спросит про issue tracker, triage labels и расположение документации.

Четыре failure mode

Весь репозиторий организован вокруг четырёх типичных проблем AI-ассистированной разработки.

1. Агент сделал не то

Misalignment — разрыв между тем, что имел в виду разработчик, и тем, что построил агент. Решение — grilling session, где агент задаёт вопросы до начала работы.

2. Агент слишком многословен

LLM приходят в проект «холодными» и используют 20 слов там, где хватило бы одного доменного термина. Это та же проблема ubiquitous language Эрика Эванса, только применённая к языковым моделям.

Пример из репозитория course-video-manager Покока:

• Было: «There's a problem when a lesson inside a section of a course is made 'real' (i.e. given a spot in the file system)»
• Стало: «There's a problem with the materialization cascade»

/grill-with-docs и model-invoked domain-modeling строят и поддерживают этот словарь в CONTEXT.md.

3. Код не работает

Выравнивание без обратной связи — полёт вслепую. Решение: статическая типизация, доступ к браузеру, автоматические тесты. TDD обязателен.

В v1.0 /tdd делегирует вопросы дизайна интерфейсов скиллу codebase-design — дублирующая документация убрана.

4. Получился комок грязи

AI ускоряет и кодинг, и энтропию — кодовые базы усложняются быстрее, чем когда-либо. Решение: думать о дизайне каждый день.

Покок рекомендует запускать /improve-codebase-architecture раз в несколько дней на активных кодовых базах.

User-invoked vs model-invoked (таксономия v1.0)

В v1.0.1 старая пара «Commands / Skills» переименована. Полное определение — в docs/invocation.md.

Роутер: /ask-matt (user-invoked) отправляет в правильный поток, если не уверены, какой скилл подходит.

Полная карта скиллов (июнь 2026)

Engineering — ежедневная работа

User-invoked: ask-matt, grill-with-docs, triage, improve-codebase-architecture, setup-matt-pocock-skills, to-issues, to-prd, prototype.

Model-invoked: diagnosing-bugs, tdd, domain-modeling, codebase-design.

Productivity — не только про код

User-invoked: grill-me, handoff, teach, writing-great-skills.

Model-invoked: grilling.

Misc — ставить по необходимости

git-guardrails-claude-code, migrate-to-shoehorn, scaffold-exercises, setup-pre-commit, resolving-merge-conflicts.

Удалено в v1.0 (breaking)

Философия

README и описания скиллов подчёркивают дисциплину вместо скорости:

• TDD first — /tdd форсирует red-green-refactor
• Планирование до кодинга — /grill-me и /grill-with-docs не пустят дальше, пока решения не станут явными
• Вертикальные срезы — /to-issues разбивает работу на независимо поставляемые куски
• Безопасный git — /git-guardrails-claude-code блокирует деструктивные команды без подтверждения
• Deep modules + domain language — /codebase-design и /domain-modeling поддерживают архитектуру и словарь согласованными

Как работает /tdd

Самый упоминаемый скилл Покока. Цикл:

1. Red — написать падающий тест, описывающий желаемое поведение
2. Green — минимальный код, чтобы тест прошёл
3. Refactor — почистить реализацию, удерживая тесты зелёными
4. Repeat — строить фичу по одному вертикальному срезу за раз

Пример:

Пользователь: «Добавь валидацию в форму логина»

Агент с /tdd: «Сначала напишу тест на невалидный email, затем реализую валидацию»

Установка:

npx skills@latest add mattpocock/skills/tdd

Цепочка /to-prd → /to-issues

Частый паттерн — связка скиллов:

1. Conversation — обсуждение фичи или проблемы с агентом
2. /to-prd — превращает разговор в PRD и кладёт его в GitHub issue без опроса
3. /to-issues — разбивает PRD на независимо подхватываемые issues через вертикальные срезы

Установка:

npx skills@latest add mattpocock/skills/to-prd
npx skills@latest add mattpocock/skills/to-issues

Domain-driven design: CONTEXT.md + общие скиллы

Архитектурный воркфлоу Покока в v1.0 многослойный:

1. /grill-with-docs или domain-modeling строят ubiquitous language в CONTEXT.md и ADR
2. codebase-design — deep modules, seams, адаптеры (по Ousterhout)
3. /improve-codebase-architecture — сканирует кодовую базу, выдаёт HTML-отчёт, вы выбираете одно направление для углубления

Пример: если в кодовой базе есть processOrder(), а бизнес говорит про «fulfillment workflows», domain-modeling пометит расхождение и предложит рефакторинг к бизнес-языку, а codebase-design подскажет, где выделить новый интерфейс.

Git guardrails

Скилл /git-guardrails-claude-code ставит Claude Code hooks и блокирует:

• git push --force
• git reset --hard
• git clean -f
• git branch -D
• Другие деструктивные команды

Без явного подтверждения hook не пускает команду. Критично, когда у агента есть доступ к терминалу.

/prototype

Скилл /prototype (v1.0, заменил design-an-interface) строит одноразовые прототипы:

• Терминальное приложение — когда вопрос про state или бизнес-логику
• Несколько UI-вариантов — радикально разные подходы, переключаемые на одном маршруте

Использовать до выбора пути реализации — та же цель «сравнить альтернативы рано», но с меньшими накладными расходами на сабагентов.

npx skills@latest add mattpocock/skills/prototype

/writing-great-skills

Мета-скилл для авторов. Заменил write-a-skill в v1.0 на writing-great-skills плюс GLOSSARY.md — словарь и принципы предсказуемых скиллов, охота на no-ops до уровня предложения.

npx skills@latest add mattpocock/skills/writing-great-skills

Минимальный «попробовать» путь

1. npx skills@latest add mattpocock/skills — выбрать setup-matt-pocock-skills, tdd, grill-me, git-guardrails-claude-code
2. Запустить /setup-matt-pocock-skills один раз
3. На следующей фиче: /grill-me → обсуждение → /to-prd → /to-issues → /tdd на первом срезе
4. Если потерялись: /ask-matt

Для крупных кодовых баз добавить /improve-codebase-architecture, /domain-modeling и /codebase-design (model-invoked — ставить бандлом).

Сравнение с соседями

Все три дополняют друг друга: mattpocock/skills для инженерной строгости, gstack для спринтового ритма, explainx.ai /skills для обнаружения доменных скиллов.

Кто такой Matt Pocock

Matt Pocock — TypeScript-евангелист и разработчик:

• Total TypeScript — продакшн-курс по TypeScript, тысячи студентов
• Бывший инженер Vercel — работал над dev-инструментами и TS-инфраструктурой
• Бывший инженер Stately — вклад в XState и паттерны стейт-машин
• 60 000+ подписчиков рассылки — TypeScript, AI-воркфлоу, инженерные практики
• 25 500 → 135 000+ звёзд на mattpocock/skills (июнь 2026)

Каналы:

• Рассылка: totaltypescript.com/newsletter
• Twitter/X: @mattpocock
• GitHub: github.com/mattpocock
• Total TypeScript: totaltypescript.com

Итог

mattpocock/skills — MIT-лицензированная библиотека для реальной инженерии: четыре failure mode, user-invoked оркестраторы и model-invoked дисциплина, 135K+ звёзд, v1.0.1 с progressive disclosure.

Начать с /setup-matt-pocock-skills, затем /grill-me, /tdd и /git-guardrails-claude-code. Масштабировать через /improve-codebase-architecture, domain-modeling и codebase-design.