blob: ded540115cf8a732ecb90a429a9f6ae727a0d52c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
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.
|