저장소나 평범한 설명을 주면 Archify 가 검증을 거친 인터랙티브 구조도를 HTML 한 장으로 만듭니다. 아키텍처 · 워크플로 · 시퀀스 · 데이터 흐름 · 상태 전이, 다섯 종류입니다.
Archify 는 tt-a1i 의 오픈소스(MIT)입니다 — 우리가 만든 것이 아니고 제휴 관계도 없습니다. 우리가 만든 것은 설치기와 한국어 안내뿐입니다. GitHub 스타 60,186 · 포크 3,935 (2026-09-13 확인)
공식 설치기는 이 컴퓨터에서 찾은 에이전트에 따라 넣는 자리가 달라집니다.
2026-09-13 에 빈 환경에서 재 봤더니, --agent 없이 돌리면 .agents/skills 에만 들어갔고
클로드 코드 자리(.claude/skills)는 비어 있었습니다. 화면은 「Installed 1 skill · Done!」 이었습니다.
클로드 코드는 자기 폴더만 읽습니다. 거기 없으면 에러가 안 납니다 — 「아키파이로 그려줘」라고 해도 그냥 자기 방식대로 그립니다. 그래서 기계가 잽니다.
Archify 렌더러가 노드로 돈다. 낮으면 깔리는 듯하다가 그릴 때 죽는다.
어떻게 재나 process.versions.node 를 읽어 잰다
스킬을 읽는 쪽이다. 없으면 깔아도 부를 데가 없다.
어떻게 재나 claude --version 을 불러 본다. 못 부르면 「없다」가 아니라 「못 쟀다」다
가장 많이 막히는 자리다. 클로드 코드는 자기 skills 폴더만 읽는다 — 거기 없으면 에러 없이 그냥 안 불린다.
어떻게 재나 CLAUDE_CONFIG_DIR/skills · ~/.claude/skills · ./.claude/skills 에 archify/SKILL.md 가 있는지 본다
다른 에이전트용 폴더(.agents/skills)에만 들어가 있으면 설치는 성공으로 보이는데 클로드 코드는 못 본다.
어떻게 재나 ~/.agents/skills · ./.agents/skills 에만 archify 가 있고 클로드 코드 자리에는 없는지 본다
폴더가 있어도 파일이 덜 왔으면 그릴 때 멈춘다.
어떻게 재나 깔려 있으면 Archify 자체 점검(bin/archify.mjs doctor)을 돌려 「Archify is ready.」 가 나오는지 본다
못 잰 칸은 「없다」가 아니라 「못 쟀다」고 말합니다. 그 둘은 다른 이야기입니다.
npx --yes reborn-archify --check 가 이 컴퓨터에서 다섯 칸을 실제로 잽니다. 특히 Archify 가 이미 엉뚱한 폴더에만 들어가 있지 않은지 봅니다.
설치기가 원저자의 공식 설치기를 부릅니다. 여기에 --agent claude-code 를 붙여 클로드 코드 자리에 넣습니다.npx -y skills add tt-a1i/archify -g -y --agent claude-code --skill archify --copy끝나면 명령의 성공 표시를 믿지 않고 폴더를 다시 봅니다.
스킬 목록은 켤 때 읽습니다. 방금 깔고 바로 부르면 안 불리는 게 정상입니다.
「이 저장소 구조를 아키파이로 그려줘」 · 「로그인 요청이 가는 순서를 시퀀스 다이어그램으로 그려줘」 · 「이 머메이드를 아키파이로 다시 그려줘」
인라인 SVG 가 든 독립 HTML 한 장 (다크/라이트 · 확대·검색·흐름 따라가기). 내보내기는 PNG · JPEG · WebP · SVG · WebM.
질문에서 알아서 고르지만, 이름을 말하면 더 정확합니다. 입력은 평범한 말 · Mermaid(flowchart / sequenceDiagram / stateDiagram) · 저장소 코드 입니다.
Archify 는 원저자 저장소에서 받아 ~/.claude/skills/archify 에, 한국어 안내는
~/.claude/skills/archify-guide 에 깝니다. 깔기 전에 --check 로 먼저 재 볼 수 있습니다.
터미널을 따로 열지 않아도 됩니다. 클로드 코드 안에서 둘 중 하나면 됩니다.
! 붙이기 — 제일 확실합니다
!npx --yes reborn-archify! 까지 함께 붙여넣으세요. 클로드를 거치지 않고 곧장 설치가 돕니다.--yes 도 빼지 마세요 — 이게 없으면 «받아도 되나요?» 하고 묻는 자리에서
아무 말 없이 멈춥니다.reborn-archify 설치해줘npx --yes reborn-archifycmd 라고 친 뒤 엔터.
맥 — command+스페이스 누르고 터미널 엔터.~/.claude/skills)에 깔립니다.
여기서는 ! 를 빼세요.먼저 컴퓨터에 Node.js 가 있어야 합니다. 없으면 위 명령이 아예 안 뜁니다 —
nodejs.org 에서 큰 초록 버튼을 누르고
계속 «다음»만 누르시면 됩니다(3분). 클로드 코드를 쓰고 계시면 이미 있습니다.
클로드가 “실행하지 않겠습니다”라고 하면 1번을 쓰세요.
이제 막 나온 설치기라 클로드가 낯선 것으로 보고 막는 것이고, 그 판단 자체는 옳습니다.
! 를 붙이면 클로드에게 부탁하지 않고 바로 돌아갑니다.
폰이나 브라우저의 클로드 화면에서는 안 됩니다 — 그 창은 인터넷 저쪽의 임시 서버라
깔아도 내 컴퓨터에 남지 않습니다. 내 컴퓨터의 클로드 코드나 터미널에서 해 주세요.
깐 뒤 클로드 코드를 다시 열어야 스킬이 잡힙니다. 그다음 「이 저장소 구조를 아키파이로 그려줘」라고 하면 됩니다.
아래는 우리가 일부러 비워 둔 칸입니다.