TL;DR

이 레포지토리는 Codex와 Claude Code에 설치하는 Agent Skill로, 영어 또는 중국어 자연어 요청을 검증된 기술 다이어그램으로 변환한다. 생성 과정은 Diagram Contract, Semantic IR, 스타일 지정, 직교 라우팅, SVG 빌드, 구조 검증, PNG 시각 검토를 거치며 결과물은 SVG, PNG, 오프라인 HTML, GIF로 내보낼 수 있다. 12개 스타일과 14개 UML 유형, RAG·Mem0·Multi-Agent·Tool Call 및 C4·Cloud·Event·Reliability 전용 계약을 제공해 AI 시스템과 인프라 문서 제작에 맞는다. 다만 Codex나 Claude Code 런타임을 전제로 하며, PNG와 GIF 렌더링에는 cairosvg 또는 별도 브라우저·FFmpeg 도구가 필요하다.

핵심 포인트

• 이 레포지토리는 독립 실행형 라이브러리보다 Codex와 Claude Code에 설치하는 Agent Skill이다. 자연어 요청을 Diagram Contract와 Semantic IR로 변환한 뒤 스타일과 라우팅 규칙을 적용해 SVG를 생성한다. 해당 생태계를 이미 사용한다면 별도 DSL 없이 기술 다이어그램을 만드는 용도로 적합하다.
• 렌더링 전후에 구조와 시각 품질을 분리해 검증하는 점이 핵심이다. XML·마커·경로·교차·라벨 배치를 검사한 뒤 PNG를 다시 읽어 clipping과 겹침을 확인하고 기본적으로 최대 두 번만 수정한다. 최종 상태에 `validation: passed`와 `visual_review: passed`를 남겨 모델의 자기평가만으로 완료하지 않는다.
• 12개 시각 스타일과 14개 UML 유형, RAG·Mem0·Multi-Agent·Tool Call 같은 AI/Agent 패턴을 함께 제공한다. 각 노드 형태와 화살표 색상·선 유형이 LLM, Agent, Vector Store, memory read/write, async event 같은 의미를 표현한다. 아키텍처 문서와 GitHub README, C4·Cloud·Event·SRE 검토 자료를 반복적으로 제작할 때 스타일 일관성과 의미 표현을 재사용할 수 있다.
• SVG·1920px PNG·오프라인 HTML·검증된 SVG-to-GIF를 하나의 CLI에서 처리한다. `validate`, `render`, `check`, `export-html`, `animate` 명령이 분리되어 있고 HTML은 외부 네트워크 없이 pan/zoom과 여러 이미지 형식 다운로드를 지원한다. Python 3.9+, cairosvg 또는 rsvg-convert가 필요하며 GIF에는 FFmpeg·Chromium·Puppeteer가 추가로 필요하다.

이미지 분석