프로젝트 소개
Archify는 Cursor, Claude Code, Codex CLI, OpenCode 같은 AI 코딩 에이전트를 위한 스킬로 설계된 Node.js 렌더링 및 검증 시스템입니다. 에이전트가 코드베이스나 자연어 시스템 설명을 타입이 지정된 JSON 중간 표현으로 변환하면, Archify가 이를 결정론적으로 자체 완결된 HTML/SVG 다이어그램으로 컴파일합니다. 리포지토리가 필수는 아니며, 사용자가 채팅에서 시스템을 직접 설명할 수도 있습니다.
다섯 가지 다이어그램 유형을 지원합니다: 아키텍처, 워크플로, 시퀀스, 데이터 플로우, 라이프사이클. 각 유형에는 여러 시각적 프리셋, 다크 및 라이트 테마, 내장 브랜드 마크, 제한된 모션이 제공됩니다. 생성된 뷰어에서는 노드 검색, 업스트림/다운스트림 도달 범위 추적, 정확한 경로 조사, 의미적 역할 비교, 가이드 스토리 재생이 가능합니다. 안정적인 딥 링크로 포커스, 뷰, 경로, 렌즈, 도달 상태를 복원할 수 있습니다.
Architecture Delta 모드는 두 개의 검증된 스냅샷을 Before, Delta, After로 비교하며 기계 판독 가능한 리시트를 제공합니다. 추가, 제거, 변경, 이동, 경로 변경 사실이 목록으로 표시됩니다. 아티팩트는 전달 전에 검증되며, 검증 실패 시 안정적인 규칙 코드, 측정된 증거, 지원되는 수정 방법이 함께 제공됩니다. 내보내기 형식은 PNG, SVG, WebM, 1200x630 공유 카드이며, 특정 작성 경로에 대한 경로 및 도달 범위 공유 카드도 지원합니다. 선택적 소스 증거 링크는 공개 커밋에 고정된 Git 검증 파일과 라인 범위를 엽니다.
설치는 npx skills add tt-a1i/archify -g로 가능하며, 전역 및 프로젝트 설치 방법, Raven용 수동 ZIP 옵션, 커뮤니티 DeepSeek Harness 플러그인도 제공됩니다. CLI에는 doctor, demo, guide, validate, preview, deliver 명령이 포함됩니다. preview 명령은 명시적인 루프백 전용 데스크톱 감시자를 실행하며, 저장이 불완전하거나 유효하지 않을 때 마지막으로 검증된 출력을 유지합니다. validate와 deliver는 결정론적 복구 가이드와 함께 JSON 진단을 출력합니다.
Archify는 범용 드로잉 에디터나 Mermaid 테마가 아니며, 기술적 의도를 커뮤니케이션 아티팩트로 전환하는 데 중점을 둡니다. MIT 라이선스로 제공되며, 변경 로그, 로드맵, 스키마 참조, 생성된 예제 아티팩트의 Proof Lab을 포함합니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.