Модель предметной области

Уточняет язык предметной области по ходу проектирования: оспаривает размытые и противоречивые термины, сразу пишет согласованные в GLOSSARY.md и предлагает короткий ADR лишь для трудно обратимых решений. Для случаев, когда обсуждают термины или пишут ADR.

ДокументацияПак: Скиллы Мэтта Покока74 строкиdomain-modeling
Автор
Источник
mattpocock/skills/skills/engineering/domain-modeling @ abeeaf9
Лицензия
MIT · Copyright (c) 2026 Matt Pocock

Об этом скилле

Что делает

Скилл следит, чтобы язык проекта оставался точным, пока вы проектируете. Агент замечает слово, которое расходится с GLOSSARY.md («в глоссарии отмена — это X, а вы, похоже, имеете в виду Y»), спрашивает, какое понятие стоит за размытым словом («аккаунт» — это Customer или User?), придумывает пограничные случаи, чтобы найти, где кончается одно понятие и начинается другое, и сверяет ваши утверждения с кодом. Каждый согласованный термин сразу попадает в GLOSSARY.md, а не пачкой в конце. В глоссарии только определения — ни деталей реализации, ни спецификации, ни черновых заметок.

ADR скилл предлагает, только если решение трудно отменить, без контекста оно удивит и за ним стоит настоящий выбор между вариантами; не хватает хоть одного условия — ADR не будет. Файлы создаются, только когда в них есть что записать. В репозитории с несколькими контекстами в корне лежит GLOSSARY-MAP.md, который указывает на глоссарий и docs/adr/ каждого контекста.

GLOSSARY-FORMAT.md задаёт формат статьи — термин жирным, определение в одно-два предложения, строка _Avoid_: с отвергнутыми синонимами, только термины этого проекта — и устройство GLOSSARY-MAP.md. ADR-FORMAT.md задаёт формат ADR: docs/adr/0001-slug.md, заголовок и одно-три предложения, по желанию статус, варианты и последствия, и список того, что стоит записывать, — от технологий, которые потом трудно заменить, до ограничений, которых не видно в коде. agents/openai.yaml — название и описание для Codex.

Когда включать и когда не надо

Когда обсуждаете терминологию, когда в разговоре о дизайне или разборе задачи договариваетесь, что значат слова, и когда пишете статью глоссария или ADR.

Просто прочитать GLOSSARY.md ради словаря — это не этот скилл, так сказано в самом SKILL.md. Обычную документацию и README он не пишет.

Как поставить и вызвать

Команда установки ниже кладёт всю папку. Агент сам подхватывает скилл по описанию, когда речь идёт о терминах или ADR. Вызвать вручную:

  • Claude Code: /domain-modeling или попросить скилл по имени.
  • Codex: $domain-modeling.
  • Cursor: наберите / в чате Agent и выберите domain-modeling.

Пример: /domain-modeling «Аккаунтом» у нас называют и логин, и компанию-плательщика. Разведи термины и обнови GLOSSARY.md.

triage, wayfinder и improve-codebase-architecture вызывают его вместе с grilling, а tdd, to-spec, to-tickets и diagnosing-bugs опираются на глоссарий и ADR, которые он пишет.

Чем отличается от похожих

Запись архитектурного решения (ADR) из нашего каталога по запросу пишет полный ADR: контекст, решение, не меньше двух вариантов, последствия, статус и дату. Документация и ADR охватывает ещё комментарии, документацию API, README, changelog и отставание документации от кода. Здесь ADR — абзац и побочный продукт, который предлагается только после проверки тремя условиями; главный результат — глоссарий, а его ни один из тех скиллов не ведёт.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/domain-modeling/SKILL.md https://anymodel.org/en/skills/matt-pocock/domain-modeling/SKILL.md -o ~/.claude/skills/domain-modeling/ADR-FORMAT.md https://anymodel.org/en/skills/matt-pocock/domain-modeling/ADR-FORMAT.md -o ~/.claude/skills/domain-modeling/GLOSSARY-FORMAT.md https://anymodel.org/en/skills/matt-pocock/domain-modeling/GLOSSARY-FORMAT.md -o ~/.claude/skills/domain-modeling/LICENSE https://anymodel.org/en/skills/matt-pocock/domain-modeling/LICENSE -o ~/.claude/skills/domain-modeling/agents/openai.yaml https://anymodel.org/en/skills/matt-pocock/domain-modeling/agents/openai.yaml
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/domain-modeling/SKILL.md https://anymodel.org/en/skills/matt-pocock/domain-modeling/SKILL.md -o ~/.agents/skills/domain-modeling/ADR-FORMAT.md https://anymodel.org/en/skills/matt-pocock/domain-modeling/ADR-FORMAT.md -o ~/.agents/skills/domain-modeling/GLOSSARY-FORMAT.md https://anymodel.org/en/skills/matt-pocock/domain-modeling/GLOSSARY-FORMAT.md -o ~/.agents/skills/domain-modeling/LICENSE https://anymodel.org/en/skills/matt-pocock/domain-modeling/LICENSE -o ~/.agents/skills/domain-modeling/agents/openai.yaml https://anymodel.org/en/skills/matt-pocock/domain-modeling/agents/openai.yaml
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','ADR-FORMAT.md','GLOSSARY-FORMAT.md','LICENSE','agents/openai.yaml') { $p = Join-Path "$HOME\.claude\skills\domain-modeling" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/matt-pocock/domain-modeling/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','ADR-FORMAT.md','GLOSSARY-FORMAT.md','LICENSE','agents/openai.yaml') { $p = Join-Path "$HOME\.agents\skills\domain-modeling" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/matt-pocock/domain-modeling/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/matt-pocock/domain-modeling/SKILL.md

SKILL.md

Исходник

Domain Modeling

Actively build and sharpen the project's domain model as you design. This is the active discipline: challenging terms, inventing edge-case scenarios, and writing the glossary and decisions down the moment they crystallise. (Merely reading GLOSSARY.md for vocabulary is not this skill: that's a one-line habit any skill can do. This skill is for when you're changing the model, not just consuming it.)

File structure

Most repos have a single context:

/
├── GLOSSARY.md
├── docs/
│   └── adr/
│       ├── 0001-event-sourced-orders.md
│       └── 0002-postgres-for-write-model.md
└── src/

If a GLOSSARY-MAP.md exists at the root, the repo has multiple contexts. The map points to where each one lives:

/
├── GLOSSARY-MAP.md
├── docs/
│   └── adr/                          ← system-wide decisions
├── src/
│   ├── ordering/
│   │   ├── GLOSSARY.md
│   │   └── docs/adr/                 ← context-specific decisions
│   └── billing/
│       ├── GLOSSARY.md
│       └── docs/adr/

Create files lazily: only when you have something to write. If no GLOSSARY.md exists, create one when the first term is resolved. If no docs/adr/ exists, create it when the first ADR is needed.

During the session

Challenge against the glossary

When the user uses a term that conflicts with the existing language in GLOSSARY.md, call it out immediately. "Your glossary defines 'cancellation' as X, but you seem to mean Y. Which is it?"

Sharpen fuzzy language

When the user uses vague or overloaded terms, propose a precise canonical term. "You're saying 'account': do you mean the Customer or the User? Those are different things."

Discuss concrete scenarios

When domain relationships are being discussed, stress-test them with specific scenarios. Invent scenarios that probe edge cases and force the user to be precise about the boundaries between concepts.

Cross-reference with code

When the user states how something works, check whether the code agrees. If you find a contradiction, surface it: "Your code cancels entire Orders, but you just said partial cancellation is possible. Which is right?"

Update GLOSSARY.md inline

When a term is resolved, update GLOSSARY.md right there. Don't batch these up: capture them as they happen. Use the format in GLOSSARY-FORMAT.md.

GLOSSARY.md should be totally devoid of implementation details. Do not treat GLOSSARY.md as a spec, a scratch pad, or a repository for implementation decisions. It is a glossary and nothing else.

Offer ADRs sparingly

Only offer to create an ADR when all three are true:

  1. Hard to reverse: the cost of changing your mind later is meaningful
  2. Surprising without context: a future reader will wonder "why did they do it this way?"
  3. The result of a real trade-off: there were genuine alternatives and you picked one for specific reasons

If any of the three is missing, skip the ADR. Use the format in ADR-FORMAT.md.

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Мэтта Покока

Ревью по стандартам и спецификации

Проверяет дифф от коммита, ветки или тега по двум осям в параллельных субагентах: записанные стандарты репозитория с базовым набором запахов кода по Фаулеру и исходная спецификация. Для случаев, когда ветку или PR надо сверить с задачей.

Проектирование глубоких модулей

Задаёт общий словарь для глубоких модулей — интерфейс, шов, адаптер, глубина — с тестом на удаление, видами зависимостей и проектированием в нескольких вариантах через субагентов. Для случаев, когда нужно придумать интерфейс модуля или место шва.

Диагностика сложных багов

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

Реализация спецификации по тикетам

Реализует спецификацию и её тикеты на одной интеграционной ветке: по свежему субагенту-исполнителю на тикет в своём worktree, параллельно по графу блокировок, затем ревью и один проход исправлений. Для случаев, когда тикеты из to-tickets уже готовы.

Улучшение архитектуры кодовой базы

Ищет мелкие модули, которые стоит углубить, начиная с чаще всего меняющегося кода, показывает кандидатов в HTML-отчёте со схемами «до и после» и разбирает выбранный вместе с вами. Для случаев, когда код стало трудно тестировать и понимать.

Прототип на выброс

Пишет прототип на выброс под один вопрос о дизайне: кликабельное HTML-демо модели состояний в одном файле или несколько разных вариантов интерфейса на одном маршруте с переключением через URL. Для случаев, когда нужно проверить логику или облик страницы.

Ретро сессии с агентом

Разбирает прошедшую сессию агента по логам и предлагает, что поменять в окружении: указатели в CLAUDE.md, правила линтера, pre-commit и CI, стандарты для ревью, вызовы инструментов. Для случаев, когда агент долго искал нужное или ошибался.

TDD с интеграционными тестами

Ведёт разработку через тесты на публичных интерфейсах: согласует с пользователем швы для тестов, делает по одному циклу red-green на тест, мокает только границы системы, рефакторинг оставляет ревью. Для случаев, когда фичу или баг делают тестами вперёд.

Спецификация из разговора

Собирает из текущего разговора и кода спецификацию с пользовательскими историями, решениями по реализации и тестам и публикует её в трекер с меткой ready-for-agent, без расспросов. Для случаев, когда фичу уже обсудили и её пора записать.

Разбивка спецификации на тикеты

Режет спецификацию, план или разговор на тикеты-трассирующие пули: вертикальные срезы на одну сессию агента со связями блокировки, и публикует их файлами или задачами в трекере. Для случаев, когда работа не влезает в одну сессию.

Триаж задач и PR

Разбирает входящие задачи и внешние PR в трекере: ставит категорию и состояние, ищет готовый код и прошлые отказы, воспроизводит баги и пишет бриф для агента. Для случаев, когда мейнтейнер разгребает поток задач и PR.

Карта для большой работы

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

Bash-мастер для ручных шагов

Пишет интерактивный bash-скрипт, который ведёт человека по ручным шагам: открывает нужные страницы, принимает ключи и пишет их в .env и секреты GitHub. Для случаев, когда настройка сервисов или миграция требует действий, которые агент сам не сделает.

Защита от опасных git-команд в Claude Code

Ставит в Claude Code хук PreToolUse, который останавливает типовые формы git push, reset --hard, clean -f, branch -D и отката всего дерева, для одного проекта или для всех, и проверяет его. Для случаев, когда нужна страховка от того, что агент сам запушит или сотрёт работу.

Перевод тестов на shoehorn

Заменяет as и as unknown as в тестах на TypeScript на fromPartial и fromAny из @total-typescript/shoehorn, добавляет импорты и запускает проверку типов. Для случаев, когда тесты собирают объекты целиком или обманывают компилятор приведениями.

Настройка pre-commit хуков

Ставит Husky и lint-staged в Node-репозиторий: каждый коммит прогоняет Prettier по staged-файлам, проверку типов и тесты; учитывает менеджер пакетов и делает первый коммит через хук. Для случаев, когда в репозитории нет проверок при коммите.

Допрос плана

Допрашивает пользователя о плане раундами пронумерованных вопросов с рекомендуемым ответом, факты ищет сам через субагентов и не останавливается, пока остаются допущения. Для случаев, когда план надо проверить на прочность до начала работы.

Обучение новой теме

Ведёт курс по теме в текущей папке на много сессий: цель, проверенные источники, короткие HTML-уроки с тестами, шпаргалки и записи о выученном. Для случаев, когда тему нужно освоить всерьёз, а не получить один ответ.

Опросник для решения

Составляет Markdown-опросник для человека, у которого есть нужные знания, спросив только, кому он и какие ответы нужны; важные вопросы идут первыми. Для случаев, когда решение упирается в факты от другого человека.

Тексты для агентов: скиллы и AGENTS.md

Даёт правила для текстов, которые читает агент: описание скилла как указатель, что держать в файле и что выносить, критерии готовности, опорные слова и чистка. Для случаев, когда пишете или правите скилл, AGENTS.md или CLAUDE.md.