Archify의 개요
Archify는 Claude Code, Codex CLI, Cursor, OpenCode용 에이전트 스킬로, 에이전트가 다이어그램의 타입이 지정된 JSON 설명을 작성하게 하고, 이를 검증한 뒤 독립적인 인터랙티브 HTML 파일로 렌더링합니다. 다이어그램 유형 10가지(아키텍처, 워크플로, 시퀀스, 데이터 흐름, 라이프사이클, ERD, 클래스, 트리, 타임라인, 워터폴)와 함께, 답을 먼저 제시하고 번호가 붙은 출처를 인용하는 한 페이지 설명서를 지원합니다.
뷰어에서 독자는 노드에 초점을 맞추고, 상류나 하류 관계를 추적하고, 경로를 강조하고, 테마를 바꾸고, PNG, WebP, JPG나 공유 카드로 내보낼 수 있습니다. 저장소를 읽게 하면 아키텍처 노드가 공개 커밋에 고정된 파일과 줄 범위로 연결될 수 있습니다. 에이전트에 llms.txt 파일을 가리키거나 npx skills로 설치합니다.
2026년 4월에 만들어진 저장소는 GitHub 스타 약 92,100개이며 현재 Apache-2.0입니다. 이전 릴리스는 원래의 MIT 허가를 유지합니다. 최신 릴리스는 v3.2.0(2026년 10월 19일)입니다.
Archify, 쓸 만한 가치가 있습니까?
Archify의 진짜 기여는 보기 좋음이 아니라 검증입니다. 대부분의 에이전트 다이어그램 도구는 모델에게 Mermaid나 SVG를 요청하고 잘되기를 바랍니다. Archify는 에이전트가 타입이 지정된 JSON 소스를 작성하게 하고, 스키마, 레이아웃, 경로, 라벨 여백 검사를 돌린 뒤, 모든 관문을 통과했을 때만 이전 결과물을 교체합니다. 검사가 실패하면 validate --json이 규칙 코드와 허용되는 구체적 수정을 돌려주므로, 에이전트는 그림 전체를 다시 만드는 대신 한 가지를 고칩니다. 원칙 적으로 이렇게 하면 자유 형식 결과물을 매번 다시 생성하는 것보다 이후 수정이 더 안정적입니다.
결과물은 설치할 런타임이 없는 HTML 파일 하나입니다. 독자는 한 서비스의 하류를 모두 추적하거나, 웹 앱에서 데이터베이스까지의 경로를 살피거나, 백엔드와 데이터베이스의 역할을 비교할 수 있으며, 상호작용은 런타임 영향을 추론하지 않고 작성자가 선언한 관계만 재사용합니다. 엔지니어에게 유용한 변주는 저장소 모드입니다. 근거가 있는 노드가 고정된 커밋의 정확한 파일과 줄 범위를 열어 주므로, 리뷰어가 지도를 코드와 대조할 수 있습니다.
부담은 주변부에 있습니다. 프로젝트는 MIT에서 Apache-2.0으로 바뀌었고, 빠르게 출시하며(2026년 9월 말부터 10월 중순까지 릴리스 5개), ARCHIFY_UPDATE_CHECK_DISABLED=1을 설정하지 않으면 하루에 한 번쯤 자체 서버에 접속하는 선택적 업데이트 확인을 실행합니다. README는 프로젝트 데이터를 보내지 않는다고 말합니다. 후원 섹션은 Claude, OpenAI, Gemini 접근을 공식 가격의 몇 퍼센트에 제공한다는 서드파티 API 중계 서비스 여러 곳을 홍보합니다. Archify의 코드와는 무관하지만 개발자 도구 옆에 두기엔 이상한 이웃이며, 클릭하지 않는 편이 좋습니다.
손으로 쓴 Mermaid 파일과 비교하면 Archify는 에이전트에게 더 많은 것을 요구하고 훨씬 풍부한 결과를 냅니다. diagram-design이나 fireworks-tech-graph와 비교하면 스타일 가이드가 아니라 검증기와 뷰어 계약을 갖춘, 더 공들여 설계된 선택지입니다. Mermaid 파싱, 자동 레이아웃, 호스팅 공유, 드래그 앤 드롭 편집은 설계상 범위 밖이므로 화이트보드를 대체하기보다 보완합니다.
제 역할을 하는 곳
서비스 40개짜리 백엔드에 신규 입사자 3명을 온보딩하는 스태프 엔지니어
소스에 근거한 저장소의 런타임 아키텍처 지도 만들기
에이전트에게 저장소를 분석해 Archify로 핵심 컴포넌트 8~12개를 그리게 합니다. 근거가 있는 노드는 고정 커밋의 파일로 연결되고, HTML은 온보딩 문서에 넣습니다. 무료이며, 비용은 에이전트 몇 턴 분량의 토큰입니다.
장애 회고를 쓰는 SRE
무슨 일이 일어났고 시간이 어디서 쓰였는지 보여 주기
로그 타임스탬프로 타임라인을, 트레이스 스팬으로 워터폴을 생성한 뒤 HTML 파일 하나를 공유합니다. 프로젝트는 시간 값이 로그나 트레이스에서 왔을 때만 실제라고 경고합니다.
아키텍처 변경을 검토하는 프로덕트 매니저
제안된 설계가 무엇을 더하고 빼고 옮기는지 보기
compare 명령이 JSON 스냅숏 두 개 사이의 Architecture Delta를 렌더링합니다. 리뷰어는 작성된 변경을 단계별로 살펴볼 수 있지만, 위험이나 병합 안전성을 추론하지는 않습니다.
도입 전 확인할 점
- 설정
- 에이전트에게 llms.txt로 Archify를 설치하라고 하거나, npx -y skills@latest add https://archify.si --skill archify --agent cursor --global --copy --yes를 실행합니다. Node.js가 번들된 렌더러와 검증기를 돌리며, 첫 다이어그램은 프롬프트 하나면 됩니다.
- 연동
- 전체 렌더러를 쓰는 Claude Code, Codex CLI, OpenCode, Cursor. Claude.ai 스킬 업로드. Hermes Agent와 DeepSeek Harness용 커뮤니티 통합. PNG, WebP, JPG, 공유 카드, PDF 인쇄로 내보냅니다.
- 데이터와 개인정보
- 로컬에서 실행되며, 생성된 HTML은 독립적입니다. 선택적 업데이트 확인은 약 24시간마다 일반 HTTP 메타데이터만으로 프로젝트 서버에서 매니페스트를 GET하며, ARCHIFY_UPDATE_CHECK_DISABLED=1로 끕니다. Apache-2.0이며, 공개된 보안 권고는 없습니다.
- 대규모 사용 시 비용
- 유료 버전은 없습니다. 비용은 다이어그램과 수정마다 드는 에이전트 토큰, 그리고 코딩 에이전트가 쓰는 모델 요금제입니다.
- 제한
- 열린 이슈 약 270개. Mermaid 파싱, 범용 자동 레이아웃, 호스팅 공유, WYSIWYG 편집이 없습니다. 에이전트는 시각적 검토 전에 다이어그램당 두 번의 수정 기회를 갖 습니다.
좋은 점
- 전달 전에 스키마, 레이아웃, 경로를 검증하는 타입 지정 JSON 소스
- 다이어그램 유형 10가지와 출처를 인용하는 설명 페이지
- 단일 파일 인터랙티브 HTML로 보는 데 설치가 필요 없음
- 저장소 노드가 고정 커밋의 파일과 줄로 연결됨
아쉬운 점
- 끄지 않으면 매일 업데이트 확인
- MIT에서 Apache-2.0으로 재라이선스, 빠른 릴리스 주기
- README 후원사에 헐값 API 중계 서비스가 있음
- WYSIWYG 편집이나 Mermaid 가져오기 없음
추천 대상
코딩 에이전트가 점검되고 인터랙티브하며 파일 하나로 공유할 수 있는 아키텍처·흐름 다이어그램을 만들기를 원하는 엔지니어와 테크 리드.
Archify 대안
Archify: 자주 묻는 질문
- Archify, 쓸 만한 가치가 있습니까?
- 사용자에게 도달하기 전에 스스로 점검하는 다이어그램으로, 에이전트가 그린 아키텍처 그림에 바로 그것이 없었습니다. 평점은 5점 만점에 4.0점입니다.
- Archify의 가격은 얼마입니까?
- 무료 오픈소스입니다(Apache-2.0, 이전 릴리스는 MIT).
- Archify의 단점은 무엇입니까?
- 끄지 않으면 매일 업데이트 확인; MIT에서 Apache-2.0으로 재라이선스, 빠른 릴리스 주기; README 후원사에 헐값 API 중계 서비스가 있음; WYSIWYG 편집이나 Mermaid 가져오기 없음.
- Archify에 적합한 사람은 누구입니까?
- 코딩 에이전트가 점검되고 인터랙티브하며 파일 하나로 공유할 수 있는 아키텍처·흐름 다이어그램을 만들기를 원하는 엔지니어와 테크 리드.
- 팀이나 프로덕션 환경에서 Archify의 비용은 얼마입니까?
- 유료 버전은 없습니다. 비용은 다이어그램과 수정마다 드는 에이전트 토큰, 그리고 코딩 에이전트가 쓰는 모델 요금제입니다.
- Archify에 회사 데이터를 맡겨도 안전합니까?
- 로컬에서 실행되며, 생성된 HTML은 독립적입니다. 선택적 업데이트 확인은 약 24시간마다 일반 HTTP 메타데이터만으로 프로젝트 서버에서 매니페스트를 GET하며, ARCHIFY_UPDATE_CHECK_DISABLED=1로 끕니다. Apache-2.0이며, 공개된 보안 권고는 없습니다.
- Archify의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Diagram Design, fireworks-tech-graph 및 Anatomy입니다.
답변 확인일: 2026년 10월 31일.
Archify 개발사입니까? 이 평점을 사이트에 표시하십시오
