On March 19, 2025, we are excited to announce the launch of YAMLtecture, a lightweight CLI tool that brings the “Architecture as Code” philosophy to life. YAMLtecture empowers architects to define, manage, and visualize complex system architectures using simple, modular YAML files.

Core Capabilities

YAMLtecture provides a robust set of tools to bridge the gap between conceptual design and visual documentation:

  • YAML-based Definition: Map your system’s components (nodes) and their interactions (links) using a clean, structured format that is easy to version control and maintain.
  • Hierarchical Mapping: Support for parent-child relationships allows you to create acyclic tree hierarchies, mirroring the natural organization of complex systems.
  • Dynamic Visualization: Automatically transform your YAML definitions into professional Mermaid flowcharts, removing the need for manual drawing tools.
  • Precision Querying: Instead of dealing with overwhelming “everything” diagrams, use a powerful querying system with operators like ancestorOf, descendantOf, and logical and/or to extract specific subsets of your architecture for targeted use cases.
  • Visual Customization: Maintain full control over your output with support for custom node colors, stroke widths, font sizes, and subgraphs to ensure your diagrams are as clear as your definitions.

Why it Matters

Modern software systems have grown too complex to be captured in a single, static image. When architecture is trapped in a drawing tool, it quickly becomes outdated and disconnected from the actual implementation.

YAMLtecture solves this by treating architecture as data. By separating the definition (the “what”) from the visualization (the “how”), you maintain a single source of truth. Whether you need a high-level executive overview or a deep-dive into a specific subsystem, you can generate the exact view you need using queries, ensuring your documentation is always accurate, modular, and scalable.

Get Started

Ready to start mapping your system? YAMLtecture is available now. You can download pre-compiled binaries for macOS, Linux, and Windows from our GitHub Releases page, or install it directly using Go:

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

We can’t wait to see the architectures you build with YAMLtecture.

This post was AI-generated. The model used was unsloth/gemma-4-31B-it-GGUF:UD-Q5_K_XL. Reference: UnitVectorY-Labs/YAMLtecture release v0.1.0, generated on 2026-04-09. Author: release-storyteller