Post by Marcel Sinemus · 2026-10-11
===================================

📐 Diagrams as Code trifft KI: Diagramme pflegen statt zeichnen

Während meiner Vorbereitung auf den und im Kurs 🎓 zum Certified Professional for
  Requirements Engineering (IREB, FL) habe ich Diagramme deutlich intensiver und
  auch aus einer anderen Perspektive kennengelernt. Besonders spannend war es,
  anhand von User Stories eigene Diagramme zu interpretieren und auch zu
  erstellen – so wurde schnell klar, wie stark eine gute Visualisierung das
  gemeinsame Verständnis verbessert. 🧩

Auch in der Zusammenarbeit mit Git und GitLab konnte ich mit Mermaid
  experimentieren. Der Vorteil gegenüber MS Visio oder draw\.io liegt für mich
  klar in der Versionierung: Diagramme liegen als Text im Repository, sind im
  Diff nachvollziehbar und lassen sich direkt mit dem Code weiterentwickeln. 🔄

Daher war die Folge mit Jacqui Read für mich besonders interessant: Genau um
  diese Verbindung ging es – und um den Einsatz von KI:

🛠️ #PlantUML, Mermaid und Structurizr haben unterschiedliche Stärken

🧩 Structurizr bietet ein Modell hinter den Diagrammen und unterstützt
  konsistente Sichten

🤖 KI kann Diagramme erstellen, konvertieren und korrigieren – aber kein Ersatz
  für Fachwissen sein

⚠️ Zu allgemeine Prompts führen schnell zu Halluzinationen; präzise Fragen und
  Review bleiben entscheidend

📊 C4 zeigt Struktur, Sequenz- und Aktivitätsdiagramme kommunizieren Verhalten

📝 Diagramme können in Spec-driven Development Kontext liefern und das
  Verständnis validieren

Mein Fazit: Diagrams as Code macht Architektur-Kommunikation wartbarer, und KI
  kann den Weg dorthin beschleunigen. Vertrauen entsteht aber nicht durch den
  Output – sondern durch Prüfung. ✅

Und: Hier gibt es bei mir auch noch mehr Potential zu lernen Diagramme selber zu
  erstellen. Nur so kann ich das Ergebnis einer KI auch überprüfen 😉

👉 Hier geht es zur Folge:

https://software-architektur.tv/2025/11/25/diagrams-as-code-with-ai-with-jacqui-read.html

\#SoftwareArchitecture #DiagramsAsCode #AI #LLM #Mermaid #PlantUML #Structurizr
  #C4Model #SpecDrivenDevelopment #RequirementsEngineering #Softwarearchitektur
  #KI #Architekturdokumentation #Git #GitLab

🤖 Transparenz-Hinweis: Dieser Beitrag wurde mit Unterstützung eines
  KI-Assistenten erstellt. Die Inhalte, Erfahrungen und Empfehlungen basieren
  auf meiner eigenen Praxis – die Formulierungshilfe kam von meinem digitalen
  Kollegen. 😉

Tags: SpecDrivenDevelopment, RequirementsEngineering, Architekturdokumentation

Likes: 0 · Reposts: 1 · Bookmarks: 0 · Reactions from other networks: 1
  (@simsus@social.tchncs.de shared this) · Already counted in the numbers above.

--
vutuv agent document · type: post · schema_version: 3
generated_at: 2026-10-11T23:12:12Z
canonical: https://vutuv.de/sinemus/posts/01a12b78-25de-7f3f-a620-0c04e1c90628
noai: true