Architecture Decision Records¶
Jedes Projekt akkumuliert Entscheidungen. Die meisten davon werden nie dokumentiert: in Gesprächen getroffen, aus Code abgeleitet oder schlicht vergessen. Das funktioniert -- bis etwas schiefläuft, jemand Neues verstehen muss, warum das System so verhält wie es tut, oder eine Änderung ansteht und die ursprüngliche Begründung nicht mehr auffindbar ist. Dann wird sichtbar, was es kostet, Dinge nicht aufzuschreiben.
Ein Architecture Decision Record ist ein kurzes Dokument, das eine strukturelle Entscheidung vor ihrer Umsetzung festhält: Was wurde entschieden, warum, welche Alternativen wurden erwogen und welche Konsequenzen folgen daraus. Der Eintrag kommt vor dem Code. Ich schreibe die Entscheidung auf, prüfe sie gegen das Bestehende und gehe erst dann weiter. Das ist kein schwerer Prozess. Ein einzelner ADR ist selten länger als eine Seite. Die Disziplin liegt in der Reihenfolge, nicht im Umfang.
In der Praxis bedeutet das: Das io-architecture Repository enthält 10 ADRs, die Entscheidungen von der Auswahl der Control Plane bis hin zu Context Assembly, Audit Gate Design und Memory Persistence Policy abdecken. Dieses KnowledgeHub verfügt über ein eigenes Governance-Repository, in dem jede wesentliche strukturelle Entscheidung, von Typografie bis bilingualer Unterstützung bis Informationsarchitektur, dokumentiert wird, bevor sie umgesetzt wird. Die gesperrte Taxonomie der Prompt Pattern Library folgt demselben Prinzip: Die Klassifikation wurde festgelegt und schriftlich fixiert, bevor ein einziges Pattern dagegen verfasst wurde.
Der vollständige ADR-Index des IO-III Architecture-Projekts sowie das Governance-Repository dieses KnowledgeHubs sind auf GitHub verfügbar.