https://paul-fleischmann.com/en/categories/bausteinsicht/Recent content in Bausteinsicht on Paul FleischmannHugoenFri, 19 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-projektvorstellung/Thu, 11 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-projektvorstellung/Architecture documentation goes stale faster than code. Architecture-as-Code is the attempt to change that — and Bausteinsicht solves the problem in a way other tools cannot.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-getting-started/Wed, 17 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-getting-started/Install Bausteinsicht, initialize a project, generate the first diagram, and synchronize in both directions — in under 10 minutes.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-datenmodell/Thu, 18 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-datenmodell/All fields and sections of the Bausteinsicht data model: specification, model, views, relationships, and optional extensions such as asIs/toBe, dynamicViews, and constraints.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-bidirektionale-synchronisation/Fri, 19 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-bidirektionale-synchronisation/How the Bausteinsicht sync algorithm works: forward sync, reverse sync, conflict resolution, relationship lifting, and the .bausteinsicht-sync state file.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-multi-view/Sat, 20 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-multi-view/How Bausteinsicht generates multiple diagram perspectives (Context, Container, Component) from a single model — with scope bounding boxes, drill-down links, and back navigation.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-export-features/Sun, 21 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-export-features/Bausteinsicht as an export hub: PNG/SVG via draw.io CLI, PlantUML, Mermaid C4, DOT, D2, HTML5, Structurizr DSL, AsciiDoc/Markdown tables, and sequence diagrams.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-snapshots-changelog/Mon, 22 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-snapshots-changelog/Capture, compare, and restore architecture states with bausteinsicht snapshot — plus changelog for generating an automatic architecture changelog from Git history.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-validation-linting/Tue, 23 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-validation-linting/Define architecture rules as machine-checkable constraints and automatically enforce them in the CI pipeline with bausteinsicht lint + health.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-lsp-integration/Wed, 24 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-lsp-integration/bausteinsicht-lsp brings inline validation, error messages, and CodeLens directly into VS Code — plus JSON Schema as a lightweight alternative without LSP setup.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-llm-ai-workflows/Thu, 25 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-llm-ai-workflows/Bausteinsicht as an LLM-friendly CLI: --format json for machine-readable output, bausteinsicht find and status as context providers for AI assistants like Claude Code.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-adr-integration/Fri, 26 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-adr-integration/Link Architecture Decision Records directly to the Bausteinsicht model: define ADRs in the specification, attach them to elements and relationships, and navigate them with bausteinsicht adr list/show.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-overlay-heatmap/Sat, 27 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-overlay-heatmap/Overlay external metrics like error rate, coverage, or latency as a heatmap onto draw.io elements — and remove them again with a single command.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-graph-analyse/Sun, 28 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-graph-analyse/bausteinsicht graph analyzes the dependency graph: detect cycles, calculate centrality metrics, identify strongly connected components.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-auto-layout/Mon, 29 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-auto-layout/bausteinsicht layout calculates hierarchical auto-layout for draw.io diagrams — with pinning for elements that should remain manually positioned.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-templates/Tue, 30 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-templates/bausteinsicht generate-template creates a draw.io template file with visual styles for all element types — in four presets: default, c4, minimal, dark.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-workspace/Wed, 01 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-workspace/Combining multiple team models with a workspace.jsonc: workspace merge, validate and list — plus cross-model relationships between subsystems.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-sequenzdiagramme/Thu, 02 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-sequenzdiagramme/Define dynamic views in architecture.jsonc and export them as PlantUML or Mermaid sequence diagrams using bausteinsicht export-sequence.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-cli-modellierung/Fri, 03 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-cli-modellierung/Add elements, relationships, views, and specification types directly to the model via the command line — without manually editing the JSONC file.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-health-score/Sat, 04 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-health-score/bausteinsicht health evaluates the architecture in five categories and produces a score from 0–100 plus a grade from A+ to F — for dashboards, PRs, and architecture reviews.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-element-lifecycle/Sun, 05 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-element-lifecycle/The status field in Bausteinsicht elements: managing proposed through archived in the model, filtering with bausteinsicht status, and evaluating results in the Health Score.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-as-is-to-be/Mon, 06 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-as-is-to-be/asIs and toBe sections in architecture.jsonc for migration planning — and bausteinsicht diff for an annotated comparison of the current and target architecture.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-find-show/Tue, 07 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-find-show/bausteinsicht find searches the model by free text — bausteinsicht show displays all details of an element including relationships and views.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-tags-view-filterung/Wed, 08 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-tags-view-filterung/Define tags in specification.tags, assign them to elements, and populate views precisely with filter-tags and exclude-tags — without listing every element individually in include.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-cicd-integration/Thu, 09 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-cicd-integration/Bausteinsicht in GitHub Actions: validate as a build gate, diff as a PR comment, and automatic SVG export — with complete workflow YAMLs ready to copy-paste.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-migration/Fri, 10 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-migration/Migrating existing architecture documentation to Bausteinsicht: what works automatically for draw.io, PlantUML C4, and Structurizr, what needs to be transferred manually, and why a view-by-view strategy works better than a big bang.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-team-workflows/Sat, 11 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-team-workflows/Multiple people on the same model: which parts of the JSONC are merge-friendly, how ownership conventions prevent conflicts, and what an architecture review looks like in a pull request.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-custom-notations/Sun, 12 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-custom-notations/Beyond C4: defining custom element types with custom shapes in draw.io — using an AUTOSAR notation and an embedded hardware notation as examples.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-performance/Mon, 13 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-performance/Bausteinsicht with 50+ elements: when you need focused views instead of an overview, how to split a grown model into subsystems, and when the Workspace feature is the right solution.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-structurizr-big-bank-beispiel/Tue, 14 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-structurizr-big-bank-beispiel/Migrating the Big Bank Example by Simon Brown (Structurizr) to Bausteinsicht in three steps — using bausteinsicht import --from structurizr, a full walkthrough of the generated JSONC, and the visual result.https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-multi-view-design/Wed, 15 Jul 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/bausteinsicht-multi-view-design/The same JSONC model, seven different diagrams: how to generate focused views for the security team, mobile developers, and stakeholders from a single Big Bank model — without duplicating the model.https://paul-fleischmann.com/en/projekte/bausteinsicht/Sun, 28 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/Articles on my Architecture-as-Code tool Bausteinsichthttps://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/Sun, 28 Jun 2026 00:00:00 +0000https://paul-fleischmann.com/en/projekte/bausteinsicht/tutorial/Step-by-step posts covering all features of Bausteinsicht