Простыми словами
Представьте короткую карточку для важного архитектурного выбора: проблема, варианты, принятое решение и последствия. ADR хранит историю решений рядом с системой, поэтому новые участники видят не только что сделано, но и почему.
Механизм действия
Сначала проверяют, есть ли исходное условие из определения. Затем смотрят, как оно влияет на стимулы, правила, информацию и поведение участников. Если эту связь не удаётся наблюдать, принцип не стоит использовать как готовое объяснение.
Пример в работе
Применять локальное решение без проверки контекста, ограничений и вторичных последствий.
Сначала определить механизм, затем выбрать минимальное изменение и измерить результат.
Ограничения
«Architecture Decision Record» объясняет только часть происходящего в области «Организации и метрики». Сам принцип не говорит, насколько сильным будет эффект в вашем случае, и не заменяет измерения. При другом масштабе, среде или временном горизонте результат может отличаться.
Источник
Michael Nygard. Documenting Architecture Decisions. 2011.