Architecture Decision Records (ADR)
Актуально на: 2026-07-23
Короткие записи о значимых решениях: контекст → решение → последствия. Не устаревают, потому что фиксируют момент, а не текущее состояние. Заменяют разрастающиеся *_AUDIT.md.
Когда заводить ADR
- Выбор между несколькими вариантами архитектуры/подхода
- Решение, о котором через полгода спросят «а почему так?»
- Отказ от очевидного варианта в пользу неочевидного
Как
- Скопируй шаблон ниже в файл
NNNN-краткое-название.md(номер по порядку). - Заполни. Держи коротко — одна страница.
- Не переписывай принятые ADR. Изменил решение — заводи новый и ставь
Заменяет: NNNN.
Шаблон
# NNNN. Название решения
- Статус: предложено | принято | заменено (→ NNNN)
- Дата: YYYY-MM-DD
## Контекст
Что за проблема, какие ограничения.
## Решение
Что решили и почему именно так.
## Последствия
Что это даёт и чем платим. Что становится сложнее.