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.
“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.”
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.
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.
DOCUMENTED COMMAND
npx skills add https://github.com/mattpocock/skills/tree/c55ee46073ed923f86ce59a5eb3b6d895095d1b7 --skill domain-modeling --skill setup-matt-pocock-skillsCopying 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.
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/domain-modeling/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/domain-modeling/ADR-FORMAT.md
Supports: review, limitations, install, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/domain-modeling/CONTEXT-FORMAT.md
Supports: review, limitations, install, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/SKILL.md
Supports: review, limitations, install, access
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
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
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
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/issue-tracker-local.md
Supports: review, limitations, install, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/triage-labels.md
Supports: review, limitations, install, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/README.md
Supports: install, compatibility, access, license
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/LICENSE
Supports: license, access.cost
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md
Supports: install
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/git.ts
Supports: install
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/source-parser.ts
Supports: install