LLM Wiki

Archify: 코드베이스를 검증된 대화형 시스템 맵으로 바꾸는 에이전트 스킬

Properties2
descriptionPyTorchKR 9bow 게시글의 핵심 내용과 실무적 의미를 원문에 근거해 정리한다.
tagsai-models, open-source, research

6 min read

출처

Archify: 코드베이스를 검증된 대화형 시스템 맵으로 바꾸는 에이전트 스킬

개요

Archify는 코드베이스나 시스템 설명을 에이전트가 타입이 정의된 JSON 중간 표현(Typed JSON IR)으로 변환하고, 이를 검증된 대화형 HTML 다이어그램으로 만드는 에이전트 스킬입니다. 검증기는 스키마, 레이아웃, HTML/SVG, 경로, 라벨과 경로 사이의 간격 등을 검사하며, 모든 검사를 통과한 결과만 원자적으로 산출물에 반영합니다. 실패 시에는 스택 트레이스 대신 규칙 코드, 문제 대상, 측정값, 지원되는 수정 방법을 JSON으로 반환합니다. 아키텍처·워크플로·시퀀스·데이터 흐름·생명주기 다이어그램을 지원하며, 결과물은 별도 의존성 없이 열 수 있는 HTML 파일과 PNG·SVG·WebM·공유 카드입니다.

핵심 포인트

  • 에이전트 중심의 레이아웃 판단: 범용 자동 레이아웃에 전적으로 맡기지 않고, 에이전트가 계층·간격·경로·강조를 선택합니다. 공유 연결점은 화살표가 한곳에 몰리지 않도록 결정적으로 분산됩니다.
  • 5가지 다이어그램 유형: 아키텍처, 워크플로, 시퀀스, 데이터 흐름, 생명주기를 각각 별도 렌더링 모드로 제공합니다.
  • 검증 중심 파이프라인: Generate → Validate → Preview(선택) → Deliver → Iterate 단계로 동작하며, 검증된 개정본만 미리보기와 최종 산출물에 반영합니다.
  • 부분 수정과 진단 지원: validate --json 및 deliver --json의 diagnostics[]와 supportedFixes를 이용해 문제가 있는 부분만 수정하도록 설계되었습니다.
  • 델타 리뷰 기능: 검증된 두 아키텍처 스냅샷을 Before / Delta / After로 비교해 추가·삭제·변경·이동·재경유된 사실을 ID 단위로 보여주고 영수증을 남깁니다. 다만 영향도나 위험도를 추론하지는 않습니다.
  • 대화형·공유 가능한 결과물: 생성된 HTML에서 노드 검색, 상·하류 추적, 경로 조사, 의미 역할 비교, 스토리 재생을 지원하며 #focus=, #route=, #lens=, #view= 딥 링크로 상태를 공유할 수 있습니다.
  • 범위와 설치 방식: Raven, Cursor, Claude Code, Codex CLI, opencode에서 사용할 수 있고 npx skills add tt-a1i/archify -g로 설치합니다. 글에서는 안정 버전을 v2.13.0으로 소개하며 MIT 라이선스를 적용한다고 설명합니다.

왜 중요한가

Archify는 다이어그램을 단순히 렌더링하는 것보다 코드와 설명을 바탕으로 만든 구조가 일정한 검증을 통과하도록 하는 데 초점을 둡니다. 따라서 온보딩, 설계 리뷰, 장애 회고, CI 또는 PR 검토에서 반복적으로 사용하는 시스템 맵의 일관성과 수정 가능성을 높일 수 있는 구조를 제시합니다.

다만 자동 Mermaid 파싱, 범용 자동 레이아웃, WYSIWYG 편집, 호스팅 기반 공유는 현재 범위에 포함되지 않습니다. 기존 Mermaid 문서를 자동 변환하려는 도구라기보다, 에이전트가 기술적 의도를 해석해 검증된 전달용 산출물로 만드는 도구에 가깝습니다.

후속으로 볼 링크와 키워드

관련 위키

원문 보존 위치

원문 전체는 raw source: 2026-08-06-pytorchkr-topic-11536-archify에 source_url 및 HTML 원문과 함께 저장되어 있습니다.