Decision log для смертных (ADR без боли) Если спор повторяется - значит, решения не было. Был просто созвон.
Что такое decision log (по-людски): 1 страница, где мы фиксируем что решили, почему так, и кто отвечает. Не роман. Не протокол. Артефакт памяти.
Зачем он мне как PM:
- перестаёт крутиться карусель «а почему мы не выбрали вариант Б?»
- новичкам не надо пересказывать историю проекта в трёх тредах
- через месяц понятно, почему реализация такая, а не “как в идеале”
Когда писать:
- спорили больше часа → есть развилка → оформили в decision log.
- любое решение, влияющее на деньги/скорость/качество/архитектуру.
Где хранить: В том, чем пользуется команда каждый день, ваще по барабану, единственное, чтобы к пространству был доступ у всех заинтересованных Главное — единое место + единый шаблон.
Шаблон (1 страница): Заголовок: [Коротко о чем решение] Дата/Владелец: [ДД.ММ.ГГ/Имя] Контекст: [1-3 предложения, почему обсуждаем] Варианты: [A,B,C - по одной строке + плюсы/минусы] Решение: [выбрали X] Почему: [2-3 причины, почему X>остальное] Импакт: [на скорость/качество/стоимость] Риски и как снимаем: [по пунктам] Переоценка: [триггер/дата, когда проверим решение] Ссылки: [PR, задачи, исследования] Мини-пример: Заголовок: Логин через SMS или Telegram Login Контекст: MVP, хотим сократить friction Варианты: A) SMS — привычно, но дорого; B) TG Login — дешево, но нужна привязка к Telegram Решение: B (TG Login) Почему: быстрее внедряем, цена ≈ 0 ₽, для целевой аудитории ок Импакт: time-to-market −2 недели Риски: часть аудитории без TG → снимаем: fallback на почту в v1.1 Переоценка: NPS и CR регистрации через 4 недели
Да, согласен, что выглядит как лишняя бюрократия + еще и формализованная, но на самом деле достаточно важная "ветка" для сохранения контекста продукта
