ADR-XXXX: <краткое утверждение решения>
- Status: Proposed | Accepted | Deprecated | Superseded-by-ADR-YYYY
- Deciders: Jean, <остальные участники>
- Date: YYYY-MM-DD
- Supersedes: ADR-YYYY (если applicable)
- Related SOT slice: <ссылка на раздел в SOURCE_OF_TRUTH.md>
Context
Заголовок раздела «Context»Что мы знаем? Почему этот вопрос возник сейчас? Какие ограничения (срок, бюджет, команда, регулятор) формируют решение? Ссылки на данные / спеки / предыдущие обсуждения.
Decision
Заголовок раздела «Decision»Что решили — конкретно, измеримо, без вежливых формулировок. Включая что именно не делаем.
Consequences
Заголовок раздела «Consequences»- Plus: что становится проще, яснее, безопаснее, быстрее.
- Minus: какой trade-off приняли, что теряем.
- Следующие шаги: что теперь нужно сделать / обновить / построить вследствие этого решения.
Alternatives considered
Заголовок раздела «Alternatives considered»Какие варианты рассматривали, почему отвергнуты. По каждому — 1-2 предложения.
Related
Заголовок раздела «Related»- SOT:
SOURCE_OF_TRUTH.md§<раздел> - ADRs: ADR-XXXX, ADR-YYYY
- Specs:
docs/superpowers/specs/<file> - External: ссылки на GDC, papers, whitepapers if relevant