Letzte Woche habe ich das Architekturdiagramm eines Kunden geöffnet. Ein schönes Bild, alles akkurat. Und ungefähr so ak…

Letzte Woche habe ich das Architekturdiagramm eines Kunden geöffnet. Ein schönes Bild, alles akkurat. Und ungefähr so aktuell wie die Wetterkarte von gestern.

Denn das System darunter hatte sich längst weiterbewegt. Zwei neue Services, eine Datenbank umgezogen, eine Abhängigkeit, die im Bild gar nicht auftauchte. Niemand hatte gelogen, das Diagramm war beim Kickoff korrekt. Nur war der eben schon ein paar Monate her.. 😅

Also habe ich die echte Architektur erstmal aus dem Code rekonstruiert. Kostet Zeit (und Tokens ;) die niemand eingeplant hatte.

Jetzt mit KI steigt die Geschwindigkeit rasant an: 82% der Entwickler sagen, dass sie damit schneller Code schreiben (Sonar, State of Code 2026). Mehr Tempo beim Code, beim Diagramm weiter Stillstand, die Schere geht immer schneller auseinander. Irgendwann ist das Bild nur noch reine Folklore.

Was tatsächlich hilft, ist unspektakulär: die Architektur als Text ins Repo legen, direkt neben den Code. Versionierbar, im Pull Request reviewbar, im selben Commit wie die Änderung. Kommt ein Service dazu, ändert sich das Modell mit, sonst geht der Pull-Request nicht durch.

Im KI-Zeitalter hat das einen zweiten Vorteil: Ein Textmodell ist LLM-lesbar. Dein Agent kann die Architektur mitschreiben. Den Überblick behält aber trotzdem ein Mensch weil genau da KI unzuverlässig ist.

Wann hat deine Architektur-Doku zuletzt die Wahrheit gesagt?