Ressourcen · 84
Architekturentscheidungen: Gründe bewahren und gezielt überprüfen
Wesentliche Entscheidungen dokumentieren, ohne jede Besprechung in ein umfangreiches Dossier zu verwandeln.
Aktualisiert · 3 min
Wozu dieser Leitfaden beiträgt
- Entscheidung abgrenzen
- Plausible Optionen vergleichen
- Entscheidung und Folgen benennen
- Historischen Kontext bewahren
- Sinnvolle Prüfbedingungen definieren
Kurzcheck
- Benötigt jede Aufgabe ein ADR?
- Kann eine akzeptierte Entscheidung geändert werden?
- Garantiert ein Register gute Entscheidungen?
Schritt-für-Schritt-Anleitung
- 1
Entscheidung abgrenzen
Wählen Sie eine Frage mit langfristigen Folgen wie Hosting, Integration, Speicherung oder Komponentengrenzen. Ein ADR bewahrt Gründe einer wesentlichen Architekturentscheidung. Beschreiben Sie das tatsächliche Problem und heutige Einschränkungen statt nachträglich eine Verkaufsbegründung zu formulieren.
Ergebnis: Entscheidungsfrage und Umfang.
- 2
Plausible Optionen vergleichen
Nennen Sie wirklich geprüfte Optionen einschließlich des bestehenden Systems, wenn es tragfähig bleibt. Nutzen Sie gemeinsame Kriterien für Verwendung, Sicherheit, Betrieb, enthaltene Kosten und Ausstieg. Trennen Sie Messungen, Dokumentationsangaben und offene Annahmen.
Ergebnis: Kriterien- und Belegtabelle.
- 3
Entscheidung und Folgen benennen
Halten Sie Option, Verantwortliche, Datum und Status fest. Beschreiben Sie akzeptierte Folgen wie technische Schulden, Migration und Grenzen. Zustimmung beseitigt keine bekannte Einschränkung. Verknüpfen Sie die Wahl mit erfüllten Anforderungen und noch notwendigen Prüfungen.
Ergebnis: akzeptierte Entscheidung und eindeutige Folgen.
- 4
Historischen Kontext bewahren
Eine ersetzte Entscheidung bleibt erklärungsbedürftig. Verknüpfen Sie sie mit ihrer Nachfolgerin, statt die Vergangenheit umzuschreiben. Der ADR-Prozess unterscheidet vorgeschlagene, akzeptierte, abgelehnte und ersetzte Entscheidungen. Behalten Sie Links zu Aufgaben und zugänglichen Belegen.
Ergebnis: Register mit Versionsbeziehungen.
- 5
Sinnvolle Prüfbedingungen definieren
Nennen Sie Veränderungen wie Mengen oberhalb des getesteten Umfangs, Ausfall eines Anbieters, Lokalisierungsbedarf oder Kosten außerhalb der Annahmen. Sie lösen einen aktualisierten Vergleich aus, keinen automatischen Abbruch. Prüfen Sie, ob eine neue verantwortliche Person den Grund ohne die ursprünglichen Beteiligten erklären kann.
Ergebnis: Prüfanlässe und Übergabetest.
Wiederverwendbares Arbeitsblatt
Ergänzen Sie Ihre autorisierten Beobachtungen. Bei diesen Feldern handelt es sich um eine Arbeitsvorlage, nicht um beobachtete Ergebnisse.
| Feld | Zu erfassende Informationen |
|---|---|
| Frage | Problem, Umfang und Einschränkungen zum Entscheidungszeitpunkt |
| Optionen | Verglichene Lösungen und gemeinsame Kriterien |
| Wahl | Status, Verantwortliche, Gründe und Folgen |
| Überprüfung | Auslöser und Link zu einer ersetzenden Entscheidung |
Fiktives Arbeitsbeispiel
Beispielhafte Situation
Fiktives Beispiel: Ein Team wählt verwaltete Suche, weil es die benötigte Rufbereitschaft nicht leisten kann.
Entscheidung und erwartete Beweise
Das Register enthält diese Einschränkung, erwartete Exporte und Prüfanlässe bei veränderten Lokalisierungsanforderungen oder Kosten.
Unterscheiden Sie die Mechanismen
| Mechanismus | Zweck | Überprüfung oder Einschränkung |
|---|---|---|
| Besprechungsprotokoll | Austausch festhalten | Entscheidung kann verstreut sein |
| ADR | Wahl, Gründe und Folgen aufbewahren | Ersetzt keine Spezifikation oder Prüfung |
| Umsetzungsaufgabe | Lieferung verfolgen | Kann ohne erhaltene Begründung geschlossen werden |
Managementindikatoren
| Indikator | Was es misst | Erste Aktion |
|---|---|---|
| Nachvollziehbare Entscheidungen | Wesentliche Entscheidungen mit zugänglichem Kontext | Schwer übernehmbare Abhängigkeiten bearbeiten |
| Geprüfte Annahmen | Entscheidende Annahmen getestet oder gemessen | Kriterien bei fehlendem Beleg überarbeiten |
| Übergabe | Durch neue Verantwortliche erklärbare Entscheidungen | Register statt Besprechungszahl verbessern |
Häufige Fallstricke
- Entscheidung kann verstreut sein
- Ersetzt keine Spezifikation oder Prüfung
- Kann ohne erhaltene Begründung geschlossen werden
Häufig gestellte Fragen
Benötigt jede Aufgabe ein ADR?
Nein. Nutzen Sie es für wesentliche Entscheidungen, deren Folgen oder Umkehrbarkeit das Bewahren der Gründe rechtfertigen.
Kann eine akzeptierte Entscheidung geändert werden?
Ja. Erfassen Sie neue Wahl, Kontext und Beziehung zur ersetzten Entscheidung, ohne alte Gründe zu löschen.
Garantiert ein Register gute Entscheidungen?
Nein. Kriterien und Annahmen werden überprüfbar; Qualität von Belegen und Tests bleibt entscheidend.
Offizielle Referenzen
Die Referenzen unterstützen die Methode. Passen Sie die Prüfungen an Ihren Kontext an; sie stellen keine Zertifizierung dar. Originalreferenztitel und Quelldokumente können in einer anderen Sprache verfasst sein.
Referenzen geprüft am .
