summaryrefslogtreecommitdiff
path: root/docs/agents/domain.md
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.