Jedes Projekt sammelt Entscheidungen: warum diese Datenbank, warum diese API-Struktur oder warum ein Leistungskompromiss akzeptiert wurde. Ohne Aufzeichnung muss das nächste Team den Kontext teuer neu entdecken.
Unser Format bleibt bewusst klein. Ein kurzes Dokument erfasst Kontext, verworfene Optionen, Entscheidungsgrund und bekannte Folgen. Es ist datiert, hat einen Verantwortlichen und bleibt auf zwei Seiten begrenzt.
Der Nutzen zeigt sich schnell. Neue Teammitglieder verstehen das Produkt in Tagen statt Wochen. Ein Dienstleisterwechsel wird weniger riskant, und der Kunde bleibt weder von einer Person noch von uns abhängig.
Entscheidungsdokumente altern zusammen mit dem Code. Eine überholte Wahl wird als ersetzt markiert und mit ihrer Nachfolgeentscheidung verknüpft. Die Geschichte bleibt sichtbar, ohne den ursprünglichen Kontext zu verleugnen.
Es ist eine unauffällige Disziplin, die fragile Software in ein Produkt verwandelt, das ein anderes Team sicher betreiben und weiterentwickeln kann.
