플로우차트, 클로드에게 말로만 설명해도 2분이면 끝

가게 일 순서를 새 직원에게 알려 주려면 플로우차트 한 장이 말보다 빠릅니다. 그런데 도형을 하나씩 놓고 화살표를 잇는 일은 생각보다 오래 걸립니다. 아키파이(Archify)는 말로 설명한 과정을 눌러 볼 수 있는 플로우차트 HTML로 만들어 주는 클로드 코드 스킬로, 무료지만 쓸 때마다 클로드 사용량이 듭니다. 2026-10-25에 세탁소 주문 처리 과정 하나를 스킬 없이와 아키파이로 2번씩 그려, 결과와 비용을 비교한 기록입니다.

세 줄 요약
  1. 스킬 없이도 클로드는 2번 모두 2분이 안 걸려 단계 10개와 갈림길 4곳이 맞는 세로 순서도를 만들었습니다. 채점은 10점 중 8점씩이었습니다.
  2. 아키파이를 넣으면 누가 하는 일인지 색으로 나누고, 어두운 화면 전환·확대·이미지 내보내기 버튼이 붙었습니다. 9점씩이었고, 그리는 동안 자동 검사에서 걸린 배치 문제를 스스로 고쳤습니다.
  3. 대신 시간은 2~4분, 비용은 0.51~0.70달러로 스킬 없이(0.17~0.27달러)보다 평균 2.7배쯤 들었고, 파일은 12KB에서 850KB 안팎으로 커졌습니다.

결과부터 보기: 같은 요청, 두 가지 플로우차트

요청은 세탁소의 수거·배달 주문 과정 10단계와 예외 세 가지(얼룩 확인, 결제 지연, 오후 2시 기준 배달일)를 적고 “플로우차트를 HTML 파일 하나로 만들어 달라”는 내용이었습니다. 요청문에는 아키파이라는 이름을 넣지 않았습니다.

앞의 둘은 스킬 없이, 뒤의 둘은 아키파이로 만든 결과(마지막은 어두운 화면) · Claude Code · Sonnet 5.5 · 생각 깊이 중간

직접 눌러 보기: 네 번 만든 플로우차트 나란히 보기. 아키파이 결과에서는 위쪽 버튼으로 화면 색을 바꾸고, 아래쪽 돋보기와 +, − 버튼으로 확대해 볼 수 있습니다.

직접 실행 확인한 날짜 2026-10-25

실행 환경
macOS 26.1 · Claude Code 2.1.299 · Sonnet 5.5 · 생각 깊이 중간 (4번 모두 같은 설정) · Node.js 25.8 · archify 3.2.0
설치 난이도
스킬 폴더 하나를 프로젝트의 .claude/skills에 복사, 또는 npx 명령 한 줄. Node.js 18 이상 필요
비용
스킬 무료. 이번 요청 한 번에 API 단가로 0.51~0.70달러어치
라이선스
MIT · tt-a1i/archify(별 88,793개, 2026-10-25 기준)

아키파이(Archify) 스킬에 들어 있는 것

아키파이는 플러그인이 아니라 스킬 하나입니다. 에이전트, 훅, MCP 서버는 없습니다. 스킬 폴더(약 17MB)에는 클로드가 읽는 지침 SKILL.md와, 그림을 실제로 그리고 검사하는 Node.js 프로그램(렌더러·검사기)이 함께 들어 있습니다.

SKILL.md가 정한 순서는 이렇습니다. 클로드가 직접 도형 좌표를 그리지 않고, 정해진 형식의 설명 파일(JSON)을 쓴 뒤 아키파이 프로그램이 HTML로 바꿉니다.

  • 그림 종류 고르기: 시스템 구성도, 업무 흐름(workflow), 주고받는 순서(sequence), 데이터 흐름, 상태 변화, 표 관계(ERD), 클래스, 나무 구조, 타임라인, 시간 막대(waterfall) 10가지 중 질문에 맞는 것을 고릅니다. 이번에는 4번 모두 업무 흐름을 골랐습니다.
  • 설명 파일 쓰기: 단계, 갈림길, 줄(레인), 범례를 JSON으로 적습니다. 일상 주제면 아이콘과 범례 이름을 읽는 사람 말로 바꾸라고 정해져 있습니다.
  • 자동 검사(finalize): 형식 검사, HTML 만들기, 파일 검사, 실제 브라우저(이 맥의 크롬)로 열어 보기까지 네 관문을 통과해야 끝납니다. 하나라도 걸리면 고쳐서 다시 돌립니다.
  • 한 페이지 설명(explainer): “한 페이지로 답해 줘”라고 하면 결론을 먼저 놓고 표·단계·그림으로 이유를 나눈 설명 페이지를 만듭니다. 이번에는 써 보지 않았습니다.

설치가 됐는지는 스킬 폴더 안의 진단 명령으로 확인합니다.

터미널에서 아키파이 진단 명령을 실행해 렌더러 항목이 모두 ok로 나오고 Archify is ready가 출력된 화면
진단 명령 결과: 렌더러 10종과 설명 페이지 렌더러가 모두 [ok], 마지막 줄 Archify is ready.

따라 해 보기: 요청문과 실습 재료

빈 폴더에서 클로드 코드를 열고 보낸 요청입니다. 두 조건 모두 이 문장 그대로였고, 다른 것은 폴더에 아키파이 스킬이 있느냐뿐이었습니다.

우리 동네 세탁소의 '수거·배달 세탁 주문' 처리 과정을 플로우차트로 그려서 HTML 파일 하나로 만들어 줘. 새로 온 직원이 화면을 보고 그대로 따라 할 수 있게, 글자는 전부 한국어로.

과정:
1. 고객이 카카오톡으로 수거 신청
2. 직원이 수거 시간 확정 문자 발송
3. 배달 기사가 옷 수거
4. 매장에서 옷 검수(얼룩·찢어짐 확인)
   - 얼룩이 지워지지 않을 수 있는 옷이면 고객에게 사진을 보내 진행 여부 확인
   - 고객이 진행을 거절하면 그 옷은 세탁하지 않고 그대로 돌려보냄
5. 견적 안내와 결제 링크 발송
   - 결제가 안 되면 안내 문자를 한 번 더 보내고, 24시간 안에도 결제가 없으면 주문 취소 후 옷 반송
6. 세탁·다림질
7. 포장
8. 배달 날짜 정하기: 오후 2시 이전에 세탁이 끝나면 당일 배달, 그 뒤면 다음 날 배달
9. 배달 기사가 배달
10. 배달 완료 문자 발송

파일 이름은 laundry-flow.html 로 해 줘.

좋은 답이라면 10단계가 빠짐없이 있고, 거절된 옷과 결제 없는 주문이 따로 끝나는 길로 빠지며, 오후 2시를 기준으로 당일·다음 날 배달이 갈립니다. 실습 재료(zip)에는 요청문, 채점 기준, 두 조건의 결과 HTML, 아키파이가 쓴 설명 파일(JSON)을 넣었습니다.

1단계. 아키파이 설치하기

이 단계에서는 클로드 코드가 아키파이를 쓸 수 있게 스킬 폴더를 넣습니다. 저장소 안내의 기본 설치는 터미널에서 이 한 줄입니다(npx는 Node.js에 딸린 실행 도구입니다).

npx skills add tt-a1i/archify -g

-g는 내 컴퓨터 전체에 까는 옵션이라 작업 폴더에서는 쓰지 않았습니다. 대신 저장소를 받아 스킬 폴더만 프로젝트 안에 복사했습니다. 저장소 안내에도 클로드 코드는 ~/.claude/skills/나 프로젝트의 .claude/skills/에 두면 된다고 적혀 있습니다.

git clone --depth 1 https://github.com/tt-a1i/archify.git
mkdir -p .claude/skills
cp -R archify/archify .claude/skills/archify
node .claude/skills/archify/bin/archify.mjs doctor

이렇게 나오면 성공 진단 결과가 [ok] 줄로 이어지고 마지막에 Archify is ready.(아키파이 준비 완료)가 나왔습니다.

  • node: command not found가 나오면: Node.js 18 이상을 먼저 설치합니다. 아키파이 프로그램이 Node.js로 돕니다.
  • 아키파이는 새 버전 알림을 위해 제작자 사이트의 버전 정보 파일 하나를 읽습니다. 업데이트를 내려받지는 않습니다. 이 요청도 끄려면 저장소 안내대로 환경 변수 ARCHIFY_UPDATE_CHECK_DISABLED=1을 둡니다. 실험은 이 값을 켜고 했습니다.
  • 클로드 앱(claude.ai)에서는 설정 > 기능(Capabilities) > 스킬에서 저장소의 archify.zip을 올리는 방법이 안내돼 있습니다. 저장소는 앱의 실행 환경에서 Node.js를 쓸 수 있느냐에 따라 기능이 달라진다고 적었습니다. 앱에서는 써 보지 않았습니다.
  • 필요 없어지면 .claude/skills/archify 폴더를 지웁니다.

2단계. 같은 요청을 두 조건으로 보내기 (조건당 1~4분)

이 단계에서는 위 요청을 스킬 없이, 아키파이 두 조건으로 2번씩, 모두 4번 보냈습니다. 채점 기준 8개(10점)는 아키파이 안내문의 “업무 흐름에 넣을 내용: 참여자, 순서, 분기, 예외”에서 뽑아 실행 전에 정했습니다. 결과는 브라우저로 열어 콘솔 오류, 휴대폰 폭(390px) 화면, 버튼 동작을 확인했습니다.

조건단계·갈림길누가 하는지 구분버튼(테마·확대·내보내기)점수(10)시간비용(달러)파일 크기
스킬 없이 110단계·4곳 모두없음없음81분 반쯤0.27012KB
스킬 없이 210단계·4곳 모두없음없음81분이 안 걸림0.17412KB
아키파이 110단계·4곳 모두색·범례있음94분쯤0.704853KB
아키파이 210단계·4곳 모두색·범례있음92분 반쯤0.507845KB

스킬 없이 만든 2개는 위에서 아래로 내려가는 세로 순서도였습니다. 갈림길은 마름모나 점선 칸으로, 끝나는 곳은 초록·빨간 둥근 칸으로 구분했습니다. 다만 고객, 직원, 배달 기사가 하는 일이 같은 색이라 “누가” 하는지는 글자를 읽어야 압니다.

아키파이 2개는 가로 줄(레인) 여러 개로 흐름을 나눴습니다. 직원 일은 초록, 배달 기사 일은 주황, 판단·예외는 분홍으로 칠하고 아래에 범례를 달았습니다. 끝나는 칸에는 멈춤·완료 아이콘이 붙었습니다.

아키파이 결과에서 아쉬운 점

두 결과 모두 예외 줄 이름 앞에 EX /라는 영어 표시가 붙었습니다. 다른 줄은 02 /처럼 번호가 붙는데, 예외 줄만 이 표시가 나왔습니다. 클로드가 쓴 설명 파일의 줄 이름은 “얼룩 확인 (예외)”처럼 한국어였습니다. “화면 글자가 모두 한국어”라는 기준에서 둘 다 1점을 뺐습니다.

휴대폰 폭(390px)에서는 결과가 갈렸습니다. 스킬 없이 2번째는 글자가 크게 세로로 맞았고, 1번째는 그림 안쪽을 옆으로 밀어야 끝까지 보였습니다. 아키파이는 그림 전체가 작게 줄어들어 확대해야 읽혔고, 확대·이동은 됐습니다.

자동 검사가 잡아낸 것

아키파이 2번 모두 첫 검사에서 걸렸습니다. “6번에서 7번으로 갈 때 칸이 뒤로 간다”, “8번 칸 글자가 칸보다 넓다” 같은 배치 문제였습니다. 클로드는 이 메시지를 읽고 칸 위치와 글자를 고쳐 다시 돌렸고, 두 번째 검사에서 네 관문을 모두 통과했습니다. 스킬 없이 만든 쪽은 이런 검사 없이 파일만 쓰고 끝냈고, 클로드도 “브라우저로 열어 보지는 못했다”고 적었습니다.

실행 기록 · <작업 폴더>/tools/run.sh, <작업 폴더>/runs.tsv

# 두 조건 모두 같은 요청문, 아키파이 조건만 .claude/skills/archify 복사
ARCHIFY_UPDATE_CHECK_DISABLED=1 claude -p "$(cat tools/prompt.txt)" --model claude-sonnet-5-5 --effort medium \
  --setting-sources project,local --permission-mode acceptEdits \
  --allowedTools "Bash(node *)" "Bash(ls *)" "Bash(mkdir *)" --output-format stream-json --verbose

조건	불린 스킬	시간(ms)	턴	비용(USD)	채점(10)	파일 크기	비고
without-1	-	95717	3	0.270	8	12.6KB	세로 순서도, 마름모 분기, 종료 색 구분, 참여자 구분 없음, 상호작용 없음, 390px는 안쪽 가로 스크롤
without-2	-	43832	2	0.174	8	12.1KB	세로 순서도, 시작·끝 표시, 참여자 구분 없음, 상호작용 없음, 390px 세로로 맞음
with-1	archify	232578	21	0.704	9	852.6KB	finalize 통과, 레인 5개, 참여자 색·범례, 테마 전환·내보내기·확대, 레인 이름에 'EX /' 영어 표시
with-2	archify	147170	13	0.507	9	844.5KB	finalize 통과, 레인 5개, 참여자 색·범례(고객2·직원12·기사2·판단4), 'EX /' 영어 표시

이런 사람에게 권합니다

  • ✅ 플로우차트를 회의나 발표 화면에 띄워 놓고 설명하는 사람. 어두운 화면, 확대, 발표 모드, 이미지 내보내기가 한 파일에 들어 있습니다.
  • ✅ 단계가 많고 맡는 사람이 여럿인 업무를 정리하는 사람. 누가 하는 일인지 색과 범례로 바로 보입니다.
  • ✅ 개발 일을 한다면 시스템 구성도, API 호출 순서, 데이터베이스 표 관계처럼 아키파이가 원래 겨냥한 그림에 더 맞습니다(이번에는 업무 흐름만 써 봤습니다).
  • ❌ 간단한 순서도 한 장이면 되는 사람. 스킬 없이도 단계와 갈림길이 모두 맞게 나왔고, 비용은 3분의 1 수준이었습니다.

한계와 주의할 점

  • 요청 하나, 소넷 5.5로 조건마다 2번씩입니다. 업무 흐름 말고 다른 그림 종류와 한 페이지 설명(explainer)은 써 보지 않았습니다.
  • 아키파이 HTML이 스킬 없이 만든 것의 70배쯤 큰 것은 화면 기능이 모두 한 파일에 들어 있어서입니다. 외부에서 불러오는 파일은 없어 인터넷 없이도 열렸습니다.
  • 자동 검사는 이 맥의 크롬을 열어 확인합니다. 크롬이 없는 컴퓨터에서는 검사 단계가 어떻게 되는지 확인하지 않았습니다.
  • SKILL.md에는 설명 페이지를 만든 뒤 “앞으로도 알아서 만들어 줄까요?”라고 묻고, 사용자가 받아들이면 클로드 전체 설정 파일(~/.claude/CLAUDE.md)에 한 줄을 넣는 안내가 있습니다. 원치 않으면 거절하면 됩니다.

대안

방법다른 점이럴 때 고르세요
스킬 없이 요청만설치 없음. 세로 순서도 한 장, 버튼·검사 없음설치 없이 간단한 순서도 한 장이 필요할 때
아키파이(이 글)레인·색·범례, 테마·확대·내보내기, 자동 검사발표·공유용으로, 맡는 사람이 여럿인 흐름을 그릴 때
아나토미(Anatomy) 스킬입체(아이소메트릭) 설명 그림을 그리는 스킬개념을 그림 한 장으로 설명하고 싶을 때
클로드 아티팩트클로드 앱 안에서 바로 화면을 만들어 공유설치 없이 앱에서 끝내고 싶을 때

스킬이 무엇인지는 클로드 스킬이란?에 정리했습니다.

자주 묻는 질문

요청할 때 “아키파이로 그려 줘”라고 해야 하나요?

이번 실험에서는 요청문에 이름을 넣지 않았는데도 아키파이 조건 2번 모두 클로드가 먼저 아키파이 스킬을 불러 썼습니다. 다른 그림 요청에서도 늘 그런지는 확인하지 않았습니다. 확실히 쓰게 하려면 저장소 예시처럼 “Archify로 그려 줘”를 붙이면 됩니다.

만든 플로우차트를 이미지로 받을 수 있나요?

네. 아키파이 결과 화면 오른쪽 위 내보내기 메뉴에 PNG·JPEG·WebP·SVG 이미지, 6초짜리 WebM 영상, “다이어그램 복사(PNG를 클립보드로)”가 있습니다. PNG를 눌러 보니 3474×2790 크기의 diagram.png가 내려받아졌습니다.

만든 뒤에 고칠 수 있나요?

저장소 안내는 “인증 추가해 줘”, “라이트 테마로 바꿔 줘”처럼 대화로 이어서 다듬으라고 합니다. 클로드가 쓴 설명 파일(JSON)이 남아 있어 그 파일을 고쳐 다시 만드는 방식입니다. 이번에는 첫 결과까지만 봤습니다.

돈이 드나요?

스킬은 MIT 라이선스로 무료이고, 쓸 때마다 클로드 사용량이 듭니다.

출처

tt-a1i/archify 저장소(3.2.0), 한국어 README, archify SKILL.md, 예제 모음(Proof Lab) (모두 2026-10-25 확인)