AI 칼럼

디자인@donghyeok99운영진

stack-diagram: 한 문장으로 공식 로고 아키텍처 다이어그램을 그리는 스킬

스택을 한 문장으로 말하면 공식 로고가 박힌 아키텍처 다이어그램을 HTML 한 장으로 그려 주는 스킬이에요. 나온 지 이틀 만에 별 1,200개를 넘었어요

한 문장을 치면 모눈종이 위에 Next.js·Hono·Neon·Clerk·Stripe 타일이 놓이고 화살표가 그어진 뒤, 같은 그림이 다크 테마로 바뀌어요
한 문장을 치면 모눈종이 위에 Next.js·Hono·Neon·Clerk·Stripe 타일이 놓이고 화살표가 그어진 뒤, 같은 그림이 다크 테마로 바뀌어요
누가
개발자 caru-ini가 만든 MIT 스킬이에요. 기술 스택이나 서비스 구성을 그림으로 보여 줘야 하는 사람이면 누구나 써요.
언제
저장소는 2026년 11월 1일에 생겼고, 11월 3일 v0.4.0에서 Google Cloud와 Azure 공식 아이콘이 들어갔어요.
어디서
Claude Code, Codex, Cursor 등 스킬을 읽는 에이전트에서 설치해요. Claude 앱은 릴리스의 zip을 올려요. 내 PC의 Python으로 돌고 로고만 네트워크에서 받아요.

이게 불편했어요

발표 자료나 README에 넣을 구성도가 필요할 때마다 draw.io를 열어 로고를 찾고 박스를 맞추고 화살표를 정리하느라 한참을 썼어요. 에이전트에게 Mermaid로 그려 달라고 하면 로고 없는 회색 상자 그림이 나왔고요.

그래서 이렇게 풀어요

stack-diagram은 스택 설명 한 문장을 받아 노드와 그룹, 세 가지 화살표(주 흐름, 내부 연결, 배포)를 정하고 각 브랜드의 공식 로고를 받아 흰 타일 위에 올려요. 로고는 절대 다시 칠하지 않고, 흰 로고는 어두운 타일로 옮겨요. 핵심은 그린 뒤 PNG로 찍어 직접 보고 화살표가 글자를 지나는지 확인하고 고치는 루프예요. 결과는 폰트와 로고가 다 들어간 HTML 한 파일이라 어디서든 열려요.

이걸로 만든 사람들

GitHubEricKei20022026-11-02

자기 프로젝트의 구성도 HTML 5장을 stack-diagram으로 다시 그린 PR이에요. 공식 로고가 들어간 자체 완결 HTML로 합계 약 3.5MB가 약 0.6MB로 줄었다고 적었어요.

公式ロゴ入り・自己完結HTML(合計 約3.5MB→約0.6MB)、ダーク既定(?theme=light 可)、狭い画面では横幅に合わせて縮小
stacks.caru.moeyukiharada12282026-11-02

스킬의 공개 갤러리에 올라온 다이어그램이에요. React, Vite, Cloudflare Workers, Hono, Neon, AWS Lambda, Stripe 등 스무 개 남짓한 기술이 한 장에 들어 있어요.

VideoQ
좋아요 2 (2026-11-03 기준)stacks.caru.moe ↗
GitHubRarkHopper2026-11-01

drawio-desktop 포크에 스킬을 넣고 Electron·Node.js·npm 로고로 라이트·다크 PNG를 뽑아 본 PR이에요. HTML이 추가 통신 없이 열리는 것도 확인했다고 해요.

Electron、Node.js、npmのロゴを取得し、画像とフォントを埋め込んだHTMLから両テーマのPNGを生成できました。

안에서는 이렇게 돌아가요

  1. 1

    나 → Claude Code

    스택 한 문장기술 하나에 노드 하나, 같은 런타임·벤더는 그룹, 화살표는 주 흐름·내부·배포 세 종류로 정해요skills/stack-diagram/SKILL.md
  2. 2

    Claude Code → fetch_icons.py

    python3 scripts/fetch_icons.py icons nextjs hono …svgl, devicon, gilbarbara/logos 순으로 받고, AWS·GCP·Azure는 각 사 아이콘 패키지에서 꺼내요. manifest.json에 출처와 흰 로고 표시를 남겨요skills/stack-diagram/scripts/fetch_icons.py
  3. 3

    Claude Code → build.py

    template.html + 좌표노드 상자는 132×100이고, 세로 화살표는 상자 바닥에서 다음 타일 꼭대기로 이어 글자를 지나지 않아요skills/stack-diagram/references/geometry.md
  4. 4

    build.py → render_png.py

    out.htmlbuild.py가 %%ICON_이름%%과 %%FONT_*%% 토큰을 데이터 URI로 바꿔요. 남은 토큰이 있으면 실패해요skills/stack-diagram/scripts/build.py
  5. 5

    render_png.py → Claude Code

    out.png, out-dark.png헤드리스 Chromium이 .canvas를 2배로 찍어요. 에이전트가 그림을 보고 글자를 지나는 화살표, 흰 바탕의 흰 로고, 잘림을 고쳐요skills/stack-diagram/scripts/render_png.py
  6. 6

    Claude Code → HTML + PNG 다이어그램

    HTML, PNG, TSX, 아티팩트HTML 한 파일에서 나머지를 뽑아요. 갤러리(stacks.caru.moe) 공유는 한 번만 제안하고 두 번 확인한 뒤에 올려요skills/stack-diagram/scripts/share.py

넣으면 이렇게 나와요

Diagram our stack: Next.js and a Hono API on Vercel. Postgres on Neon, auth with Clerk, payments with Stripe.Vercel 그룹 안의 Next.js·Hono, Neon·Clerk·Stripe로 가는 화살표, GitHub Actions 배포선이 있는 다이어그램 (README 첫 그림)
Draw our app on AWS: CloudFront in front of S3 and an ALB in a public subnet, Fargate and RDS in a private subnet.AWS 공식 아이콘과 VPC·퍼블릭·프라이빗 서브넷 상자가 있는 AWS 다이어그램
구성도 HTML 5장을 stack-diagram으로 다시 생성합계 약 3.5MB에서 약 0.6MB로 줄어든 자체 완결 HTML (한 사용자의 PR)

나한테 맞을까요

이럴 때 좋아요

  • README나 발표 자료에 넣을 서비스 구성도가 필요할 때
  • AWS, Google Cloud, Azure 아키텍처를 각 사 공식 아이콘으로 그릴 때
  • 모노레포 툴링처럼 클라우드가 아닌 구성을 그릴 때
  • 라이트·다크 두 버전이 같이 필요할 때

이건 안 돼요

  • Python 3.9 이상과 로고를 받을 네트워크가 필요해요. PNG는 Playwright와 Chromium이 더 필요해요
  • 로고는 스킬에 번들되지 않고 빌드할 때 받아요. AWS·GCP·Azure 아이콘은 저장소에 넣지 말라고 해요
  • 일본어 글자는 렌더하는 PC에 일본어 폰트가 없으면 중국어 글리프로 나와요 (SKILL.md 기준)
  • 갤러리 공유는 두 번 확인한 뒤에만 올리고, 올라간 것은 공개돼요

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기