- Где лежит: код + flow в одном PR; текст — в
src/<domain>/(decisions|flows)/. Ставь ссылку на PR/код в Links.
- Нумерация: глобально
ADR-001, ADR-002, … без дат в имени файла. Храни в src/<domain>/decisions/ADR-xxx-<slug>.md.
- Формат: один экран по шаблону
adr-template.md (Context/Decision/Consequences/Next).
- Статус:
draft → accepted → deprecated → superseded; обновляй при изменении решения.
- Релизы: в релиз-ноте фиксируй, какие ADR перешли в
accepted.
- Возьми
src/adr/adr-template.md.
- Подставь следующий номер
ADR-xxx (смотри соседние ADR) и короткий slug.
- Положи файл в
src/<domain>/decisions/.
- Добавь ссылку в
src/SUMMARY.md и в README домена; обнови релизную заметку при переходе в accepted.