--- title: "Matt Pocock Domain Modeling: review, setup & limitations · Undominated.ai" canonical: https://undominated.ai/skills/mattpocock-domain-modeling/ description: "Builds a project glossary and short architecture decision records while testing domain terms against code and concrete edge cases." --- # Matt Pocock Domain Modeling: review, setup & limitations · Undominated.ai > Builds a project glossary and short architecture decision records while testing domain terms against code and concrete edge cases. [← Explore all skills](/skills/) RESEARCH AND DOCUMENTATION / Matt Pocock # Matt Pocock Domain Modeling Builds a project glossary and short architecture decision records while testing domain terms against code and concrete edge cases. See setup guidance ↓Original source ↗ SOURCE REVIEW Reviewed 2026-09-21 Evidence 14 linked sources Publisher Matt Pocock Licence MIT ↗ Revision c55ee46073ed Read what was—and wasn’t—checked ↓ “Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR.” Matt Pocock · upstream description ↗ Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - Distinguishes canonical domain terms from implementation notes and uses conflicting examples to expose overloaded language. - Keeps decision records selective: they need a consequential choice, genuine alternatives and a reason a future reader would otherwise miss. ### A good fit for - Agreeing terminology before a feature specification - Recording why a costly architecture or domain choice was made ### Weigh up before choosing - The root and bounded-context instructions do not fully agree on glossary and ADR placement; agree the target paths and numbering convention first. - It writes resolved terms immediately and is opinionated about naming. Existing documentation conventions and review ownership still govern. 02 / THE REVIEW RECORD ## What we actually inspected. Source review has boundaries. A clear record is more useful than a “safe” badge. ### Material inspected - skills/engineering/domain-modeling/ADR-FORMAT.md - skills/engineering/domain-modeling/CONTEXT-FORMAT.md - skills/engineering/domain-modeling/SKILL.md - skills/engineering/domain-modeling/agents/openai.yaml - skills/engineering/setup-matt-pocock-skills/SKILL.md - skills/engineering/setup-matt-pocock-skills/agents/openai.yaml - skills/engineering/setup-matt-pocock-skills/domain.md - skills/engineering/setup-matt-pocock-skills/issue-tracker-github.md - skills/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md - skills/engineering/setup-matt-pocock-skills/issue-tracker-local.md - skills/engineering/setup-matt-pocock-skills/triage-labels.md - README.md (installation, compatibility and licence sections) - LICENSE ### Our findings - The definition and both format references were inspected together; they separate glossary entries, context maps and decision rationale. - Single-context guidance is clearer than the multi-context path rules. Concurrent ADR authors also need coordination over filenames. ### Not established by this review - No project glossary or ADR was generated. - Domain correctness and team adoption were not evaluated. The review applies to the material and revision named here. A newer upstream release can change its behavior. 03 / PUT IT TO WORK ## Add a skill to your workflow. Upstream setup instructions ↗ DOCUMENTED COMMAND npx skills add https://github.com/mattpocock/skills/tree/c55ee46073ed923f86ce59a5eb3b6d895095d1b7 --skill domain-modeling --skill setup-matt-pocock-skills Copy command ↗ Copying does not execute this command. It may retrieve a newer version than the reviewed source. - Install the complete directory so CONTEXT-FORMAT.md and ADR-FORMAT.md remain available. - Read the publisher setup instructions, then identify the existing glossary and ADR locations before asking the agent to update them. - The publisher recommends setup-matt-pocock-skills as a separate companion. Review its repository documentation and issue-tracker changes before running it. - Choose the intended host and project scope in the installer. The source revision is pinned; the installer itself is not executed or version-pinned by this review. ### Before you start - Node.js/npm and git for the documented Skills installer - An agent with repository read/write access - A project owner who can resolve domain decisions; follow the publisher setup guidance for the engineering suite - The separately selected setup companion establishes the repository conventions; review its proposed AGENTS.md or CLAUDE.md and docs/agents edits before accepting them. ### Compatibility Claude Code · Codex ### Repository documentation - Read code and existing domain documentation - Create or update glossary, context-map and ADR Markdown files ### Cost model MIT-licensed instructions; agent usage and any separately chosen collaboration tools have their own costs. 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - Skill definition at reviewed revision ↗ Checked 2026-09-21 https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/domain-modeling/SKILL.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access - Reviewed reference or helper: ADR-FORMAT.md ↗ Checked 2026-09-21 https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/domain-modeling/ADR-FORMAT.md Supports: review, limitations, install, access - Reviewed reference or helper: CONTEXT-FORMAT.md ↗ Checked 2026-09-21 https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/domain-modeling/CONTEXT-FORMAT.md Supports: review, limitations, install, access - Reviewed reference or helper: skills/engineering/setup-matt-pocock-skills/SKILL.md ↗ Checked 2026-09-21 https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/SKILL.md Supports: review, limitations, install, access - Reviewed reference or helper: skills/engineering/setup-matt-pocock-skills/domain.md ↗ Checked 2026-09-21 https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/domain.md Supports: review, limitations, install, access - Reviewed reference or helper: skills/engineering/setup-matt-pocock-skills/issue-tracker-github.md ↗ Checked 2026-09-21 https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/issue-tracker-github.md Supports: review, limitations, install, access - Reviewed reference or helper: skills/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md ↗ Checked 2026-09-21 https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md Supports: review, limitations, install, access - Reviewed reference or helper: skills/engineering/setup-matt-pocock-skills/issue-tracker-local.md ↗ Checked 2026-09-21 https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/issue-tracker-local.md Supports: review, limitations, install, access - Reviewed reference or helper: skills/engineering/setup-matt-pocock-skills/triage-labels.md ↗ Checked 2026-09-21 https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/triage-labels.md Supports: review, limitations, install, access - Publisher installation, compatibility and licensing guidance ↗ Checked 2026-09-21 https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/README.md Supports: install, compatibility, access, license - Upstream licence at reviewed revision ↗ Checked 2026-09-21 https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/LICENSE Supports: license, access.cost - Skills installer: source formats and repeated skill selection ↗ Checked 2026-09-21 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md Supports: install - Skills installer: full commit SHA checkout support ↗ Checked 2026-09-21 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/git.ts Supports: install - Skills installer: tree revision and subdirectory parsing ↗ Checked 2026-09-21 https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/source-parser.ts Supports: install KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### Matt Pocock Grilling ↗ Interviews the user through dependency-ordered decisions before the agent acts on a plan or idea.](/skills/mattpocock-grilling/)[### Anthropic Documentation Coauthoring ↗ Guides a human and agent through audience discovery, section-by-section drafting and a separate-reader review of a substantial document.](/skills/anthropics-doc-coauthoring/)[### Microsoft Docs Research ↗ Finds current Microsoft documentation with task-specific queries and retrieves full pages when excerpts are insufficient.](/skills/microsoft-microsoft-docs/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)