tt-a1i/archify

해결하는 문제

Archify는 기술적 설명이나 기존 코드베이스를 인터랙티브하고 정교한 시스템 맵으로 변환합니다. 복잡한 시스템 내 구성 요소 간의 실제 관계를 추적할 수 없고, 정밀도가 부족하며 검증이 불가능한 정적이고 일반적인 다이어그램의 문제를 해결합니다.

작동 방식

Archify는 AI 에이전트(Cursor, Claude Code, Codex CLI 등)를 위한 렌더링 및 검증 시스템으로, 다음과 같은 단계로 작동합니다:

1. 생성: AI 에이전트가 시스템 설명을 기반으로 타입이 지정된 JSON 중간 표현(IR)을 생성합니다.
2. 검증: 포함된 검증기와 레이아웃 규칙을 실행하여 JSON 소스의 정확성과 레이아웃의 결정론적 성격을 보장합니다.
3. 미리보기/배포: 검증된 JSON을 자체 포함형 HTML/SVG 파일로 컴파일합니다. 이 파일에는 사용자가 맵을 탐색하고 경로를 추적하며 가이드된 스토리를 재생할 수 있는 인터랙티브 뷰어가 포함되어 있습니다.
4. 반복: 구조적 안정성을 유지하면서 JSON 소스를 업데이트함으로써 다이어그램을 개선할 수 있습니다.

대상 사용자

AI 지원 도구를 사용하여 시스템 설계를 전달하거나, 병합 전 아키텍처 변경 사항을 검토하거나, 새 팀원을 위한 코드베이스 문서화가 필요한 소프트웨어 아키텍트, 개발자, 기술 리더.

주요 기능

• 다섯 가지 다이어그램 유형: 아키텍처, 워크플로우, 시퀀스, 데이터 흐름, 라이프사이클 다이어그램을 지원합니다.
• 결정론적 렌더링: 타입이 지정된 JSON IR을 사용하여 일반적인 자동 레이아웃이 아닌 재현 가능하고 일관된 레이아웃을 보장합니다.
• 아키텍처 차이 분석: 두 개의 검증된 스냅샷을 비교하여 시스템 아키텍처에서 정확히 무엇이 추가, 제거, 이동되었는지 확인할 수 있습니다.
• 인터랙티브 탐색: 노드 검색, 상류/하류 도달 범위 추적, 특정 방향 경로 조사 기능을 포함합니다.
• 포터블 출력: PNG, SVG, WebM, 공유 카드로 내보낼 수 있는 단일 HTML 파일을 생성합니다.
• 소스 기반 연결: 요청 시 아키텍처 노드를 Git 검증된 파일과 행 범위에 연결할 수 있습니다.