YAMLtecture v0.2.0 was released on March 31, 2025. This update focuses on bringing greater consistency to your architectural visualizations and expanding the power of your queries, ensuring that your “architecture as code” remains clean, predictable, and easy to manage.

What’s new

  • Subgraph Node Labels: You can now add descriptive labels to subgraph nodes in your Mermaid diagrams, making complex architectural groupings much easier to understand at a glance.
  • The exists Query Operator: Querying your architecture just got more flexible. The new exists operator allows you to filter nodes and links based on the presence of a specific attribute, regardless of its value.
  • Deterministic Mermaid Output: We’ve implemented sorting for node styles and IDs. No more random shifts in your Mermaid source code between runs—your diagrams are now stable and version-control friendly.
  • Comprehensive Documentation Overhaul: We’ve completely rewritten the core documentation (Commands, Configuration, Mermaid, and Query) to provide clearer guidance and better onboarding.

Why it matters

For architects managing large systems, consistency is key. By making Mermaid output deterministic, YAMLtecture now produces clean diffs in Git, removing the noise of arbitrary ordering. Combined with the new exists operator and better subgraph labeling, you have more precision over how you analyze and present your system architecture. Furthermore, the improved validation and error messaging mean less time spent guessing why a YAML file failed and more time spent designing.

Upgrade and Installation

Upgrading to v0.2.0 is simple. You can download the latest pre-compiled executable for your platform from the GitHub Releases page, or install it directly via Go:

go install github.com/UnitVectorY-Labs/YAMLtecture@latest

Transparency Note: This post was AI-generated using the model unsloth/gemma-4-31B-it-GGUF:UD-Q5_K_XL. Reference: UnitVectorY-Labs/YAMLtecture, Release v0.2.0. Generated on: 2026-04-09. Author: release-storyteller