embarc logo
embarc logo

KI braucht Architektur: Warum Docs-as-Code jetzt unverzichtbar wird

Folien zum Vortrag von Falk Sippach beim Softwarearchitektur Meetup Nürnberg

 
 

KI braucht Architektur: Warum Docs-as-Code jetzt unverzichtbar wird
Sprecher: Falk Sippach
Software Architektur Meetup Nürnberg
Dienstag, 16. September 2026, 18:30 Uhr
Nürnberg

Foliendownload (PDF)

Abstract

Conference Logo

Architekturdokumentation ist in vielen Projekten wichtig, aber oft schwer auffindbar, veraltet oder zu weit vom Entwicklungsalltag entfernt. Gleichzeitig halten KI-Werkzeuge und LLMs Einzug in Softwareentwicklung, Reviews und Wissensarbeit. Und sie brauchen dafür verlässlichen Kontext. Genau hier entsteht ein Problem: Wenn Architekturwissen nur implizit in Köpfen, Tickets, Chats oder verstreuten Wikis existiert, kann KI es nicht sinnvoll nutzen. Im schlimmsten Fall erzeugt sie plausible, aber falsche Antworten über Architekturentscheidungen, Qualitätsziele, Schnittstellen oder Systemgrenzen.

Docs-as-Code bietet eine pragmatische Grundlage: Architekturwissen liegt nahe am Code, ist versioniert, review- und automatisierbar. ADRs, arc42-Dokumentation, C4-Diagramme, OpenAPI-Spezifikationen und Architekturregeln können so nicht nur von Menschen gelesen, sondern auch als Kontext für LLMs genutzt werden. Der Vortrag zeigt, wie KI bei Architekturdokumentation konkret helfen kann: beim Formulieren und Reviewen von ADRs, beim Zusammenfassen technischer Diskussionen, beim Erkennen veralteter Dokumentation und beim Ableiten prüfbarer Architekturregeln. Denn KI ersetzt Architekturdokumentation nicht – sie macht gute, strukturierte und überprüfbare Dokumentation wichtiger denn je.