Design-PatternInfrastructureTechnical Excellence

Architecture Decision Records

Architektur-Entscheidungen werden dokumentiert – Kontext bleibt erhalten.

infrastructurearchitekturdokumentation

Typ

Design-Pattern

Cluster

Infrastructure

Sichtbarkeit

PUBLIC

Status

PUBLISHED

Beschreibung

Architecture Decision Records (ADRs) sind kurze Dokumente, die architektonische Entscheidungen festhalten: Kontext, Entscheidung, Begründung, Konsequenzen. Sie werden versioniert und mit Code abgelegt.

Das Pattern macht Architektur nachvollziehbar. Neue Teammitglieder verstehen, warum Dinge so sind. Entscheidungen können später im Kontext bewertet werden. Architektur wird lernfähig.

Pattern-Struktur

Framework-Struktur

B.U.I.L.D.

B - Backdrop

Architektur-Entscheidungen gehen verloren. Kontext verblasst. Neue Teammitglieder verstehen Entscheidungen nicht. Dieselben Diskussionen wiederholen sich.

U - Underlying Shift

Von implizitem zu explizitem Architektur-Wissen: Entscheidungen werden dokumentiert statt nur getroffen.

I - Implementation

ADR-Template definieren (Kontext, Entscheidung, Begründung, Konsequenzen). ADRs in Versionskontrolle ablegen. Bei architektonischen Entscheidungen ADR schreiben. In Onboarding nutzen.

L - Leverage

Bessere Nachvollziehbarkeit, schnelleres Onboarding, weniger wiederholte Diskussionen, lernfähigere Architektur.

D - Development

Template erstellen. Bei nächsten Architektur-Entscheidungen anwenden. Sammlung aufbauen. In Entwicklungsprozess integrieren.

Use Cases, Stories & Hinweise

Anwendung: Bei Software-Entwicklung, IT-Architektur, Plattform-Design, Technologie-Entscheidungen.

Praxisbeispiel: Team entscheidet sich für Microservices statt Monolith. ADR dokumentiert: Kontext (Skalierungsanforderungen), Entscheidung (Microservices), Begründung (Team-Autonomie, unabhängige Skalierung), Konsequenzen (höhere Komplexität, bessere Skalierbarkeit).

Verweise

Weitere passende Design-Patterns

TitelKurzbeschreibungLink
Value Stream MappingWertschöpfungsprozesse werden visualisiert – Verschwendung wird sichtbar.Öffnen
Minimal Viable GovernanceGovernance ist so leicht wie möglich, so streng wie nötig.Öffnen
Rhythmic Check-insRegelmäßige kurze Check-ins schaffen Verbindung und frühes Problemerkennen.Öffnen
North Star MetricEine zentrale Metrik fokussiert die Organisation auf wesentliche Wirkung.Öffnen

Passende Anti-Patterns im gleichen Kontext

TitelKurzbeschreibungLink
Frankenstein ArchitectureIT-Landschaften aus zusammengestückelten Teilen – niemand versteht das Ganze.Öffnen
Hero Culture ITAlles hängt an einzelnen IT-Helden – gefährliche Abhängigkeit.Öffnen
Golden HammerEin Werkzeug für alles – auch wenn es nicht passt.Öffnen
Tool-WildwuchsJedes Team nutzt eigene Tools – Integration unmöglich.Öffnen

Passende blinde Flecken

TitelKurzbeschreibungLink
Technische Schulden unter der OberflächeSysteme laufen – Fragilität wächst unbemerkt im Untergrund.Öffnen
Expertenabhängigkeit wird als Kompetenz verkannt"Unsere Experten wissen alles" – wenn sie gehen, steht alles still.Öffnen
Effizienz wird in Silos optimiertJede Abteilung ist effizienter – das Gesamtsystem langsamer.Öffnen
Prozesse sind dokumentiert, nicht verstandenProzess-Handbücher existieren – Realität sieht anders aus.Öffnen