월~금 오전 7시, 일요일 오전 8시 — AI 뉴스와 용어를 보내드립니다메일로 받아보기

METAL LAB

tt-a1i/archify

★ 17,151오늘 +1,002HTML

코드 저장소를 채팅으로 설명하면 검증된 아키텍처 다이어그램을 그려주는 AI 에이전트 스킬

Archify는 코드베이스나 시스템 설명을 채팅에서 바로 인터랙티브한 시스템 지도로 바꿔주는 에이전트 스킬이다. Cursor, Claude Code, Codex CLI, OpenCode 같은 AI 코딩 도구에 설치해 사용하며, 만들어진 결과물은 하나의 HTML 파일로 저장되어 공유할 수 있다. 그림을 그리기 전에 형식이 맞는지 자동으로 검사하는 절차를 거쳐, 실제로 존재하지 않는 연결을 지도에 그리지 않도록 한다.

무엇을 하는 레포인가

  1. 구조(Architecture), 작업흐름(Workflow), 순서(Sequence), 데이터흐름(Data Flow), 생명주기(Lifecycle) 5가지 다이어그램 유형을 지원하고 다크/라이트 테마와 4가지 프리셋을 제공한다.
  2. 자연어 설명을 '타입이 정해진 JSON 중간표현(IR)'으로 만든 뒤, 스키마·레이아웃·HTML/SVG·경로 검사를 모두 통과해야 최종 결과물로 교체되는 방식으로 동작한다.
  3. 전(Before)/변경(Delta)/후(After) 두 스냅샷을 비교해 추가·삭제·변경·이동된 사실을 정확히 보여주는 아키텍처 리뷰 기능을 제공한다.
  4. 노드 검색, 상류/하류 추적, 경로 탐색, 역할 비교, 안내형 스토리 재생 등의 상호작용이 실제 저장된 관계만 사용하며 존재하지 않는 연결을 만들어내지 않는다.
  5. 최종 산출물은 PNG, SVG, WebM, 1200×630 공유 카드로 내보낼 수 있는 하나의 자체완결 HTML 파일이다.
  6. 실제 공개 저장소 mco-org/mco를 커밋 9f1a1cf 기준으로 추적해 만든 실제 지도 사례를 제공한다.

왜 중요한가

개발자가 복잡한 시스템 구조를 문서화하거나 팀에 설명할 때, 손으로 그림을 그리는 대신 채팅 몇 마디로 검증된 다이어그램을 얻을 수 있다. 또한 아키텍처 변경 전후를 비교하는 기능은 코드 리뷰나 PR 검토 과정에서 구조적 변화를 명확히 파악하는 데 도움이 된다.

이 레포의 용어

  • 에이전트 스킬(Agent Skill) · AI 코딩 어시스턴트에 설치해 특정 작업을 수행하게 만드는 확장 기능
  • JSON IR(중간표현) · 다이어그램 내용을 저장하는 구조화된 JSON 형식으로, 여기서 최종 그림이 만들어진다
  • 자체완결 HTML(self-contained HTML) · 외부 파일 없이 하나의 파일로 모든 그림과 동작이 담긴 웹 파일
  • 상류/하류 추적(upstream/downstream reach) · 한 구성요소를 기준으로 그 앞뒤로 연결된 요소들을 따라가 보는 기능
  • 공유 카드(share card) · 소셜미디어나 문서에 붙이기 좋게 만든 1200×630 크기의 이미지

레포 원문 소개 (영문)

Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.

GitHub에서 보기

주목받는 레포

레포 전체 보기 →

METAL LAB 최신 기사