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

Unbesetzter Cyberaufklärungsraum bei Nacht KI-generierte redaktionelle Illustration

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. 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. 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. 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. 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. 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.

Nachvollziehbarer Abnahmefall

Fiktives Beispiel: Diese Daten beschreiben keine Kunden oder beobachteten Ergebnisse.

Falldaten anzeigen
{
    "decision": "ADR-7",
    "status": "accepted",
    "assumption": {
        "requests_per_day": 1000
    },
    "current_requests_per_day": 100000
}

Erwartete Entscheidung

Die Lastannahme ist um Faktor 100 gestiegen. ADR-7 prüfen und die historische Entscheidung erhalten.

Fiktive Varianten zum Prüfen

Ein ADR ist akzeptiert, doch nur einer von drei Diensten setzt es um.

Unterscheiden Sie akzeptierte Entscheidung und abgeschlossenen Rollout. Verfolgen Sie übrige Dienste mit Verantwortlichen, etwaiger Ausnahme und Adoptionsnachweis.

Der Pilot verlangt p95 ≤ 200 ms, gemessen werden 350 ms.

Das Kriterium ist nicht erfüllt. Bewahren Sie Last, Zeitfenster und Ergebnis auf und entscheiden Sie über Überarbeitung statt Erfolg zu erklären.

Eine befristete Ausnahme erreicht ihren Prüftermin.

Kennzeichnen Sie sie zur Neubewertung. Schweigen verlängert eine Ausnahme nicht automatisch; verlangen Sie eine datierte Entscheidung mit Bedingungen und Verantwortlichen.

Zu sichernde Nachweise

  • ADR-Status und Umsetzung je Dienst.
  • Pilotkriterien, Verfahren und Messergebnis.
  • Verantwortliche, Termin und Ausnahmeentscheidung.

Prüfverfahren

  1. Entscheidung, Alternativen und Lastannahmen erfassen.
  2. Falsche Annahme mit heutigem Kontext vergleichen.
  3. Alten ADR und Verweis zum Ersatz aufbewahren. Datieren Sie die geänderte Annahme, benennen Sie die Prüfverantwortung und den benötigten Beleg für die Eignung im neuen Kontext.

AWS Prescriptive Guidance — Architectural decision record process

Wiederverwendbares Arbeitsblatt

Ergänzen Sie Ihre autorisierten Beobachtungen. Bei diesen Feldern handelt es sich um eine Arbeitsvorlage, nicht um beobachtete Ergebnisse.

FeldZu erfassende Informationen
FrageProblem, Umfang und Einschränkungen zum Entscheidungszeitpunkt
OptionenVerglichene Lösungen und gemeinsame Kriterien
WahlStatus, Verantwortliche, Gründe und Folgen
ÜberprüfungAuslö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

MechanismusZweckÜberprüfung oder Einschränkung
BesprechungsprotokollAustausch festhaltenEntscheidung kann verstreut sein
ADRWahl, Gründe und Folgen aufbewahrenErsetzt keine Spezifikation oder Prüfung
UmsetzungsaufgabeLieferung verfolgenKann ohne erhaltene Begründung geschlossen werden

Managementindikatoren

IndikatorWas es misstErste Aktion
Nachvollziehbare EntscheidungenWesentliche Entscheidungen mit zugänglichem KontextSchwer übernehmbare Abhängigkeiten bearbeiten
Geprüfte AnnahmenEntscheidende Annahmen getestet oder gemessenKriterien bei fehlendem Beleg überarbeiten
ÜbergabeDurch neue Verantwortliche erklärbare EntscheidungenRegister 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 .