Формат ADR-lite
Каждое решение следует компактной структуре:
| Секция | Описание |
|---|---|
| Контекст | Почему это решение нужно |
| Решение | Что было решено |
| Почему | Одна самая сильная причина |
| Вместо чего | Макс. 3 альтернативы |
| Последствия | Затронутые области и эффекты |
Для сложных решений расширенный формат добавляет секцию Компромиссы.
Умные фичи
Авто-определение альтернатив
Если ты указал только решение, AI определит 1-2 типичные альтернативы:
/note-decide Берём PostgreSQL для user-сервисаAI добавит: Вместо MongoDB, MySQL — потому что это типичные альтернативы при выборе базы данных.
Цепочки решений
Система ищет существующие decision-заметки. Если новое решение приходит на смену старому — создаётся ссылка «Заменяет»:
Заменяет: «Берём MongoDB для user-сервиса» (10 фев)Так строится история решений, которую можно проследить назад.
Определение дубликатов
Перед созданием новой заметки /note-decide ищет связанные прошлые решения и предупреждает, если похожее уже есть.
Правила для заголовков
Хорошие заголовки — actionable и конкретные:
- «Берём JWT для auth» (не «Авторизация»)
- «Деплой на Fly.io» (не «Деплой»)
- «Переход с REST на GraphQL» (не «API»)
Когда /note-decide
Используй, когда нужно зафиксировать почему ты что-то выбрал, а не только что ты выбрал. Журнал решений становится бесценным, когда:
- Новый человек в команде спрашивает «почему мы сделали это так?»
- Нужно вернуться к решению через несколько месяцев
- Хочется отследить, как эволюционировала архитектура