다이어그램-애즈-코드 (Diagrams as Code)

개요

다이어그램-애즈-코드(Diagrams as Code, DaC)는 다이어그램을 그래픽 편집기에서 손으로 그리는 대신, 텍스트·코드·구조화된 명세로 정의하고 렌더링으로 시각화하는 접근법이다.^[https://tt-a1i.github.io/archify/]

이 패러다임의 핵심 이점은 버전 관리 친화성, 재현성, 자동화 가능성, 그리고 최근에는 AI 에이전트가 다이어그램을 생성하고 검증할 수 있다는 점이다.

평문 설명으로부터 검증 가능한 대화형 기술 다이어그램을 생성하는 에이전트 스킬.^[https://tt-a1i.github.io/archify/]

5가지 다이어그램 유형: Architecture, Workflow, Sequence, Dataflow, Lifecycle
자체 완결 HTML 출력 (zero dependency)
9가지 아티팩트 검증, deliver로 SHA-256 증거 동결
Mermaid(flowchart/graph/sequenceDiagram/stateDiagram) 입력 수용 → Archify JSON으로 재-author
Cursor, Claude Code, Codex CLI, OpenCode 지원
Cocoon-AI/architecture-diagram-generator v1.0의 포크·리라이트

→ archify 참조.

마크다운 친화적인 다이어그램 문법으로, GitHub·GitLab·Obsidian 등에서 폭넓게 지원된다.^[https://tt-a1i.github.io/archify/]

Archify는 Mermaid 입력을 수용하지만, 스타일만 복사하지 않고 의미를 살려 Archify JSON으로 재-author한다.^[https://github.com/tt-a1i/archify/blob/main/archify/SKILL.md]

시퀀스 다이어그램, 유스케이스, 클래스 다이어그램, 상태 다이어그램 등을 텍스트로 정의하는 성숙한 도구.^[https://tt-a1i.github.io/archify/]

Archify와 같은 도구에서 특히 주목할 점은 검증 가능한 산출물 개념이다.^[https://github.com/tt-a1i/archify/blob/main/archify/SKILL.md]

이는 LLM이 생성한 다이어그램의 사실성 이슈를 검사·증거 동결·브라우저 검증의 3층 구조로 접근하는 패턴을 보여준다.^[https://github.com/tt-a1i/archify/blob/main/archify/SKILL.md]

description	코드·텍스트·구조화된 명세로부터 다이어그램을 생성하는 패러다임과 Archify, Mermaid, PlantUML 등 텍스트-투-다이어그램 도구군을 묶는 개념 노트.
tags	dev-tools, diagrams, software-architecture, ai-coding
aliases	diagrams as code, diagram-as-code, 다이어그램 코드