# 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.