Community코딩 & 개발github.com

mattpocock/domain-modeling

프로젝트의 도메인 모델을 구축하고 개선합니다. 사용자가 도메인 용어나 유비쿼터스 언어를 확정하거나, 아키텍처 결정을 기록하거나, 다른 스킬이 도메인 모델을 유지해야 할 때 사용하세요.

domain-modeling란 무엇인가요?

이 스킬은 프로젝트 전반에 걸쳐 도메인 모델을 능동적으로 구축하고 개선하는 데 사용됩니다. 단순히 기존의 용어집을 읽는 것을 넘어, 용어에 도전하고, 경계 사례 시나리오를 발명하고, 용어가 결정되는 즉시 용어집과 아키텍처 결정 기록(ADR)을 작성하는 적극적인 훈련을 수행합니다. 이 스킬은 단일 컨텍스트(CONTEXT.md) 또는 다중 컨텍스트(CONTEXT-MAP.md) 프로젝트 구조를 지원하며, 코드와의 불일치를 찾아내고, 모호한 용어를 정제하며, 드물게 하드한 결정에 대해서만 ADR 작성을 제안합니다. 주로 Claude Code와 같은 AI 에이전트 도구에서 사용되며, 세션 중에 사용자가 언급하는 용어가 기존 용어집과 충돌하는 경우 즉시 지적하고, 모호한 용어에 대해 정확한 표준 용어를 제안하며, 구체적인 시나리오를 통해 도메인 관계를 검증합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/engineering/domain-modeling

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

도메인 모델링

설계 과정에서 프로젝트의 도메인 모델을 능동적으로 구축하고 개선하세요. 이는 능동적인 훈련입니다. 용어에 도전하고, 경계 사례 시나리오를 발명하고, 용어가 구체화되는 즉시 용어집과 결정을 기록하는 것입니다. (단순히 CONTEXT.md를 읽어 어휘를 파악하는 것은 이 스킬이 아닙니다. 그건 어떤 스킬도 할 수 있는 한 줄짜리 습관입니다. 이 스킬은 모델을 변경할 때 사용하는 것이지, 단순히 소비할 때가 아닙니다.)

파일 구조

대부분의 저장소는 단일 컨텍스트를 가집니다:

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

루트에 CONTEXT-MAP.md가 존재하면 저장소에 여러 컨텍스트가 있는 것입니다. 맵은 각 컨텍스트가 어디에 있는지 가리킵니다:

/
├── CONTEXT-MAP.md
├── docs/
│   └── adr/                          ← 시스템 차원의 결정
├── src/
│   ├── ordering/
│   │   ├── CONTEXT.md
│   │   └── docs/adr/                 ← 컨텍스트별 결정
│   └── billing/
│       ├── CONTEXT.md
│       └── docs/adr/

파일은 작성할 내용이 있을 때만 게으르게(lazily) 생성하세요. CONTEXT.md가 없으면 첫 번째 용어가 결정될 때 생성합니다. docs/adr/가 없으면 첫 번째 ADR이 필요할 때 생성합니다.

세션 중

용어집에 도전하기

사용자가 CONTEXT.md의 기존 용어와 충돌하는 용어를 사용하면 즉시 지적하세요. "용어집은 '취소'를 X로 정의하고 있지만, 당신은 Y를 의미하는 것 같습니다 — 둘 중 무엇입니까?"

모호한 언어 정제하기

사용자가 모호하거나 과부하된 용어를 사용하면 정확한 표준 용어를 제안하세요. "'계정'이라고 말씀하시는데, 고객(Customer)을 의미하나요 아니면 사용자(User)를 의미하나요? 이 둘은 다른 것입니다."

구체적인 시나리오 논의하기

도메인 관계가 논의될 때, 구체적인 시나리오로 스트레스 테스트하세요. 경계 사례를 탐색하고 사용자가 개념 간의 경계를 정확하게 설명하도록 강제하는 시나리오를 발명하세요.

코드와 상호 참조하기

사용자가 무언가의 작동 방식을 말할 때 코드가 동의하는지 확인하세요. 모순을 발견하면 표면화하세요: "코드는 전체 주문을 취소하지만, 방금 부분 취소가 가능하다고 말씀하셨습니다 — 어느 것이 맞습니까?"

CONTEXT.md 인라인 업데이트하기

용어가 결정되면 바로 그 자리에서 CONTEXT.md를 업데이트하세요. 일괄 처리하지 말고 발생하는 대로 캡처하세요. CONTEXT-FORMAT.md의 형식을 사용하세요.

CONTEXT.md에는 구현 세부 사항이 전혀 없어야 합니다. CONTEXT.md를 명세서, 스크래치 패드, 또는 구현 결정 저장소로 취급하지 마세요. 용어집 그 이상도 이하도 아닙니다.

ADR은 드물게 제공하기

다음 세 가지가 모두 참일 때만 ADR 작성을 제안하세요:

  1. 되돌리기 어려운 경우 — 나중에 마음이 바뀌는 데 드는 비용이 의미 있는 경우
  2. 맥락 없이 놀라운 경우 — 미래의 독자가 "왜 이렇게 했지?"라고 궁금해할 경우
  3. 실제 트레이드오프의 결과인 경우 — 진정한 대안이 있었고 특정 이유로 하나를 선택한 경우

세 가지 중 하나라도 빠지면 ADR을 건너뛰세요. ADR-FORMAT.md의 형식을 사용하세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

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.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

관련 스킬