Configure Wayfinder agent workflows

docs/agents/domain.md

@@ -0,0 +1,69 @@
+# Domain Docs
+
+Aleksandr-test uses a single-context documentation layout.
+
+It is an independent test project for learning Wayfinder and AI-agent
+workflows. Do not import the Amazon domain context or decisions from
+Andrey's project or any other project.
+
+## Before exploring, read these
+
+- GLOSSARY.md at the repository root, if it exists.
+- ADRs in docs/adr/ that concern the area being explored.
+
+If these files do not exist, proceed silently. Do not flag their absence
+or propose creating empty files upfront.
+
+The domain-modeling skill creates documents lazily when terms or
+decisions are actually resolved.
+
+## File structure
+
+```text
+/
+├── GLOSSARY.md
+├── docs/
+│   └── adr/
+│       ├── 0001-slug.md
+│       └── 0002-slug.md
+└── ...
+```
+
+Create GLOSSARY.md only when the first project-specific term is resolved.
+Create docs/adr/ only when the first qualifying ADR is needed.
+
+Do not create GLOSSARY-MAP.md or per-context documentation as part of
+this single-context setup.
+
+## Use the glossary's vocabulary
+
+When output names a domain concept in an issue, proposal, hypothesis,
+or test, use the term defined in GLOSSARY.md.
+
+Avoid synonyms that the glossary explicitly rejects.
+
+If a needed concept is missing, reconsider whether it belongs to this
+project or is a real gap to resolve with domain-modeling.
+
+Keep the glossary limited to project-specific terms. It is not a spec,
+an implementation guide, or a scratch pad.
+
+Use the installed domain-modeling/GLOSSARY-FORMAT.md when writing entries.
+
+## Architectural decisions
+
+Read relevant ADRs before proposing changes.
+
+If a proposal contradicts an existing ADR, surface the conflict
+explicitly and explain why reopening the decision may be appropriate.
+
+Offer an ADR only when all three conditions hold:
+
+1. The decision is meaningfully costly to reverse.
+2. A future reader would find it surprising without context.
+3. It results from a real trade-off between alternatives.
+
+Use the installed domain-modeling/ADR-FORMAT.md.
+
+Number ADR files sequentially, starting at 0001 and incrementing the
+highest existing number.