DocToolchain

Architekturdokumentation veraltet schneller als Code. Architecture-as-Code ist der Versuch, das zu ändern — und Bausteinsicht löst das Problem auf eine Weise, die andere Tools nicht können.

Bausteinsicht installieren, ein Projekt initialisieren, das erste Diagramm generieren und in beide Richtungen synchronisieren — in unter 10 Minuten.

Alle Felder und Sektionen des Bausteinsicht-Datenmodells: specification, model, views, relationships und optionale Erweiterungen wie asIs/toBe, dynamicViews und constraints.

Wie der Bausteinsicht-Sync-Algorithmus funktioniert: Forward-Sync, Reverse-Sync, Konfliktauflösung, Relationship-Lifting und die .bausteinsicht-sync State-Datei.

Wie Bausteinsicht mehrere Diagrammperspektiven (Context, Container, Component) aus einem einzigen Modell erzeugt — mit Scope-Bounding-Boxes, Drill-Down-Links und Rücknavigation.

Bausteinsicht als Exportzentrale: PNG/SVG via draw.io CLI, PlantUML, Mermaid C4, DOT, D2, HTML5, Structurizr DSL, AsciiDoc/Markdown-Tabellen und Sequenzdiagramme.

Architekturzustände mit bausteinsicht snapshot festhalten, vergleichen und wiederherstellen — plus changelog für automatisches Architektur-Changelog aus der Git-History.

Architekturregeln als maschinenprüfbare Constraints definieren und mit bausteinsicht lint + health automatisch in der CI-Pipeline durchsetzen.

bausteinsicht-lsp bringt Inline-Validierung, Fehlermeldungen und CodeLens direkt in VS Code — plus JSON Schema als schlanke Alternative ohne LSP-Setup.

Bausteinsicht als LLM-freundliche CLI: --format json für maschinenlesbare Ausgabe, bausteinsicht find und status als Kontext-Lieferanten für KI-Assistenten wie Claude Code.

Architecture Decision Records direkt im Bausteinsicht-Modell verknüpfen: ADRs in der Specification definieren, an Elemente und Beziehungen hängen, und mit bausteinsicht adr list/show navigieren.

Externe Metriken wie Error-Rate, Coverage oder Latenz als Heatmap auf draw.io-Elemente legen — und mit einem Befehl wieder entfernen.

bausteinsicht graph analysiert den Abhängigkeitsgraphen: Zyklen erkennen, Zentralitätsmetriken berechnen, stark zusammenhängende Komponenten identifizieren.

bausteinsicht layout berechnet hierarchisches Auto-Layout für draw.io-Diagramme — mit Pinning für Elemente die manuell positioniert bleiben sollen.

bausteinsicht generate-template erstellt eine draw.io-Template-Datei mit visuellen Stilen für alle Element-Typen — in vier Presets: default, c4, minimal, dark.

Mehrere Team-Modelle mit einer workspace.jsonc kombinieren: workspace merge, validate und list — plus Cross-Model Relationships zwischen Teilsystemen.

Dynamische Views in architecture.jsonc definieren und mit bausteinsicht export-sequence als PlantUML oder Mermaid-Sequenzdiagramm exportieren.

Elemente, Beziehungen, Views und Spezifikationstypen direkt über die Kommandozeile zum Modell hinzufügen — ohne die JSONC-Datei manuell zu editieren.

bausteinsicht health bewertet die Architektur in fünf Kategorien und gibt einen Score von 0–100 plus Note A+ bis F — für Dashboards, PRs und Architektur-Reviews.

Das status-Feld in Bausteinsicht-Elementen: proposed bis archived im Modell verwalten, mit bausteinsicht status filtern und im Health Score auswerten.

asIs und toBe Sektionen in architecture.jsonc für Migrationsplanung — und bausteinsicht diff für den annotierten Vergleich von Ist- und Zielarchitektur.

bausteinsicht find durchsucht das Modell per Freitext — bausteinsicht show zeigt alle Details eines Elements inklusive Beziehungen und Views.

Tags in specification.tags definieren, Elementen zuweisen und Views mit filter-tags und exclude-tags präzise befüllen — ohne jedes Element einzeln in include aufzulisten.

Bausteinsicht in GitHub Actions: validate als Build-Gate, diff als PR-Kommentar und automatischer SVG-Export — mit vollständigen Workflow-YAMLs zum Copy-Pasten.

Bestehende Architekturdokumentation zu Bausteinsicht migrieren: was bei draw.io, PlantUML-C4 und Structurizr automatisch geht, was manuell überführt werden muss, und warum eine View-by-View-Strategie besser funktioniert als ein Big Bang.

Mehrere Personen am gleichen Modell: welche Teile des JSONC merge-freundlich sind, wie Ownership-Conventions Konflikte vermeiden, und wie ein Architektur-Review im Pull Request aussieht.

Über C4 hinaus: eigene Elementtypen mit eigenen Shapes in draw.io definieren — am Beispiel einer AUTOSAR-Notation und einer Embedded-Hardware-Notation.

Bausteinsicht mit 50+ Elementen: wann braucht man fokussierte Views statt einer Gesamtansicht, wie teilt man ein gewachsenes Modell in Subsysteme auf, und wann ist das Workspace-Feature die richtige Lösung.

Das Big Bank Example von Simon Brown (Structurizr) in drei Schritten nach Bausteinsicht migrieren — mit bausteinsicht import --from structurizr, vollständigem Walkthrough des generierten JSONC und visuellem Ergebnis.

Dasselbe JSONC-Modell, sieben verschiedene Diagramme: wie man aus einem Big Bank Modell fokussierte Views für Security-Team, Mobile-Entwickler und Stakeholder erzeugt — ohne das Modell zu duplizieren.

Ich durfte beim Start von Bausteinsicht dabei sein — als Beta-Tester, Issue-Author, und als jemand, der in zwei Tagen 33 Features mit Claude Code umgesetzt hat. Aber was macht das Tool eigentlich unter der Haube?

Ich durfte beim Start von Bausteinsicht dabei sein — als Beta-Tester, Issue-Author, und als jemand, der in zwei Tagen 33 Features mit Claude Code umgesetzt hat. Aber was macht das Tool eigentlich unter der Haube?