Entscheidungsprotokoll-Vorlage mit ADRs
Ein Entscheidungsprotokoll und seine Einträge in sechs verlinkten Dokumenten: das Protokoll, das jede Entscheidung mit ihrem Status auflistet, wie Ihr Team entscheidet, ein leerer Eintrag zum Kopieren und drei Beispieleinträge, einer davon durch den nächsten ersetzt. Laden Sie sie als Markdown-Dateien herunter: Sie öffnen sich in jedem Editor, passen in ein Code-Repository und lassen sich als Karte in Nodary importieren.
6 Markdown-Dateien in einem .zip, 7 kB
Kostenlos, ohne Konto und ohne E-Mail-Adresse. Nutzen, ändern und teilen Sie sie, wie Sie möchten.
Lesen Sie jede Seite vor dem Download
Das Protokoll ist die Seite, die alle öffnen: eine Zeile pro Entscheidung, verlinkt mit ihrem Eintrag. Die Einträge folgen dem ADR-Format (Architecture Decision Record) und passen für jede Entscheidung, technisch oder nicht. Die Beispiele folgen einem Beispielprodukt, das entscheidet, wo hochgeladene Dateien liegen.
Dokumente
Datei Entscheidungsprotokoll-Vorlage/Entscheidungsprotokoll.md
Entscheidungsprotokoll
So nutzen Sie diese Vorlage: Kursive Zeilen sind Hinweise. Ersetzen Sie sie durch Ihre eigenen Worte und löschen Sie sie dann. Werte in eckigen Klammern füllen Sie aus. Jede Entscheidung hat ihren eigenen Eintrag, verlinkt aus der Tabelle unten; ein Eintrag wird nie gelöscht, und eine Entscheidung, die sich ändert, bekommt einen neuen Eintrag, der sie ersetzt.
Entscheidungen
| Nummer | Entscheidung | Status | Datum | Entschieden von | Ersetzt durch |
|---|---|---|---|---|---|
| ADR-001 | Entscheidungen in diesem Protokoll festhalten | angenommen | [Datum] | [Namen] | |
| ADR-002 | Hochgeladene Dateien auf dem Anwendungsserver speichern | ersetzt | [Datum] | [Namen] | ADR-003 |
| ADR-003 | Hochgeladene Dateien im Objektspeicher ablegen | angenommen | [Datum] | [Namen] | |
| [ADR-004] | [Ihre nächste Entscheidung] | [vorgeschlagen] | [Datum] | [Namen] |
Status
- VorgeschlagenAngenommenAbgelehnt
- AngenommenErsetztVeraltet
Mermaid
flowchart LR n0["Vorgeschlagen"] n1["Angenommen"] n2["Abgelehnt"] n3["Ersetzt"] n4["Veraltet"] n0 --> n1 n0 --> n2 n1 --> n3 n1 --> n4
| Status | Bedeutung |
|---|---|
| Vorgeschlagen | Geschrieben und offen zur Prüfung, noch nicht entschieden |
| Angenommen | Entschieden: Das Team richtet sich danach |
| Abgelehnt | Dagegen entschieden und aufbewahrt, damit niemand erneut fragen muss |
| Ersetzt | Durch eine spätere Entscheidung abgelöst, deren Nummer genannt wird |
| Veraltet | Gilt nicht mehr, und nichts hat sie ersetzt |
Wann ein Eintrag nötig ist
- Die Entscheidung ist schwer rückgängig zu machen: [eine Datenbank, ein Anbieter, eine öffentliche API, ein Preis]
- Mehrere Optionen wurden ernsthaft erwogen
- Jemand wird in sechs Monaten nach dem Warum fragen
- Sie ändert die Arbeit eines anderen Teams
Der Rest des Protokolls
- Wie wir entscheiden: wer vorschlägt, wer entscheidet und wie ein Eintrag geprüft wird
- Vorlage für einen Entscheidungseintrag: der leere Eintrag zum Kopieren für jede neue Entscheidung
Diese Vorlage dürfen Sie frei nutzen, ändern und teilen. Sie stammt von Nodary, wo sich diese Dateien als Karte verlinkter Dokumente importieren lassen.
Datei Entscheidungsprotokoll-Vorlage/Entscheidungsprotokoll/01 Wie wir entscheiden.md
Wie wir entscheiden
Die Regeln des Protokolls, einmal vereinbart. Ohne sie entstehen Einträge für Kleinigkeiten, und für die großen Dinge fehlen sie.
Wer entscheidet
| Art der Entscheidung | Vorgeschlagen von | Entschieden von | Gefragt werden |
|---|---|---|---|
| [Architektur] | [alle Entwickler] | [technische Leitung] | [...] |
| [Produktumfang] | [...] | [Product Owner] | [...] |
| [Anbieter oder Ausgaben] | [...] | [...] | [...] |
Vom Vorschlag zur Entscheidung
- Kopieren Sie den leeren Eintrag, geben Sie ihm die nächste Nummer und den Status „vorgeschlagen“.
- Schreiben Sie den Kontext und mindestens zwei Optionen vor der Entscheidung.
- Bitten Sie die Entscheider, ihn bis [Datum] zu prüfen.
- Setzen Sie den Status auf „angenommen“ oder „abgelehnt“, mit Datum und Entscheidern.
- Fügen Sie dem Entscheidungsprotokoll eine Zeile hinzu.
Eine Entscheidung ändern
Ändern Sie nie einen angenommenen Eintrag, damit er etwas anderes sagt. Schreiben Sie einen neuen Eintrag, der ihn ersetzt, setzen Sie den alten mit der neuen Nummer auf „ersetzt“ und verlinken Sie beide in beide Richtungen.
Überprüfungen
- Angenommene Entscheidungen werden überprüft: [jedes Quartal, bei jedem Meilenstein]
- Vorschläge, die älter als [zwei Wochen] sind, werden entschieden oder zurückgezogen
Datei Entscheidungsprotokoll-Vorlage/Entscheidungsprotokoll/02 Vorlage für einen Entscheidungseintrag.md
Vorlage für einen Entscheidungseintrag
Kopieren Sie diese Seite für jede neue Entscheidung und geben Sie ihr die nächste Nummer, etwa ADR-004 gefolgt von der Entscheidung in wenigen Worten.
| Feld | Wert |
|---|---|
| Nummer | [ADR-000] |
| Status | [vorgeschlagen, angenommen, abgelehnt, ersetzt durch ADR-..., veraltet] |
| Datum | [Datum] |
| Entschieden von | [Namen] |
| Ersetzt | [keinen, oder ADR-...] |
Kontext
Die Kräfte, die wirken: was heute gilt, was schmerzt, was die Wahl einschränkt. Fakten, nicht die Entscheidung.
[Kontext]
Erwogene Optionen
| Option | Dafür | Dagegen |
|---|---|---|
| [Option A] | [...] | [...] |
| [Option B] | [...] | [...] |
Entscheidung
Was Sie tun werden, in ganzen Sätzen, beginnend mit „Wir werden“.
Wir werden [...].
Folgen
- Leichter: [...]
- Schwerer: [...]
- Im Blick behalten: [...]
Datei Entscheidungsprotokoll-Vorlage/Entscheidungsprotokoll/03 ADR-001 Entscheidungen in diesem Protokoll festhalten.md
ADR-001 Entscheidungen in diesem Protokoll festhalten
| Feld | Wert |
|---|---|
| Nummer | ADR-001 |
| Status | angenommen |
| Datum | [Datum] |
| Entschieden von | [Namen] |
| Ersetzt | keinen |
Kontext
Entscheidungen fallen in Meetings, Chats und Telefonaten. Ein paar Monate später weiß niemand mehr, warum das Team so gewählt hat, und Neue führen alte Debatten erneut oder machen Entscheidungen rückgängig, ohne zu wissen, was sie gekostet haben.
Erwogene Optionen
| Option | Dafür | Dagegen |
|---|---|---|
| Nichts aufschreiben | Schnell | Die Gründe gehen verloren |
| Protokolle aller Meetings | Alles ist festgehalten | Niemand liest sie, und Entscheidungen gehen darin unter |
| Ein kurzer Eintrag pro wichtiger Entscheidung, gelistet in einem Protokoll | Leicht zu finden und zu lesen | Etwa fünfzehn Minuten pro Entscheidung |
Entscheidung
Wir werden für jede wichtige Entscheidung einen Eintrag schreiben, fortlaufend nummeriert, und ihn im Entscheidungsprotokoll aufführen. Ein Eintrag wird nie gelöscht oder umgeschrieben: Ein neuer Eintrag ersetzt ihn.
Folgen
- Leichter: das Warum kennen und Neue einarbeiten
- Schwerer: schnell entscheiden, ohne etwas aufzuschreiben
- Im Blick behalten: Einträge, die nachträglich oder gar nicht geschrieben werden
Datei Entscheidungsprotokoll-Vorlage/Entscheidungsprotokoll/04 ADR-002 Hochgeladene Dateien auf dem Anwendungsserver speichern.md
ADR-002 Hochgeladene Dateien auf dem Anwendungsserver speichern
| Feld | Wert |
|---|---|
| Nummer | ADR-002 |
| Status | ersetzt durch ADR-003 |
| Datum | [Datum] |
| Entschieden von | [Namen] |
| Ersetzt | keinen |
Ein Beispiel für einen ersetzten Eintrag. Als ADR-003 ihn ersetzte, wurde außer seinem Status nichts daran geändert.
Kontext
Nutzer hängen Dateien an ihre Dokumente. Das Produkt läuft auf einem einzigen Anwendungsserver mit einer großen Festplatte, und das Team hat zwei Entwickler.
Erwogene Optionen
| Option | Dafür | Dagegen |
|---|---|---|
| Die Festplatte des Anwendungsservers | Einfach, nichts Neues zu betreiben | Schwer zu sichern und mit einem zweiten Server zu teilen |
| Objektspeicher | Wächst ohne Grenze, günstig | Ein weiterer Dienst, den man lernen und bezahlen muss |
Entscheidung
Wir werden hochgeladene Dateien auf der Festplatte des Anwendungsservers speichern und die Festplatte jede Nacht sichern.
Folgen
- Leichter: Uploads noch diesen Monat ausliefern
- Schwerer: später einen zweiten Server hinzufügen
- Im Blick behalten: den freien Speicherplatz und die Dauer einer Wiederherstellung
Datei Entscheidungsprotokoll-Vorlage/Entscheidungsprotokoll/05 ADR-003 Hochgeladene Dateien im Objektspeicher ablegen.md
ADR-003 Hochgeladene Dateien im Objektspeicher ablegen
| Feld | Wert |
|---|---|
| Nummer | ADR-003 |
| Status | angenommen |
| Datum | [Datum] |
| Entschieden von | [Namen] |
| Ersetzt | ADR-002 |
Kontext
Der Traffic braucht jetzt einen zweiten Anwendungsserver, und eine Datei, die auf der Festplatte des einen Servers liegt, fehlt auf dem anderen. Die Wiederherstellung der nächtlichen Sicherung dauerte bei der letzten Übung vier Stunden. ADR-002 ging von einem einzigen Server aus; das stimmt nicht mehr.
Erwogene Optionen
| Option | Dafür | Dagegen |
|---|---|---|
| Eine von den Servern geteilte Festplatte | Keine Codeänderung | Noch etwas zu betreiben und ein einzelner Ausfallpunkt |
| Objektspeicher | Jeder Server sieht jede Datei, Versionen bleiben, Wiederherstellung in Minuten | Codeänderungen für Upload und Download |
Entscheidung
Wir werden hochgeladene Dateien im Objektspeicher mit aktivierter Versionierung ablegen und sie über signierte, ablaufende Links ausliefern. Dies ersetzt ADR-002.
Folgen
- Leichter: Server hinzufügen und eine gelöschte Datei wiederherstellen
- Schwerer: das Produkt ohne den Speicherdienst auf einem Laptop betreiben
- Im Blick behalten: die Speicherrechnung und Links, die vor ihrem Ablauf geteilt wurden
So nutzen Sie sie
Klären, wer entscheidet
Füllen Sie zuerst die Prozessseite aus: welche Entscheidungen einen Eintrag brauchen, wer vorschlägt, wer entscheidet und wer gefragt wird.
Für jede Entscheidung den Eintrag kopieren
Geben Sie ihm die nächste Nummer und den Status „vorgeschlagen“. Schreiben Sie den Kontext und mindestens zwei Optionen, bevor jemand die Entscheidung schreibt.
Entscheiden, dann eintragen
Setzen Sie den Status auf „angenommen“ oder „abgelehnt“, mit Datum und Entscheidern, und fügen Sie dem Protokoll eine Zeile hinzu. Eine abgelehnte Entscheidung bleibt: Sie erspart die nächste Debatte.
Ersetzen, nie umschreiben
Ändert sich eine Entscheidung, schreiben Sie einen neuen Eintrag, der den alten ersetzt, und markieren den alten mit der neuen Nummer als ersetzt. Die Geschichte bleibt lesbar.
Als Karte in Nodary importieren
Nodary ist ein KI-nativer Workspace, in dem die Dokumente eines Teams verlinkt sind, statt sich zu stapeln. Importieren Sie die .zip, und das Protokoll kommt mit seinen Einträgen darunter an, die Links zwischen ihnen bleiben erhalten. Markieren Sie jeden Eintrag als Kanon, Erkundung, Veraltet oder Ersetzt durch den Eintrag, der ihn abgelöst hat: Der Status steht am Dokument, und per MCP verbundene KI-Agenten erfahren ihn, bevor sie einen ersetzten Eintrag lesen. Widersprechen sich zwei Dokumente, zeigt Nodary beide Passagen nebeneinander.
- Öffnen Sie die Karte eines Projekts und wählen Sie „Importieren“.
- Wählen Sie den Tab „Ordner oder ZIP“ und dann „ZIP wählen“.
- Wählen Sie die heruntergeladene Datei, prüfen Sie die Baumstruktur und importieren Sie.
Der Free-Plan bietet zehn Dokumente pro Workspace, die eigene Seite des Projekts eingerechnet: Die sechs der Vorlage lassen Platz für drei weitere Einträge. Nodary hat außerdem eine einseitige Vorlage für einen Architecture Decision Record eingebaut.
Wie KI-Agenten sich per MCP mit Nodary verbinden
Ein Entscheidungsprotokoll führen, dem man vertraut
Ein Entscheidungsprotokoll scheitert, wenn niemand hineinschreibt oder wenn es nicht mehr zu dem passt, was das Team tut. Diese Gewohnheiten verhindern beides.
Eine Entscheidung pro Eintrag
Ein Eintrag, der drei Dinge regelt, wird dreimal wieder geöffnet. Halten Sie jeden bei einer Entscheidung mit einem Status.
Kontext vor der Entscheidung
Schreiben Sie, was heute gilt und was die Wahl einschränkt, bevor Sie die Entscheidung selbst schreiben. Sechs Monate später erklärt der Kontext sie.
Immer zwei Optionen
Ein Eintrag mit nur einer Option ist eine Ankündigung. Nennen Sie die ernsthaft erwogenen Alternativen und warum Sie sie nicht gewählt haben.
Ersetzen, nie umschreiben
Ein angenommener Eintrag wird nie geändert, um etwas anderes zu sagen. Ein neuer Eintrag ersetzt ihn, beide bleiben, und das Protokoll erzählt die wahre Geschichte.
Sagen, wer entschieden hat
Jeder Eintrag nennt seine Entscheider und sein Datum. Eine Entscheidung ohne Namen hat niemanden, den man fragen kann, und niemanden, der sie ändern kann.
Mit dem verlinken, was sie ändert
Verlinken Sie jeden Eintrag mit den Dokumenten, die er ändert, und diese zurück. Wer das Design liest, findet den Grund dann mit einem Klick.
Fragen zum Entscheidungsprotokoll
Was ist ein Entscheidungsprotokoll?
Ein Entscheidungsprotokoll ist eine fortlaufende Liste der wichtigen Entscheidungen eines Teams: was entschieden wurde, wann, von wem, ihr Status und ein Link zu dem Eintrag, der sie erklärt. So kann jeder, auch eine neue Kollegin oder ein KI-Agent, herausfinden, warum die Dinge so sind, ohne herumzufragen.
Was ist ein ADR?
Ein Architecture Decision Record (ADR) ist ein kurzes Dokument für eine wichtige Entscheidung: ihr Kontext, die erwogenen Optionen, die Entscheidung und ihre Folgen, mit Nummer und Status. Das Format stammt aus der Softwarearchitektur und passt für jede Entscheidung, die ein Team festhalten will.
Was bedeutet „ersetzt“?
Eine ersetzte Entscheidung wurde durch eine spätere abgelöst. Sie bleibt unverändert im Protokoll, mit der Nummer des Eintrags, der sie ersetzt hat, und der neue Eintrag sagt, welchen er ersetzt. Nichts wird gelöscht, die Geschichte bleibt wahr.
Wann sollte ein Team einen Entscheidungseintrag schreiben?
Wenn eine Entscheidung schwer rückgängig zu machen ist, wenn mehrere Optionen ernsthaft erwogen wurden, wenn sie die Arbeit eines anderen Teams ändert oder wenn in sechs Monaten jemand nach dem Warum fragen wird. Kleine, umkehrbare Entscheidungen brauchen keinen.
Gehören Entscheidungseinträge zum Code oder zu den Dokumenten?
Teams, die Entscheidungen nur unter Entwicklern teilen, legen sie oft ins Code-Repository. Wenn auch Produkt, Design, Support oder Kunden sie lesen müssen, sind sie in einem gemeinsamen Workspace leichter zu finden. Die Dateien dieser Vorlage funktionieren an beiden Orten.
Kann ich sie außerhalb von Nodary nutzen?
Ja. Die Dateien sind Markdown mit relativen Links: Legen Sie den Ordner in ein Repository, öffnen Sie ihn in Obsidian als Vault oder lesen Sie ihn auf GitHub, mit Diagramm.
Halten Sie jede Entscheidung dort, wo das Team arbeitet.
Importieren Sie die Vorlage in Nodary, und das Protokoll wird zu einer Karte, die Ihrem Team und Ihren KI-Agenten sagt, welche Entscheidungen noch gelten. Kostenlos mit zwei Mitgliedern, einem Projekt und zehn Dokumenten, ohne Kreditkarte.