Запись об архитектурном решении (ADR) Architecture Decision Record (ADR)
Простыми словами
ADR закрывает вопрос «почему тогда решили именно так»: без записанного мотива преемник вынужден либо принять решение, которое уже пора менять, потому что контекст изменился, либо изменить его, не понимая последствий. Отличие от обычной архитектурной документации — в единице записи: ADR фиксирует не состояние системы, а ОДНО решение с его контекстом и последствиями, и потому живёт коротким шаблоном Найгарда. Два поля шаблона прямо отсылают к классификации разд. 10.2: «Decision type» — про обратимость (дверь в одну сторону против двери в обе), «Decision scope» — про поверхность влияния по осям рис. 10-1. Модальность стандарта тут мягкая: ADR назван «гибким и лёгким способом» это делать, а не обязательной формой.
Примеры
«When someone does not understand the rationale of a decision the choice must be made to either accept it, though it should be changed because the context has changed, or change it without understanding the consequences.»
Open Agile Architecture™ Standard, Version 2.0 (C262), разд. 10.3 — обоснование Найгарда
«Is the decision easily reversible or not, and why?»
Open Agile Architecture™ Standard, Version 2.0 (C262), разд. 10.3 — шаблон ADR
«The sacrificial architecture decision should be documented using an ADR.»
Open Agile Architecture™ Standard, Version 2.0 (C262), разд. 10.5 — жертвенная архитектура сайта MVP
Определение из первоисточника
дословная выпискаTherefore, it is important to document the motivations behind past decisions. An Architecture Decision Record (ADR) provides an Agile and lightweight way of doing this.
Поэтому важно фиксировать побуждения, стоявшие за прошлыми решениями. Запись об архитектурном решении (ADR) даёт для этого гибкий и лёгкий способ.
ИсточникThe Open Group Open Agile Architecture™ Standard, Version 2.0. The Open Group, April 2026, C262, ISBN 1-957866-76-5
Основные параметры
Атрибуты этой сущности по справочнику источника.
- Шаблон разд. 10.3 (по Nygard): ADR Title, Status (proposed, accepted, rejected, deprecated, superseded), Context, Decision, Decision scope (какие сегменты предприятия и его систем затронуты), Decision type (легко ли решение обратить и почему), Consequences.
Связанные понятия
Опишите архитектуру своей компании в Storm
Реестр процессов, архитектурное рабочее пространство, связи между системами и процессами — те самые артефакты, только про вашу организацию.
Это же в StormАрхитектура систем и интеграцийРеестр процессовКарта бизнес-способностей