Architecture Decision Record (ADR)

Ein kurzes Dokument, das eine einzelne architektonisch bedeutsame Entscheidung, ihren Kontext und ihre Konsequenzen festhält.

Was ist Architecture Decision Record (ADR)?

Ein ADR macht eine Entscheidung für künftige Teammitglieder nachvollziehbar. Es hält typischerweise den Kontext fest (welche Kräfte im Spiel waren), die Entscheidung, die in Betracht gezogenen Alternativen und die Konsequenzen (die Kompromisse, mit denen man nun lebt). ADRs werden gemeinsam mit dem Code versioniert und werden abgelöst statt bearbeitet — die Geschichte des Denkens ist genauso wertvoll wie die aktuelle Antwort.

Auch bekannt als: adr.

Verwandte Begriffe

  • Architektur-Drift — Die wachsende Kluft zwischen der dokumentierten Architektur und dem System, das tatsächlich in Produktion läuft.
  • Living Documentation — Dokumentation, die aus dem laufenden System generiert oder validiert wird, sodass sie genau bleibt, während sich das System weiterentwickelt.

Mehr erfahren