From bd8e81baafe43e3e4a3e06f0d256da595edcdeca Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 13 Aug 2026 08:13:05 +0000 Subject: [PATCH 1/4] domain-modeling: trigger on CONTEXT.md / ADR writes explicitly The description only fired on conversational framing ("pin down terminology", "record a decision"). Add explicit triggers for writing or editing a CONTEXT.md or an ADR directly, so the skill loads even when the file operation itself is the request rather than the underlying activity. Co-Authored-By: Claude Sonnet 5 --- skills/engineering/domain-modeling/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/engineering/domain-modeling/SKILL.md b/skills/engineering/domain-modeling/SKILL.md index d0f7e1a..d3a4c1c 100644 --- a/skills/engineering/domain-modeling/SKILL.md +++ b/skills/engineering/domain-modeling/SKILL.md @@ -1,6 +1,6 @@ --- name: domain-modeling -description: Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model. +description: Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, write or edit a CONTEXT.md, record or edit an ADR, or when another skill needs to maintain the domain model. --- # Domain Modeling From f02e2ed3624d031272f8547742d23bf6bca8b072 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 13 Aug 2026 08:14:55 +0000 Subject: [PATCH 2/4] chore: add changeset for domain-modeling trigger update Co-Authored-By: Claude Sonnet 5 --- .changeset/domain-modeling-trigger-context-adr.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 .changeset/domain-modeling-trigger-context-adr.md diff --git a/.changeset/domain-modeling-trigger-context-adr.md b/.changeset/domain-modeling-trigger-context-adr.md new file mode 100644 index 0000000..2ba896f --- /dev/null +++ b/.changeset/domain-modeling-trigger-context-adr.md @@ -0,0 +1,5 @@ +--- +"mattpocock-skills": patch +--- + +domain-modeling: trigger on writing or editing a CONTEXT.md or an ADR directly, not just when the request is framed as "pin down terminology" or "record a decision". From e12e7ec6a749d5ad5e8051db18a46baf6818bb4a Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 13 Aug 2026 08:21:20 +0000 Subject: [PATCH 3/4] domain-modeling: reword terminology trigger to "discussing codebase terminology" "Pin down domain terminology or a ubiquitous language" was stiff and leaned on DDD jargon. Swap it for the plainer, more naturally-phrased "discussing codebase terminology". Co-Authored-By: Claude Sonnet 5 --- .changeset/domain-modeling-trigger-context-adr.md | 2 +- skills/engineering/domain-modeling/SKILL.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.changeset/domain-modeling-trigger-context-adr.md b/.changeset/domain-modeling-trigger-context-adr.md index 2ba896f..75397bd 100644 --- a/.changeset/domain-modeling-trigger-context-adr.md +++ b/.changeset/domain-modeling-trigger-context-adr.md @@ -2,4 +2,4 @@ "mattpocock-skills": patch --- -domain-modeling: trigger on writing or editing a CONTEXT.md or an ADR directly, not just when the request is framed as "pin down terminology" or "record a decision". +domain-modeling: trigger on discussing codebase terminology and on writing or editing a CONTEXT.md or an ADR directly, replacing the narrower "pin down domain terminology or a ubiquitous language" / "record an architectural decision" phrasing. diff --git a/skills/engineering/domain-modeling/SKILL.md b/skills/engineering/domain-modeling/SKILL.md index d3a4c1c..209750f 100644 --- a/skills/engineering/domain-modeling/SKILL.md +++ b/skills/engineering/domain-modeling/SKILL.md @@ -1,6 +1,6 @@ --- name: domain-modeling -description: Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, write or edit a CONTEXT.md, record or edit an ADR, or when another skill needs to maintain the domain model. +description: Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, recording or editing an ADR, or when another skill needs to maintain the domain model. --- # Domain Modeling From 54bc6b604075c18293d38e9e294a2c96f365f104 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 13 Aug 2026 08:34:35 +0000 Subject: [PATCH 4/4] domain-modeling: drop the "another skill needs to maintain" caveat MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Every skill that delegates to domain-modeling (grill-with-docs, wayfinder, improve-codebase-architecture, triage) already invokes /domain-modeling explicitly by name, so the description never needed to carry that branch — it's the invoking skill's job to say so, not this one's to anticipate it. Co-Authored-By: Claude Sonnet 5 --- .changeset/domain-modeling-trigger-context-adr.md | 2 +- skills/engineering/domain-modeling/SKILL.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.changeset/domain-modeling-trigger-context-adr.md b/.changeset/domain-modeling-trigger-context-adr.md index 75397bd..da0fe9c 100644 --- a/.changeset/domain-modeling-trigger-context-adr.md +++ b/.changeset/domain-modeling-trigger-context-adr.md @@ -2,4 +2,4 @@ "mattpocock-skills": patch --- -domain-modeling: trigger on discussing codebase terminology and on writing or editing a CONTEXT.md or an ADR directly, replacing the narrower "pin down domain terminology or a ubiquitous language" / "record an architectural decision" phrasing. +domain-modeling: trigger on discussing codebase terminology and on writing or editing a CONTEXT.md or an ADR directly, replacing the narrower "pin down domain terminology or a ubiquitous language" / "record an architectural decision" phrasing. Also drops the "another skill needs to maintain the domain model" caveat — that's the invoking skill's job to state explicitly, not this description's. diff --git a/skills/engineering/domain-modeling/SKILL.md b/skills/engineering/domain-modeling/SKILL.md index 209750f..e660e8c 100644 --- a/skills/engineering/domain-modeling/SKILL.md +++ b/skills/engineering/domain-modeling/SKILL.md @@ -1,6 +1,6 @@ --- name: domain-modeling -description: Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, recording or editing an ADR, or when another skill needs to maintain the domain model. +description: 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. --- # Domain Modeling