Architecture Decision Record aus einer aufgezeichneten Besprechung erstellen
Ein ADR hält eine wesentliche Architekturentscheidung fest: Kontext, geprüfte Optionen, Wahl, Folgen und Status. Das Transkript hilft, die Gründe wiederzufinden. Die Beteiligten prüfen die technische Genauigkeit.
So erstellen Sie ein Architecture Decision Record aus einer aufgezeichneten Diskussion
Ein ADR hält eine wesentliche Architekturentscheidung fest: Kontext, geprüfte Optionen, Wahl, Folgen und Status. Das Transkript hilft, die Gründe wiederzufinden. Die Beteiligten prüfen die technische Genauigkeit.
Ein Transkript macht die Formulierungen überprüfbar und bewahrt Kontext, Vorbehalte und Argumentationsverlauf. Die verantwortliche Person legt die Endfassung fest und lässt sie von den Teilnehmenden prüfen.
Erstellen Sie das ADR Schritt für Schritt
Wählen Sie eine Entscheidung
Dokumentieren Sie unabhängige Architekturentscheidungen jeweils in einem eigenen Eintrag.
Beschreiben Sie den Kontext
Halten Sie Einflussfaktoren und Einschränkungen fest, die eine Entscheidung erforderlich machten.
Vergleichen Sie Optionen
Notieren Sie je Option die wichtigsten Vor- und Nachteile und die Gründe für eine Ablehnung.
Benennen Sie die Folgen
Führen Sie Nutzen, Kosten, neue Einschränkungen, Risiken und den Anlass für eine Überprüfung auf.
Beispiel: Speicher für Audiodateien auswählen
Das folgende Übungsbeispiel ist fiktiv. Namen, Rahmenbedingungen und Ergebnisse dienen ausschließlich dazu, die Methode zu erklären.
„Objektspeicher ist für das Archiv günstiger, aber wir brauchen einen eigenen Mechanismus für temporäre Links.“
Kontext: Die Aufnahmen sind groß, der Zugriff soll zeitlich begrenzt sein und die Linkausgabe muss kontrolliert werden. Die Wahl fällt auf Objektspeicher. Neben den Kosten zählen Skalierbarkeit und Zugriffsmodell.
Nennen Sie als Folgen Arbeit und Risiken: temporäre Links, Kontrolle der Gültigkeit, Protokollierung und Tests für Ausfälle. Ändert sich die Kostenannahme, kann ein neues ADR das alte ablösen und die Historie erhalten.
| Abschnitt | Brauchbarer Eintrag | Negativbeispiel |
|---|---|---|
| Kontext | Große Dateien und begrenzter Zugriff | Wir brauchen neuen Speicher |
| Optionen | Objekt- oder Dateispeicher | Wir haben das Beste gewählt |
| Entscheidung | Objektspeicher aus Gründen A und B | Die Architektur hat entschieden |
| Folgen | Temporäre Links und Überwachung | Keine Nachteile |
ADR-Vorlage
Kopieren Sie die Vorlage und nutzen Sie eine konkrete Aufnahme. Kennzeichnen Sie unbestätigte Annahmen als Hypothesen.
Titel und Status: Datum und Teilnehmende: Kontext und Einschränkungen: Geprüfte Optionen: Entscheidung und Begründung: Folgen, Risiken und Anlass für erneute Prüfung:
Vier Prüfpunkte vor dem Versand
- Der Eintrag beschreibt eine Entscheidung.
- Der Kontext nennt tatsächliche Einschränkungen.
- Alternativen und Ablehnungsgründe sind dokumentiert.
- Nachteile und Anlass zur Überprüfung sind genannt.
Ein genauerer Blick
Kann man ein akzeptiertes ADR bearbeiten?
Tippfehler können Sie korrigieren. Eine geänderte Entscheidung gehört in einen neuen Eintrag mit Verweis auf den vorherigen.
Muss das Transkript daneben liegen?
Ein Link zur internen Quelle mit Zeitmarke genügt in der Regel, um eine strittige Formulierung zu prüfen.