Archify

한 문장 설명이나 저장소 분석으로 탐색 가능한 인터랙티브 아키텍처 다이어그램을 단일 HTML로 만들어 주는 스킬입니다.

스킬코드베이스 이해tt-a1i 제작 · 비공식 한국어 정리
설치 방법 보기원본 저장소

언제 쓰면 좋나

시스템 구조나 요청 흐름(예: 캐시 미스 경로)을 팀에 시각적으로 설명해야 할 때 유용합니다. 저장소 없이 설명만으로 시작할 수도 있고, 코드를 읽혀 출처가 연결된 아키텍처 지도를 만들 수도 있습니다. 결과 HTML은 설치 없이 브라우저로 열어 공유할 수 있습니다.

설치

설치 전에 알아 둘 것

Node.js 18 이상이 필요합니다. 설치기뿐 아니라 다이어그램을 그리고 검사하는 렌더러도 Node로 돌아갑니다.

아래 방법 중 하나만 따라 하면 됩니다.

아래 명령은 Claude Code 기준입니다. Cursor, Codex에서는 원본 저장소의 설치 안내를 따르세요.

방법 1 npx로 전역 설치

  1. 터미널에서 실행
    npx skills add tt-a1i/archify -g

방법 2 Cursor에 묻지 않고 설치

  1. 터미널에서 실행
    npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

방법 3 설치하지 않고 시험

Codex에서 한 번 써 보는 명령입니다.

  1. 터미널에서 실행
    npx skills use tt-a1i/archify@archify --agent codex

주의할 점

  • 업데이트 알림을 위해 약 24시간마다 고정 매니페스트를 조회합니다. 서버에는 IP와 접속 시각 같은 일반 HTTP 정보만 남고 프로젝트 내용이나 프롬프트는 보내지 않는다고 밝히고 있습니다. ARCHIFY_UPDATE_CHECK_DISABLED=1로 끌 수 있고, 업데이트를 자동 설치하지는 않습니다.
  • 2026-10-25에 라이선스가 MIT에서 Apache-2.0으로 바뀌었습니다. 그 전에 받은 버전의 MIT 허가는 그대로 유효합니다. 소프트웨어 라이선스와 별개로 Archify 상표 사용은 허가하지 않습니다.
  • Claude.ai에서는 archify.zip을 스킬로 올려 쓸 수 있지만, 샌드박스에서 Node를 쓸 수 없으면 렌더링과 검사가 제대로 돌지 않을 수 있습니다.
  • 코드베이스를 읽혀 그릴 때 드는 토큰은 대부분 에이전트가 코드를 탐색하는 데 쓰입니다. 큰 저장소라면 그릴 범위를 서비스나 흐름 하나로 좁혀 요청하는 편이 비용을 줄입니다.

커뮤니티 반응

직접 써본 리뷰어는 다이어그램을 손으로 다시 그리는 대신 다시 생성하면 되고, 코드 위치까지 연결돼 낯선 코드베이스를 빠르게 파악하는 데 좋다고 평가했습니다. 반면 검증 단계가 있어도 에이전트가 없는 관계를 지어낼 수 있고, 대형 모노레포를 통째로 그리면 비용이 크다는 점을 경고했습니다. GitHub에는 과정이 느리고 토큰을 많이 먹는다는 불만이 올라왔는데, 관리자는 토큰 대부분이 렌더러가 아니라 호스트 에이전트와 모델이 코드베이스를 탐색하는 데 쓰인다고 답하고 이슈를 닫았습니다.

다른 사용자들의 공개 후기를 요약했습니다(2026-10-27 확인).

비슷한 도구

Archify 대신 쓸 만한 도구와 같은 코드베이스 이해 카테고리에서 별이 많은 도구입니다.