핵심 내용
GeekNews 최신 글 페이지에서 9월 26일 오전 기준 가장 최근 등록된 개발 도구는 Archify였다. GeekNews 요약만 재사용하지 않고 원본 GitHub 저장소를 확인했다. Archify는 Cursor, Claude Code, Codex CLI, OpenCode 등에서 사용할 수 있는 Agent Skill로, 시스템을 자연어로 설명하거나 repository를 분석한 뒤 Architecture, Workflow, Sequence, Data Flow, Lifecycle 형태의 대화형 다이어그램을 생성한다.
결과물은 별도 서버가 필요한 전용 포맷이 아니라 하나의 self-contained HTML이다. 이를 브라우저에서 열면 노드 상세정보와 경로 탐색 등을 사용할 수 있고 Archify가 설치되지 않은 사용자에게도 HTML 파일만 전달하면 된다. 사용자는 Agent와 대화를 이어가면서 인증영역을 추가하거나 특정 경로를 강조하는 식으로 도면을 반복 수정할 수 있다.
코드 분석에서 특히 유용한 기능은 source-backed architecture다. 요청하면 다이어그램의 구성요소가 실제 Git repository의 파일과 line range를 근거로 표시되고 특정 public commit을 기준으로 증거를 연결할 수 있다. 프로젝트는 typed JSON IR을 사용하고 schema·layout·HTML/SVG·route 검증을 통과해야 결과물을 교체하도록 설계했다.
현재 README에는 npx skills add tt-a1i/archify -g 방식의 설치가 안내돼 있다. 업데이트 확인은 고정된 stable manifest만 조회하고 자동으로 업데이트를 내려받거나 설치하지 않으며, 프로젝트·프롬프트·Agent·계정·기기 정보를 이 확인 요청에 보내지 않는다고 설명한다. 네트워크 업데이트 확인도 설정으로 비활성화할 수 있다.
배경
코딩 Agent가 대형 repository를 직접 수정하는 일이 늘면서 사람이 모든 코드를 순차적으로 읽기 전에 시스템 구조와 변경범위를 이해하는 도구가 중요해지고 있다.
기존 수동 architecture diagram은 코드가 변경되면 쉽게 낡지만, Agent가 repository를 다시 읽고 근거까지 연결할 수 있다면 문서 갱신비용을 크게 낮출 여지가 있다.
산업·시장에 미치는 영향
코딩 Agent 생태계의 경쟁영역이 코드 생성에서 사람이 Agent의 결과를 이해하고 검토하는 visualization·provenance 계층으로 확대될 수 있다.
다만 Archify가 실제 운영중인 infrastructure topology를 자동 관측하는 도구는 아니다. 코드와 작성된 정보를 바탕으로 구조를 표현하므로 실제 runtime 상태와 동일하다고 가정해서는 안 된다.
실무에서 바로 활용할 수 있는 시사점
대형 프로젝트에 곧바로 전면 도입하기보다 서비스 하나를 대상으로 repository 기반 architecture diagram을 만들고 사람이 실제 코드와 대조하는 POC가 적절하다.
설계문서에는 source-backed 모드를 사용하고 commit을 고정해 다이어그램이 어느 코드 버전을 근거로 하는지 남기면 특히 유용하다.