Kontext, Optionen und Folgen festhalten: Eine kompakte Struktur für Architecture Decision Records im Projektalltag.
Für wen ist das hilfreich? Architektur- und Entwicklungsteams, die die Gründe technischer Entscheidungen dauerhaft nachvollziehen möchten.
Einsatzfälle und Einordnung
Ein Architecture Decision Record, kurz ADR, hält eine relevante Entscheidung und ihre Begründung fest. Später ist oft nicht die gewählte Technik unklar, sondern warum Alternativen verworfen wurden und welche Voraussetzungen damals galten.
Ein ADR sollte kompakt genug bleiben, um tatsächlich gelesen zu werden. Er ergänzt Architekturübersichten und verbindliche Vorgaben, ersetzt sie aber nicht. Besonders hilfreich sind Einträge zu Entscheidungen mit längerfristigen Auswirkungen, etwa Datenverantwortung, Integrationsmustern oder zentralen Plattformdiensten.
Vorgehen im Detail
- Die Entscheidungsfrage formulieren. Kontext, Ziele und Einschränkungen so beschreiben, dass auch spätere Teammitglieder sie verstehen.
- Ernsthaft betrachtete Optionen vergleichen. Vorteile, Nachteile und offene Unsicherheiten anhand der relevanten Kriterien festhalten.
- Entscheidung, Status und Konsequenzen dokumentieren. Bei einer späteren Änderung einen neuen Eintrag verknüpfen, statt die alte Begründung unkenntlich zu überschreiben.
Ergebnisse auf einen Blick
- Nachvollziehbare Entscheidungsfrage
- Dokumentierte Alternativen und Abwägungen
- Erkennbare Folgen für Umsetzung und Betrieb
- Verknüpfte Historie geänderter Entscheidungen
Gut vorbereitet entscheiden
Eine kurze Vorlage enthält Titel, Status, Kontext, Optionen, Entscheidung, Konsequenzen und Verweise. Benennen Sie Beteiligte und Entscheidungsdatum, wenn diese Angaben tatsächlich bekannt sind.
Vermeiden Sie reine Produktwerbung und pauschale Aussagen wie „zukunftssicher“. Beschreiben Sie stattdessen, welche Anforderung erfüllt wird und welchen Nachteil das Team bewusst akzeptiert.
Fragen und Antworten
Braucht jede kleine Änderung einen ADR?
Nein. Der Aufwand sollte zur Tragweite passen. Wiederkehrende lokale Entscheidungen können oft durch bestehende Standards abgedeckt werden.
Was passiert mit einem überholten ADR?
Er bleibt als Historie erhalten und verweist auf die ersetzende Entscheidung. So gehen die damaligen Voraussetzungen nicht verloren.