summaryrefslogtreecommitdiff
path: root/docs/agents/domain.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/agents/domain.md')
-rw-r--r--docs/agents/domain.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/docs/agents/domain.md b/docs/agents/domain.md
new file mode 100644
index 0000000..ded5401
--- /dev/null
+++ b/docs/agents/domain.md
@@ -0,0 +1,23 @@
+# Domain docs
+
+This repo uses a single-context domain layout.
+
+## Before exploring the codebase
+
+Read the root `GLOSSARY.md` and any ADRs in `docs/adr/` relevant to
+the work. If either is absent, continue without requesting its creation.
+The domain-modeling skill creates these documents as terms and
+decisions are resolved.
+
+## Vocabulary
+
+Use glossary terms in issue titles, proposals, hypotheses, and tests.
+Respect synonyms the glossary explicitly avoids.
+
+If a needed concept is missing, reconsider whether it belongs in the
+project's vocabulary. Record real gaps for domain-modeling.
+
+## Decisions
+
+If a proposal conflicts with an ADR, identify the ADR and explain why
+the decision should be reconsidered.