К основному содержанию
скилл CX Codex

domain-model — скилл для Claude Code: уточнять модель домена

Скилл domain-model для Claude Code проверяет термины по глоссарию, тестирует границы сценариями и фиксирует решения в CONTEXT.md и ADR. Он поддерживает изменение самой модели домена.

Apache-2.0 ★ 173 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sammcj/agentic-coding --skill domain-model -a claude-code
Открыть на GitHub

Что делает domain-model

Скилл помогает двигать домен-моделирование вперёд в процессе проектирования. Он не просто читает CONTEXT.md — он активно бросает вызов терминам, ловит противоречия между тем, что вы говорите, и тем, что в коде, придумывает граничные сценарии. Когда термин уточняется, скилл сразу записывает его в глоссарий. Когда решение оказывается трудно развернуть обратно, имеет смысл и не очевидно с первого взгляда — пишет ADR.

Структура хранения зависит от сложности проекта. Если один контекст — CONTEXT.md в корне рядом с docs/adr/. Если контекстов много, сверху CONTEXT-MAP.md указывает на каждый. Файлы создаются по мере необходимости: первый термин — создаётся CONTEXT.md, первое решение — создаётся папка docs/adr/.

Скилл работает внутри сессии: вызывает вас, если новый термин конфликтует с глоссарием, предлагает точное имя вместо размытого, тестирует пример на коде. CONTEXT.md остаётся чистым словарём без деталей реализации.

Какие задачи решает

  • защитить домен от размытых и перегруженных терминов
  • синхронизировать глоссарий с кодом в реальном времени
  • документировать архитектурные решения в момент, когда они кристаллизуются
  • тестировать границы модели на конкретных сценариях
  • держать в памяти, что есть в CONTEXT.md, и сверять против неё

Примеры запросов агенту

  • Помоги мне разобраться с терминами заказов: что такое cancellation, а что refund? Какая разница?
  • В коде Order может быть частично отменён, но в моём описании я говорил про полную отмену. Дай мне сценарии, где это ломается.
  • Обнови CONTEXT.md: я решил, что Account это не Customer, а User, потому что Account может принадлежать нескольким User.

Как установить domain-model

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill domain-model -a claude-code

2Вручную: положить файлы

~/.claude/skills/domain-model/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/domain-model/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о domain-model

Как установить domain-model в Claude Code?

Запустите npx skills add sammcj/agentic-coding --skill domain-model -a claude-code, затем откройте ~/.claude/skills/domain-model/SKILL.md.

В чём разница между этим скиллом и просто прочитать CONTEXT.md?

Скилл не просто читает глоссарий — он активно проверяет ваши предположения, ловит противоречия в коде, придумывает граничные сценарии и записывает решения в момент, когда они кристаллизуются. Просто читать CONTEXT.md можно любому скиллу в одну строку.

Когда стоит писать ADR?

Только когда все три верны: решение трудно развернуть обратно, его нечевидность будет мучить будущего читателя, и были реальные альтернативы. Если хотя бы один пункт упал — пропустите ADR.

Исходный текст

SKILL.md · Apache-2.0
---
name: domain-model
description: Actively build and sharpen a project's domain model - challenge terms against the glossary, stress-test boundaries with scenarios, cross-reference against the code, and record the glossary (CONTEXT.md) and decisions (ADRs) the moment they crystallise. Use when you are changing the domain model itself, pinning down a ubiquitous language, or recording an architectural decision.
disable-model-invocation: true
metadata:
  source: https://github.com/mattpocock/skills
---

# Domain modelling

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_ `CONTEXT.md` for vocabulary is not this skill; that is a one-line habit any skill can do. This skill is for when you are changing the model, not just consuming it.

## File structure

Most repos have a single context:

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

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

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

Create files lazily - only when you have something to write. If no `CONTEXT.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 `CONTEXT.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 CONTEXT.md inline

When a term is resolved, update `CONTEXT.md` right there. Don't batch these up - capture them as they happen. Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md).

`CONTEXT.md` should be totally devoid of implementation details. Do not treat `CONTEXT.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](./ADR-FORMAT.md).

© sammcj · Apache-2.0 · sammcj/agentic-coding

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
domain-model-boundaries-mapper patricio0312rev Скилл domain-model-boundaries-mapper анализирует архитектуру проекта по принципам Domain-Driven Design: находит доменные модули, границы ответственности и зависимости. Помогает спланировать разделение связанных компонентов. CX Codex +1 270установок domain-architect pproenca Скилл domain-architect определяет бизнес-домены в Swift-проекте через возможности продукта, а не через имена папок. Строит карту слоёв каждого домена — от типов до UI. CX Codex +1 249установок grill-with-docs akillness Скилл grill-with-docs для Claude Code проводит разбор плана или дизайна и создаёт ADR с записями глоссария. Запускается фразами про разбор и документирование. CX Codex +1 366установок m09-domain actionbook Скилл m09-domain для Claude Code задаёт правила предметно-ориентированного проектирования на Rust: моделирует сущности, агрегаты и объекты-значения с учётом системы владения. CX Codex +1 3 700установок model serpro69 Скилл model собирает по коду доменный справочник: глоссарий понятий и страницу расхождений. На выходе даёт список вопросов, которые должен закрыть человек. CX Codex +1 ★ 155звёзд репо layers-domain jamiemill Скилл layers-domain помогает зафиксировать терминологию, разногласия и границы контекстов предметной области до проектирования интерфейса. CX Codex +1 2 000установок

Из того же набора73

Весь набор →
openspec-bootstrap Скилл openspec-bootstrap настраивает OpenSpec в репозитории: создаёт схему, конфигурацию и проверяет их. Нужен при первом запуске или изменении openspec/config.yaml. CX Codex +1 ★ 173звёзд репо self-review Скилл self-review запускает критическую самопроверку изменений. Подходит и для мелких правок, и для делегирования ревью субагенту. CX Codex +1 ★ 173звёзд репо writing-fragments Скилл writing-fragments для Claude Code собирает из беседы фрагменты будущей статьи и сохраняет их в одном Markdown-файле. CX Codex +1 ★ 173звёзд репо code-simplification Скилл code-simplification для Claude Code находит сложные участки и помогает упростить код при ревью и рефакторинге. Он подключается к задачам на читаемость и сокращение лишних абстракций. CX Codex +1 ★ 173звёзд репо critical-reviewer Субагент critical-reviewer проверяет недавние изменения в коде, документах, планах и дизайне, затем выдаёт приоритетные замечания. Он пригодится для критического самообзора перед тем, как вы внесёте исправления. CX Codex ★ 173звёзд репо quick-researcher Субагент quick-researcher для Claude Code извлекает из веба опубликованные факты и возвращает каждый со ссылкой на источник. Ищет ответы и заполняет списки цен, квот, лимитов и версий. CX Codex ★ 173звёзд репо ambitious-model-use Скилл ambitious-model-use переосмысляет задачу перед тем, как её решать. Вместо того чтобы просто улучшить промпт, анализирует реальный результат, который вам нужен, и предлагает глубже копать в данные или привлечь смежные области. CX Codex +1 ★ 173звёзд репо demo-recorder Скилл demo-recorder записывает скриптовые видеодемо веб-приложений через headless Chromium в 3K 60fps и накладывает озвучку через Cloney. CX Codex +1 ★ 173звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой