Entscheidungsprotokoll-Vorlage für Wichtige Technische Entscheidungen (ITDs)

Dies ist die Vorlage für Wichtige Technische Entscheidungen (Important Technical Decisions, ITD), beschrieben in ITDs: a lean ADR for executive technical decision-making at scale - Ignacio Larrañaga.

ITDs sind eine fokussierte Weiterentwicklung von ADRs, optimiert auf Geschwindigkeit, Klarheit und Validierung durch das Management. Während ein ADR dokumentiert, was entschieden wurde, ist ein ITD ein schlankes, entscheidungsorientiertes Artefakt, das die Entscheidung selbst überprüfbar macht, sodass Stakeholder es schnell durchsehen und leicht hinterfragen können. ITDs eignen sich gut für technische Entscheidungen, die nicht streng architektonisch sind, etwa die Wahl eines Modells, einer Bibliothek oder einer CI/CD-Strategie.

Schreiben Sie in jede ITD-Datei diese Abschnitte:

Titel

Nennen Sie die Entscheidung selbst, keine Beschreibung des Themas. Zum Beispiel: „Qwen2.5 1.5B Instruct für die Übersetzung auf dem Gerät verwenden“.

Das Problem

Ein Satz, der angibt, was wir lösen möchten.

Erwogene Optionen

Die Alternativen, die zur Wahl standen, wobei die ausgewählte Option fett hervorgehoben ist.

Begründung

Nur die ausschlaggebenden Faktoren, die zur Wahl geführt haben, keine erschöpfende Liste aller Vor- und Nachteile.

Hinweise

Optional. Zusätzlicher Kontext, der festgehalten werden sollte, etwa Einschränkungen, Annahmen oder Links.