Was ist ein Architecture Decision Record?

Ein Architecture Decision Record (ADR) ist ein Dokument, das eine wichtige getroffene Architekturentscheidung zusammen mit ihrem Kontext und ihren Konsequenzen festhält.

Eine Architekturentscheidung (architecture decision, AD) ist eine Entwurfsentscheidung der Software, die eine wesentliche Anforderung adressiert.

Ein Architekturentscheidungsprotokoll (architecture decision log, ADL) ist die Sammlung aller ADRs, die für ein bestimmtes Projekt (oder eine Organisation) erstellt und gepflegt werden.

Eine architektonisch bedeutsame Anforderung (architecturally-significant requirement, ASR) ist eine Anforderung, die einen messbaren Einfluss auf die Architektur eines Softwaresystems hat.

All dies gehört zum Thema Architekturwissensmanagement (architecture knowledge management, AKM).

Ziel dieses Dokuments ist es, einen schnellen Überblick über ADRs zu geben, darüber, wie man sie erstellt, und wo man weitere Informationen findet.

Abkürzungen:

• AD: Architekturentscheidung

• ADL: Architekturentscheidungsprotokoll

• ADR: Architecture Decision Record

• AKM: Architekturwissensmanagement

• ASR: architektonisch bedeutsame Anforderung