Inhaltsverzeichnis
Das Wichtigste in Kürze
- Diagram Drift entsteht, weil Dokumentation als Nacharbeit behandelt wird – nicht als Teil des Arbeitsprozesses
- Diagram as Code hält Diagramme aktuell, weil sie als versionierte Textdateien direkt im Projekt leben
- KI kann nur mit aktuellen, maschinenlesbaren Informationen arbeiten – veraltete PNGs und Word-Dokumente sind nutzlos
- Mermaid ist der einfachste Einstieg: kostenlos, keine Registrierung, direkt in GitHub und VS Code nutzbar
- Eine strukturierte Wissensbasis ist die Voraussetzung für jeden erfolgreichen KI-Einsatz im Unternehmen
Die Idee ist dokumentiert - irgendwo. Das System, das Sie gebaut haben, stimmt nicht mehr mit dem überein, was damals aufgezeichnet wurde. Jemand Neues fragt, wie das eigentlich zusammenhängt, und die ehrliche Antwort lautet: „Das weiß eigentlich nur die Person, die das gebaut hat.”
Ob Zwei-Personen-Startup oder etabliertes Unternehmen mit einem kleinen IT-Team: Das Problem ist dasselbe. Es hat einen Namen: Diagram Drift — der Zustand, in dem Dokumentation und Realität auseinanderdriften, weil niemand Zeit hat, beides synchron zu halten.
Dieser Artikel zeigt, was dagegen hilft, welche Tools existieren, und warum das Thema direkt mit der Frage zusammenhängt, ob KI in Ihrem Unternehmen jemals sinnvoll arbeiten kann.
Dokumentation wird immer als Nacharbeit behandelt
Egal ob Startup oder KMU, egal ob agil oder klassisch projektiert: Dokumentation landet auf der To-do-Liste, nicht im Arbeitsprozess. Sie wird gemacht, wenn Zeit ist. Zeit ist nie.
Das Ergebnis kennen Sie. Das Systemdiagramm aus dem letzten Jahr zeigt die alte Datenbankstruktur. Das Prozessdokument endet nach drei Absätzen. Das implizite Wissen, wie das alles wirklich zusammenhängt, lebt im Kopf von einer oder zwei Personen.
Für Gründerinnen und Gründer ist das besonders kritisch: Die Ausrichtung eines Projekts ändert sich schnell. Ein Pivot, ein neuer Kundenwunsch, eine technische Entscheidung — und die Dokumentation von gestern ist die Fehlerquelle von morgen. Wer ohne aktuelles Lagebild baut, versinkt im Chaos, auch wenn das Produkt eigentlich gut ist.
Die Lösung liegt nicht in mehr Disziplin oder besseren Prozessen. Sie liegt darin, Dokumentation technisch mit der Arbeit zu verknüpfen, statt sie daneben zu stellen.
Was Diagram as Code ist — in einem Satz
Statt Diagramme zu zeichnen, beschreiben Sie sie in einfachem Text. Ein Tool übersetzt diesen Text automatisch in eine visuelle Darstellung.
Das bedeutet: Das Diagramm lebt als Textdatei direkt neben dem Code oder dem Projektdokument. Es wird versioniert — genauso wie souveräne IT-Infrastruktur funktioniert: Kontrolle über eigene Systeme behalten. Es lässt sich mit wenigen Zeilen anpassen. Es veraltet nicht, weil die Anpassung keine separate Aufgabe mehr ist — sie ist Teil des Arbeitsschritts selbst.
Für nicht-technische Unternehmer ist das Ergebnis dasselbe: Prozessabläufe, Systemstruktur, Datenbankdesign — alles in einem Format, das lesbar, aktuell und teilbar ist. Kein separates Tool öffnen, kein PNG exportieren, kein „ich schick dir das Diagramm noch per Mail”.
Die Tools auf einen Blick
| Tool | Lizenz | Einstieg | Am besten für |
|---|---|---|---|
| Mermaid | MIT (kostenlos, auch kommerziell) | Sehr einfach | Alle, die mit Markdown oder GitHub arbeiten |
| D2 | MPL 2.0 (kostenlos, kommerziell nutzbar) | Einfach–Mittel | Teams, die mehr visuelle Kontrolle wollen |
| PlantUML | GPL 3.0 (kostenlos, Copyleft beachten) | Mittel–Schwer | Enterprise-Teams mit formalen UML-Anforderungen |
| Structurizr DSL | Apache 2.0 (kostenlos) | Schwer | IT-Architekturteams mit C4-Modell-Ansatz |
| Draw.io | Apache 2.0 (kostenlos) | Sehr einfach | Nicht-technische Teams, visuelle Drag & Drop-Lösung |
Empfehlung für den Einstieg: Mermaid. Kostenlos, keine Registrierung, läuft direkt in GitHub und VS Code, und jede KI kann den Code nativ generieren und lesen. Wer Mermaid in 30 Minuten ausprobieren will: mermaid.live — kein Account, kein Download.
Warum das der erste Schritt vor jedem KI-Einsatz ist
Hier wird das Thema strategisch.
Viele Unternehmen fragen sich gerade, wie sie KI sinnvoll einsetzen können — Copilot, interne Chat-Assistenten, automatisierte Workflows. Die Antwort auf diese Frage hängt von einer Vorfrage ab, die selten gestellt wird:
Auf welche Informationen soll die KI zugreifen?
Eine KI ist nur so gut wie die Daten, mit denen sie arbeitet. Ein PNG-Diagramm kann sie nicht lesen — genau deshalb braucht KI im Arbeitsalltag strukturierte, maschinenlesbare Informationen als Grundlage. Eine PowerPoint kann sie nicht interpretieren. Ein drei Jahre altes Word-Dokument, das niemand mehr pflegt, ist für sie irrelevant.
Was KI braucht, ist genau das, was gutes Projektmanagement ohnehin braucht — und was RAG-Systeme voraussetzen: strukturierte, versionierte Wissensdatenbanken.
- Informationen in Textform, versioniert und auffindbar
- Dokumente, die aktuell sind und sich einfach anpassen lassen
- Eine einzige Quelle der Wahrheit — nicht fünf Kopien in fünf Ordnern
- Struktur, die ohne Erklärung verständlich ist
Eine digitale Wissensbasis des Unternehmens — versioniert, maschinenlesbar, aktuell — ist die Grundlage, auf der KI tatsächlich arbeiten kann. Ohne diese Grundlage wird jeder KI-Einsatz teurer und enttäuschender als erwartet.
Der Nebeneffekt ist nicht zu unterschätzen: Wenn alle Prozesse, Entscheidungen und Systemstrukturen in einer zentralen, lesbaren Wissensbasis liegen, wissen auch alle Mitarbeiterinnen und Mitarbeiter, wo sie nachschauen sollen. Nicht im Kopf der Gründerin. Nicht in der E-Mail vom letzten Quartal. Sondern dort.
Diagram as Code ist dabei kein Selbstzweck. Es ist ein Werkzeug für eine breitere Strategie: das Unternehmen so zu dokumentieren, dass Wissen nicht in Personen gebunden ist — sondern in Systemen.
Die zwei Situationen, in denen das konkret zählt
Wenn ein Unternehmen gerade aufgebaut wird: Die Ausrichtung ändert sich schnell. Ein Pivot kostet nicht nur Zeit — er kostet die Übersicht, wenn die Dokumentation nicht mitgewachsen ist. Wer von Anfang an in aktualisierbaren Strukturen denkt, baut auf einem Fundament, das Veränderung aushält, statt ihr zu widerstehen.
Wenn KI konkret eingesetzt werden soll: Interne Assistenten, automatisierte Workflows, KI-gestützte Entscheidungshilfen — all das setzt voraus, dass Sie Ihre eigenen Prozesse, Produkte und Strukturen in einer Form beschrieben haben, die eine Maschine verarbeiten kann. Wer das nicht hat, kauft ein Werkzeug ohne Material.
Nächste Schritte
Sie wollen wissen, wie Ihre aktuelle Dokumentationsstruktur aufgestellt ist und welche konkreten nächsten Schritte sinnvoll wären? Strukturaflow ist spezialisiert auf die Optimierung digitaler Unternehmensprozesse — mit dem Ziel: maximale Effizienz, volle Klarheit über Kosten und Ressourceneinsatz. Buchen Sie ein kostenloses Beratungsgespräch.
Weiterführende Ressourcen:
- mermaid.live — Mermaid ausprobieren, kostenlos, kein Account
- mermaid.js.org — Vollständige Dokumentation
- d2lang.com — D2 als Alternative
- diagrams.net — Draw.io für nicht-technische Einstiege