Communitygithub.com

lnardev/diagram-design

출판 수준의 편집 아키텍처, 시스템 흐름, 데이터 파이프라인 및 시퀀스 다이어그램을 인라인 SVG와 CSS가 포함된 독립형 HTML 파일로 생성합니다.

diagram-design란 무엇인가요?

이 스킬은 개발자가 출판 가능한 고품질 다이어그램을 독립형 HTML 파일로 생성할 수 있도록 지원합니다. 특히, 인라인 SVG와 CSS를 사용하여 외부 종속성 없이 바로 사용할 수 있는 시각 자료를 제작하는 데 초점을 맞춥니다. 기본적인 다이어그램 도구가 제공하는 진부한 디자인(예: 짙은 청록색 글로우, 대각선 커넥터)을 피하고, 4px 그리드, 직각 커넥터, 엄격한 색상 팔레트 및 타이포그래피 규칙을 통해 편집적이고 전문적인 미학을 구현합니다. 이 스킬은 시스템 아키텍처, 데이터 파이프라인, 시퀀스 다이어그램을 문서화해야 하는 모든 개발자에게 유용하며, Claude Code, Cursor, Codex 등 Markdown 및 코드 생성을 지원하는 AI 에이전트 플랫폼과 호환됩니다. `references/template.md` 파일을 참조하여 표준화된 SVG 구조를 사용하며, 병목 지점, 외부 시스템, 기능 영역(영역) 등을 시각적으로 구분하는 명확한 지침을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lnardev/lean-agent-harness/tree/HEAD/skills/diagram-design

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

편집형 다이어그램 디자인

깔끔하고 출판 수준의 다이어그램을 단일 자체 포함 HTML 파일(인라인 SVG + CSS)로 생성합니다. 일반적인 짙은 청록색 글로우, 기본 Mermaid 레이아웃 또는 대각선 커넥터 선을 사용하지 마십시오.

시각적 DNA 및 색상 팔레트

  • 종이(배경): #f5f5f5 (평평한 캔버스).
  • 잉크(텍스트 및 주요 선): #2d3142.
  • 뮤트(보조 텍스트 및 표준선): #4f5d75.
  • 테두리 및 구분선: rgba(45, 49, 66, 0.12).
  • 강조(병목/중요 지점): #eb6c36 (코럴/테라코타; 다이어그램당 최대 1–2개 초점 노드).
  • 외부/느슨한 경계: 점선 (stroke-dasharray="4,4").

타이포그래피 (Google Fonts)

HTML 헤더에 포함: <link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500;600&display=swap" rel="stylesheet">

  • 다이어그램 제목: Instrument Serif, 28px, 일반 두께.
  • 노드 이름: Geist (산세리프), 12px, 두께 600.
  • 하위 레이블 및 메타데이터: Geist Mono, 9px (포트, 프로토콜, 배치 간격).
  • 커넥터 배지/아이브로우: Geist Mono, 7–8px, 대문자, 자간 (letter-spacing: 0.08em).

SVG 지오메트리 및 레이아웃 표준

  1. 4px 그리드 규율: 모든 좌표(x, y), 치수(width, height), 패딩 및 간격은 4의 배수여야 합니다.
  2. 직각 커넥터만 사용: 축이 다른 노드 사이에 대각선 사선을 절대 그리지 마십시오. 모든 굽힘은 모서리가 둥근(r=8) 직각 팔꿈치여야 합니다. <line>은 동일한 축을 공유하는 노드에만 사용하십시오.
  3. 마스킹된 커넥터 배지: 프로토콜/데이터 레이블(예: CSV, XLSX, LOAD)을 #f5f5f5(rx=2)로 채워진 불투명 <rect> 안에 배치합니다. 레이블이 화살표 선을 절단하지 않도록 선 스트로크에서 6px–10px의 가시 간격을 유지하십시오.
  4. 영역 및 기능 컨테이너: 단계를 넓은 열/영역(예: 수집, 처리, 배포)으로 그룹화합니다. 1px 테두리(rgba(45,49,66,0.12)), 둥근 모서리(rx=8) 및 왼쪽 상단에 대문자 고정폭 제목 탭을 사용합니다.
  5. 노드 계층 구조:
    • 표준: #ffffff 채움, 1px #2d3142 선, 6px 반경(rx=6).
    • 병목/문제점: #fbeee8 채움(rgba(235,108,54,0.08)), #eb6c36 선.
    • 외부: 투명 또는 흰색 채움, 점선 테두리(stroke-dasharray="4,4").
  6. 수평 하단 범례: 다이어그램 노드 아래에 전체 너비의 가는 구분선으로 분리된 수평 범례 스트립을 배치합니다.

구조적 SVG 템플릿

SVG를 작성하기 전에 references/template.md를 로드하십시오 (마커, 영역, 커넥터, 마스킹된 배지, 노드 상자 포함).

관련 스킬