Чому рішення губляться
Команда прийняла рішення, але через 3 місяці змінюються люди або контекст — і дискусія починається заново. ADR (Architecture Decision Record) — короткий документ, який пояснює “чому так”.
1) Структура ADR
- Контекст: проблема і обмеження.
- Рішення: що обрали і чому.
- Альтернативи: що розглядали.
- Наслідки: що це означає для коду/команди.
2) ADR має жити поруч з кодом
Зберігай ADR у репозиторії (docs/adr). Тоді він проходить review, має історію змін і не “вмирає” в чатах.
3) Коли писати ADR
- Нова архітектурна межа (модулі, сервіси).
- Вибір БД/черг/кешу/провайдера.
- Безпека і комплаєнс: logging, PII, retention.
Підсумок
ADR — це мінімальна документація, яка зберігає “контекст рішень”. Вона прискорює розвиток і зменшує кількість повторних дискусій.