Bausteinsicht is an architecture-as-code tool from the docToolchain ecosystem. You describe your building blocks in a JSON model and Bausteinsicht keeps diagrams in sync — with bidirectional draw.io editing — and exports them as C4-PlantUML, Mermaid, DOT, D2, Structurizr DSL, AsciiDoc/Markdown tables and PNG/SVG for embedding in your documentation. Every command supports --format json, so LLM agents can read and write the model too.

This task does two things:

The task needs internet access to download the release from GitHub.

By default the latest release is installed. To pin a specific version, set DTC_BAUSTEINSICHT_VERSION:

The binary is installed to $HOME/.doctoolchain/bin. If that directory is not on your PATH, the task prints the exact command to add it so you can call bausteinsicht directly.

When an AGENTS.md or CLAUDE.md exists in the project root, the task upserts a short Markdown section into it (anchored on its heading, so re-running replaces it in place rather than duplicating it). The hint is deliberately conditional — it tells the agent to reach for Bausteinsicht only when creating or changing architecture diagrams, and to run bausteinsicht --help first so the guidance never goes stale.

If neither file exists, the task installs the tool and skips the hint (it never creates an agent file you did not ask for).

View the source of this task: scripts/installBausteinsicht.groovy on GitHub