← Zurück zum Lernbereich
Nugget · Engineering

Entscheidungen festhalten (ADRs)

Warum 'weil wir das so machen' nicht reicht

5 Min · Einsteiger

Architecture Decision Records in fünf Minuten verstehen. Das Gedächtnis deines Codebases.

01

Das Problem mit dem Archiv im Kopf

Sechs Monate nach der Entscheidung fragt jemand 'Warum Postgres und nicht Mongo?'. Und niemand weiß es mehr. ADRs beantworten die Frage, bevor sie gestellt wird.

02

Ein ADR, eine Seite

Kontext, Entscheidung, Alternativen, Konsequenzen. Vier Abschnitte, keine zwanzig Seiten. Ein ADR, der länger braucht als die Entscheidung selbst, ist zu lang.

03

Im Repo, nicht im Wiki

ADRs leben neben dem Code, den sie betreffen: docs/adr/0001-datenbank-wahl.md. Versioniert, reviewbar, unvergesslich.

Ein Nugget, eine Idee: Wende sie heute noch einmal an. Wissen wird erst durch Wiederholung zu Können.