쉬운 설명
Archify는 한마디로 "AI에게 시스템 구조를 말로 설명하면, 알아서 예쁘고 정확한 그림을 그려주는 도구"예요. 학교나 회사에서 조직도나 흐름도를 손으로 직접 그리면 예쁘기는 한데, 나중에 내용이 바뀌면 처음부터 다시 그려야 해서 번거롭죠. 반대로 자동으로 그려주는 프로그램을 쓰면 편하긴 하지만, 선이 복잡하게 겹쳐서 알아보기 힘들 때가 많아요. Archify는 이 두 가지 문제를 깔끔하게 해결해 줍니다. AI 에이전트가 코드를 읽고 그림을 그린 다음, '검증기'라는 별도의 프로그램이 그 그림이 실제 구조와 잘 맞는지, 화살표가 글자를 가리지 않는지까지 자동으로 확인해 주거든요. 덕분에 단순한 그림을 넘어 진짜 믿고 쓸 수 있는 다이어그램이 완성됩니다.
요약
Archify는 Cursor, Claude Code, Codex, OpenCode 같은 AI 코딩 에이전트에 설치해서 사용하는 '에이전트 스킬(Agent Skill)'이에요. 사용자가 채팅으로 시스템을 설명하거나 프로젝트 저장소(코드베이스) 분석을 요청하면, AI 에이전트가 이를 타입이 정해진 JSON 중간 표현(Typed JSON IR)으로 정리합니다. 이어서 검증기가 해당 데이터를 스키마와 레이아웃 규칙에 맞춰 검사한 뒤, 하나의 단일 HTML 파일로 결과물을 만들어 줘요. 서버나 별도 뷰어가 전혀 필요 없고, 웹 브라우저만 열면 바로 확인할 수 있는 점이 큰 특징입니다.
이 도구가 눈길을 끄는 이유는 단순히 그림만 그려주는 데서 끝나지 않고, '검증 가능한' 다이어그램을 만들어 내기 때문이에요. 아키텍처, 워크플로우(스윔레인 방식), 시퀀스, 데이터 흐름, 상태 머신 등 상황에 맞는 시각적 형식을 알아서 골라 줍니다. 게다가 다크/라이트 테마 지원은 물론, 화면 확대나 축소에 따라 정보량을 조절하는 MAP→READ→FULL 단계별 표시, PNG·SVG 내보내기 기능까지 알차게 갖추고 있어요. "Redis를 추가해 줘"나 "인증 박스를 왼쪽으로 옮겨 줘" 같은 자연어 요청만으로 그림을 계속 수정할 수 있어서, 실무에서 시스템 구조를 자주 설명해야 하는 분들에게 아주 매력적인 도구입니다.
강의용 팁
AI 개발 강의에서 "에이전트가 코드를 이해하고 문서를 자동으로 작성하는 사례"를 소개할 때, Archify는 정말 훌륭한 실습 재료가 됩니다. 수강생들에게 간단한 웹앱 저장소나 예시 코드를 주고, 에이전트에게 "이 저장소의 런타임 아키텍처를 그려줘"라고 요청해서 실제로 HTML 다이어그램이 만들어지는 과정을 직접 보여줘 보세요. 그런 다음 "인증 흐름을 더 강조해 줘"라거나 "데이터베이스 노드 색상을 바꿔 줘" 같은 자연어 수정 요청을 실습해 보면, AI와 대화하며 결과물을 다듬는 감각을 자연스럽게 익힐 수 있습니다.
또한 "검증기가 그림의 정확성을 자동으로 확인한다"는 개념은 AI 신뢰성 수업의 좋은 예시가 됩니다. AI가 만든 결과물을 사람이 매번 눈으로 확인하는 대신, 규칙 기반의 검증 로직을 따로 두어 품질을 보장하는 구조인데요. 이는 코드 리뷰나 콘텐츠 생성 같은 다른 AI 활용 분야에도 똑같이 적용되는 핵심 원리예요. 따라서 "AI 출력 + 검증 시스템"의 조합이 왜 중요한지 설명할 때 실무 도구로 보여주시면 수강생들의 이해도와 설득력을 훨씬 높일 수 있습니다.
주의 사항
Archify는 Cursor, Claude Code, Codex, OpenCode, Raven 등 특정 AI 에이전트 환경에 설치해 쓰는 스킬이라, 해당 에이전트가 설치되어 있지 않다면 바로 사용해 보기 어려울 수 있어요. 원문에는 v2.13.0이라는 특정 버전과 함께 APINEBULA, EverMind 같은 후원사의 할인·프로모션 안내가 들어 있는데요. 이런 버전 정보나 프로모션 조건은 시간이 지나면 바뀌거나 끝날 수 있으니, 실제로 사용하기 전에는 GitHub 저장소에서 최신 정보를 직접 확인해 보시는 게 좋습니다. 아울러 배포 소유권 검증 같은 고급 기능은 실제 인프라를 실시간으로 조회하는 방식이 아니라, 사용자가 입력한 정보(authored facts)만을 기준으로 검증한다는 점도 미리 알아두시면 도움이 됩니다.
자체 검증
본문의 주요 내용들을 원문과 대조해 본 결과 대부분 정확히 일치합니다. Archify가 저장소나 시스템 설명을 바탕으로 타입이 정의된 JSON 중간 표현을 생성하고 검증기가 이를 검사한다는 내용은 자료1과 자료3에 잘 나타나 있어요. 별도 서버나 런타임 없이 단일 HTML 파일로 결과물이 나온다는 점, Cursor·Claude Code·Codex·OpenCode·Raven을 지원한다는 점, 그리고 "Redis 추가" 같은 자연어 수정이 가능하다는 사실도 자료2와 자료3에서 확인할 수 있습니다. 다만 v2.13.0 버전 정보나 스폰서(APINEBULA, EverMind) 관련 내용은 시점에 따라 변경될 수 있으므로, 원문대로 언급하되 최신 정보는 독자가 직접 확인해 보시길 권장해 드립니다. 마지막으로 강의 활용 팁 부분은 원문에 직접 나온 내용이 아니라, 도구의 특징을 바탕으로 필자가 새로 제안한 아이디어라는 점을 알려드립니다.
태그
#AI #Archify #시스템설계 #다이어그램 #개발자도구 #에이전트 #교육
원문
https://discuss.pytorch.kr/t/archify/11536
https://tt-a1i.github.io/archify/
https://github.com/tt-a1i/archify