FACHWISSEN · TECHNIK & PROZESSETECHNICAL KNOWLEDGE · SYSTEMS & PROCESSES
Architekturentscheidungen: Warum das Warum länger hält als das BesprechungsprotokollArchitecture decisions: Why the rationale outlasts the meeting minutes
Monate nach einer Systementscheidung ist oft noch bekannt, was gebaut wurde. Warum eine Alternative ausschied, welche Annahme galt und welcher Nachteil bewusst akzeptiert wurde, lässt sich dagegen schwerer rekonstruieren. Ein Architecture Decision Record, kurz ADR, hält genau diesen Entscheidungszusammenhang fest.
Eine Entscheidung mit Kontext
Ein ADR behandelt eine wesentliche Architekturentscheidung. Er beschreibt das Problem, die relevanten Rahmenbedingungen und die gewählte Lösung. Sinnvoll sind beispielsweise Entscheidungen über Schnittstellen, Datenhaltung oder die Aufteilung eines Systems. Nicht jede kleine Umsetzung benötigt einen eigenen Eintrag.
Folgen gehören zur Entscheidung
Ein kurzer Vermerk sollte Vorteile und Nachteile sichtbar machen. Fiktives Beispiel: Ein Team verarbeitet Meldungen zeitversetzt, um Lastspitzen abzufangen. Dafür akzeptiert es, dass ein Ergebnis nicht sofort vorliegt. Im Eintrag stehen deshalb auch Anforderungen an Wiederholungen und den Umgang mit verspäteten Ergebnissen.
So wird aus „Wir verwenden eine Warteschlange“ eine nachvollziehbare Abwägung. Eine Alternative bleibt nicht nur als abgelehnte Option stehen: Der Eintrag erklärt auch, weshalb sie unter den damals geltenden Bedingungen weniger geeignet erschien.
Einen Beschluss nicht rückwirkend umschreiben
Ein Status unterscheidet Vorschlag und angenommene Entscheidung. Ändern sich später die Voraussetzungen, kann ein neuer Eintrag die bisherige Entscheidung ablösen. Der frühere Grund bleibt damit lesbar.
Das ist besonders hilfreich, wenn neue Beteiligte eine Lösung beurteilen, ohne die damaligen Randbedingungen zu kennen. Die Dokumentation zeigt dann sowohl den früheren Gedankengang als auch den Anlass für eine spätere Neubewertung.
Kurz halten und verantwortlich prüfen
Titel, Datum, Status und eine verantwortliche Rolle erleichtern das Wiederfinden. Betroffene Fachbereiche sollten die Konsequenzen prüfen. Ein ADR ersetzt weder Freigaben noch Testnachweise oder das Sitzungsprotokoll: Er beantwortet die Frage, warum das System bewusst in diese Richtung entwickelt wird.
Ein praktischer Prüfschritt lautet: Könnte eine neue Kollegin aus dem Eintrag erkennen, unter welcher veränderten Voraussetzung die Entscheidung erneut zu bewerten wäre?
Months after a system decision, people often remember what was built. Reconstructing why an alternative was rejected, which assumption applied and which drawback was accepted can be harder. An architecture decision record, or ADR, preserves that reasoning.
One decision in context
An ADR addresses one significant architectural choice. It explains the problem, relevant constraints and selected approach. Interfaces, data storage and system boundaries are useful subjects. Not every small implementation choice requires a separate record.
Make the consequences visible
A concise record should show benefits and drawbacks. In a fictional example, a team processes messages asynchronously to absorb demand peaks. It accepts that results will not be available immediately. The record therefore also identifies requirements for retries and delayed results.
This turns “We use a queue” into an understandable trade-off. An alternative is more than a rejected option: the record explains why it appeared less suitable under the conditions that applied at the time.
Preserve the original reasoning
A status distinguishes a proposal from an accepted decision. When circumstances change, a new record can supersede the previous one. The earlier rationale remains available.
This helps newcomers assess a solution without confusing today’s conditions with earlier constraints. The documentation shows both the original reasoning and the reason for a later reassessment.
Keep it concise and review ownership
A title, date, status and responsible role make records easier to find. Affected disciplines should review the consequences. An ADR does not replace approvals, test evidence or meeting minutes: it explains why the system is intentionally developing in a particular direction.
A useful practical check is whether a new colleague could identify which changed assumption would justify reconsidering the decision.