ar-diagram

Architecture diagrams as code translate system design requests into Markdown with Mermaid and a DrawIO file. This approach supports AWS, GCP, and Azure icons, enabling version-controlled, diffable diagrams rather than hand-drawn sketches.

Creating version-controlled system design diagrams is best achieved using diagrams-as-code. This workflow outputs Markdown and DrawIO files, allowing you to track changes in Git and render architectures directly on GitHub and diagrams.net.

Mermaid and PlantUML are supported for diagramming distributed systems and data pipelines. The workflow selects the right tool among Mermaid, PlantUML, D2, Graphviz, and Python diagrams to represent your architecture and exports both .md and .drawio files.

To diagram a RAG inference pipeline using diagrams-as-code, provide a description of your system. The workflow clarifies requirements, selects an appropriate tool like Mermaid or Graphviz, generates the diagram, and performs sanity checks before delivering the files.

This diagrams-as-code workflow supports both DrawIO and Markdown outputs. Each request generates a Markdown file containing a Mermaid diagram and a separate DrawIO .drawio file, enabling rendering across GitHub and diagrams.net platforms.