From 3e251ea79238fe4fbf4924f0e5620028e218b442 Mon Sep 17 00:00:00 2001 From: Test Date: Wed, 22 Apr 2026 12:10:11 +0100 Subject: [PATCH] Clarify guidance on `CONTEXT.md` updates: emphasize meaningful terms for domain experts and avoid coupling to implementation details. --- domain-model/SKILL.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/domain-model/SKILL.md b/domain-model/SKILL.md index ca627ca..afc63fa 100644 --- a/domain-model/SKILL.md +++ b/domain-model/SKILL.md @@ -68,6 +68,8 @@ When the user states how something works, check whether the code agrees. If you 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). +Don't couple `CONTEXT.md` to implementation details. Only include terms that are meaningful to domain experts. + ### Offer ADRs sparingly Only offer to create an ADR when all three are true: