Domain Modeling: скилл для словаря проекта и записей решений

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

Скилл Мэтта Пококка для словаря проекта: агент ловит размытые и спорные термины, сверяет их с кодом и записывает в GLOSSARY.md, а трудные решения — в ADR.

Как установить Domain Modeling

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

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

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

Что умеет

Указать, что термин расходится с определением в GLOSSARY.md
Предложить точное слово вместо размытого: Customer или User вместо «аккаунта»
Проверить границы понятий на придуманных пограничных сценариях
Найти противоречие между вашими словами и тем, что делает код
Записать термин в глоссарий сразу и предложить ADR, если решение проходит три проверки

Файлы создаются по мере надобности: GLOSSARY.md при первом термине, docs/adr/ при первом ADR. Если в корне есть GLOSSARY-MAP.md, у каждого контекста свой глоссарий.

Термин описывает, что это такое, в одной-двух фразах; отвергнутые синонимы идут под _Avoid_. Форматы — в GLOSSARY-FORMAT.md и ADR-FORMAT.md.

ADR пишется, только когда решение трудно отменить, без контекста оно удивит и за ним стоит реальный выбор. Не прошло хоть одну проверку — ADR нет.

Агент вызывает скилл сам; чаще он работает внутри grill-with-docs, triage, wayfinder и improve-codebase-architecture.

Что нужно
АгентыРассчитан на Claude Code и Codex: рядом со SKILL.md лежит agents/openai.yaml для Codex.

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

/domain-modeling Мы называем отменой и возврат, и отказ от заказа. РазберисьПредложит канонический термин, второй запишет под _Avoid_ и обновит GLOSSARY.md
/grill-with-docs help me scaffold my existing repo with a GLOSSARY.mdЧерез допрос соберёт глоссарий для репозитория, где его не было
Мы решили хранить заказы через event sourcing, запиши этоПроверит решение по трём условиям и предложит ADR в docs/adr/ или объяснит, какое условие не выполнено

Ограничения

!

Модели склонны превращать GLOSSARY.md в спецификацию с деталями реализации, это самая частая жалоба

!

Сверяет термины только с кодом, глоссарием и ADR: решения из закрытых issue скилл не видит

!

Формат и место ADR зашиты в скилл, свой шаблон ADR без правки скилла не подключить

!

Внутри grill-with-docs модели часто загружают только grilling и пропускают этот скилл

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

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

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

Как установить domain modeling skill в Claude Code?
Через набор Пококка: claude plugin install mattpocock-skills@claude-plugins-official. Скилл срабатывает сам, когда разговор идёт о терминах проекта.
Можно ли поставить domain modeling в Gemini CLI?
Да: gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering.
Раньше файл назывался CONTEXT.md. Что изменилось?
До версии 1.3.0 файл назывался CONTEXT.md. Запустите /setup-matt-pocock-skills: он предложит переименовать файл через git mv.
Глоссарий разросся до тысяч строк. Что делать?
Вызовите /grill-with-docs с просьбой сократить GLOSSARY.md и убрать детали реализации. Делить файл через GLOSSARY-MAP.md стоит только после чистки.
Куда делся скилл ubiquitous-language?
Его убрали, работу взял domain-modeling: он ведёт модель постоянно, внутри допросов и триажа.
Сколько установок у domain-modeling?
На skills.sh на 13.11.2026 — 974 755 установок, 25-е место в общем рейтинге.

Похожие скиллы