Archify, 아이디어, 계획, 코드베이스를 대화형 다이어그램으로

에이전트 스킬 Archify는 평이한 말로 적은 시스템 설명이나 코드 구조를 받아 브라우저에서 바로 열어 탐색할 수 있는 대화형 HTML 파일 하나로 돌려준다. 사용자는 이 파일에서 노드를 하나씩 클릭하고, 스타일과 테마를 바꾼 뒤 결과물 그대로 다른 사람에게 건넬 수 있다.
브라우저에서 API를 거쳐 Redis를 확인하고 캐시 미스가 나면 PostgreSQL을 조회해 채우는 식으로 요청 경로가 한 문단에 담기 벅찰 만큼 커졌는데, 순서를 적어 둔 기록이라곤 몇 달 전 채팅 메시지뿐일 때 개발자는 Archify를 꺼내 든다. 줄글 대신 클릭해서 따라갈 수 있는 다이어그램이나 한 페이지짜리 해설 페이지를 받아야 할 때도 마찬가지다.
경로를 한 번만 설명해 두면 누군가 계속 다시 그려야 하는 그림이 아니라 읽는 사람이 직접 탐색할 수 있는 다이어그램이 된다.
2026년 11월 17일 기준 tt-a1i/archify 저장소는 스타 97,278개, 포크 6,641개, 미해결 이슈 370건을 기록했다. 2026년 4월 15일에 만들어진 지 일곱 달 만인 이날에도 가장 최근 푸시가 올라왔다.
없을 때와 있을 때
이 스킬이 없을 때 요청 경로를 설명해 달라고 하면 에이전트는 줄글로 답하거나 Mermaid 블록을 내놓는다. Mermaid 결과물은 렌더러에 붙여 넣은 뒤 엉뚱한 자리에 놓인 노드를 손으로 고쳐야 하고, 출력 형식이 고정되어 있지 않아 물을 때마다 답변 모양도 달라진다.
Archify를 불러온 상태에서는 같은 질문을 해도 파일 하나가 나온다. 에이전트가 대화형 HTML 결과물을 작성하면 사용자는 화면을 이동하고 확대·축소하며 소스 코드 링크를 따라가거나 나머지 그래프를 흐리게 두고 경로 하나만 짚어 볼 수 있다. "인증 추가해줘", "캐시 미스 경로 강조해줘", "라이트 테마로 바꿔줘"처럼 후속 요청을 보내면 새 답변을 처음부터 쓰는 대신 이미 만든 파일을 고친다.
무엇을 결정하나
Archify는 가장 먼저 출력 형식을 정한다. 구조를 묻는 질문에는 노드와 간선으로 이루어진 캔버스를 내놓고, "한 페이지로 답해줘"처럼 물으면 해설 페이지를 만든다. 해설 페이지는 결론을 맨 앞에 두고 질문마다 패널을 하나씩 배치하며, 검증을 통과한 표, 단계, 차트, 코드, 다이어그램을 함께 담는다.
다음으로 각 주장을 무엇으로 뒷받침할지 정한다. 에이전트가 저장소를 읽으면 발췌 내용이 특정 커밋에 고정되어 소스 카드에서 열리고, 해설 페이지 안의 주장에는 번호가 매겨진 출처가 달린다. 저장소를 넘기지 않으면 사용자가 적은 설명만으로 다이어그램을 그리므로 출처 링크가 붙지 않는다.
어디서 멈출지도 정한다. 마무리 단계에서는 마지막으로 정상 동작한 파일을 유지하기 때문에, 수정본이 검증을 통과하지 못하면 망가진 결과물로 덮어쓰지 않고 이전 버전을 그대로 남긴다. 네 가지 스타일과 라이트·다크 테마는 따로 내보내 관리하는 별개 파일이 아니라 하나의 파일 안에서 전환된다.
사용법
쓸 때
브라우저에서 캐시와 데이터베이스까지 이어지는 요청 단계를 말로 풀기는 쉬워도 줄글로 적어 순서를 맞추기는 까다로울 때다.
Archify로 웹 요청을 다이어그램으로 그려줘: 브라우저가 API를 호출하고, API는 Redis를 확인하며, 캐시 미스가 나면 PostgreSQL을 조회해 캐시를 채운다.
어떤 브라우저에서나 열리는 네 단계 HTML 다이어그램이 돌아오며, 각 노드를 클릭해 세부 내용을 확인할 수 있다.
쓸 때
단순한 그림이 아니라 원인을 논증해야 해서 한 페이지 분량의 해설이 필요할 때다.
Archify로 한 페이지로 답해줘: 평균 응답 시간은 거의 그대로인데 API의 P99가 80 ms에서 600 ms로 튀었어. 유력한 원인이 무엇이고 어떻게 조사해야 할까?
결론과 근거를 맨 앞에 두고 질문마다 패널을 여는 HTML 페이지가 나오며, 조사 단계는 관련 다이어그램 옆에 나란히 놓여 읽는 흐름에 맞춰 해당 부분을 밝혀 준다.
설치
https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt를 읽고 Archify를 설치해줘
이 한 줄을 Cursor, Claude Code, Codex CLI, 또는 OpenCode에 보내면 된다. 설치 후 가장 먼저 입력하는 것도 설정 항목이 아니라 그리고 싶은 내용을 적은 설명이다.
이 도구가 맞지 않을 때
Archify는 단독으로 실행하는 애플리케이션이 아니다. 에이전트가 불러와 쓰는 스킬이며 모든 결과물이 사용자가 작성한 프롬프트에서 나오므로, 에이전트 개입 없이 다이어그램을 생성해야 하는 상황에는 맞지 않는다.
결과물이 사람이 직접 열어 읽는 다이어그램이나 해설 페이지라면 Archify를 고르면 된다. 목적이 다르다면 아래 대안 중 하나를 선택하자.
| 저장소 | 대신 쓸 상황 | 스타 |
|---|---|---|
| morluto/rea | 각 부분이 어떻게 맞물리는지 설명하기보다 앱 동작부터 네이티브 바이너리까지 분해해 분석해야 할 때 | 464,832 |
| mattpocock/skills | 시각화에 초점을 맞춘 단일 스킬이 아니라 폭넓게 꺼내 쓸 엔지니어링 스킬 모음이 필요할 때 | 326,172 |
| obra/superpowers | 출력 형식보다 에이전트가 일하는 방식 자체를 잡는 프레임워크와 방법론이 필요할 때 | 318,833 |
설계 질문의 답을 읽는 사람이 직접 클릭해 볼 수 있어야 할 때 Archify가 제 몫을 한다. 도입도 이미 쓰고 있는 에이전트에 문장 한 줄을 보내는 것으로 끝난다.
많이 묻는 질문
어떤 에이전트에서 불러올 수 있나?
문서에 안내된 지원 대상은 Cursor, Claude Code, Codex CLI, OpenCode다. 설치 프롬프트를 에이전트가 직접 읽도록 써 두었기 때문에, 에이전트가 지침을 가져와 스킬을 배치한다.
저장소가 꼭 있어야 작동하나?
아니다. 설명만으로 바로 시작할 수 있고, 소스 코드가 뒷받침된 다이어그램을 원할 때만 에이전트에게 저장소를 읽으라고 하면 된다.
최종 결과물은 무엇이고 어디에 남나?
네 가지 스타일과 라이트·다크 테마를 갖춘 HTML 파일 하나가 생성되며 사용자가 그대로 보관할 수 있다. 필요하면 PNG, WebP, JPG 형태의 긴 이미지로 내보내거나 PDF로 인쇄할 수도 있다.
출처: tt-a1i/archify
'AI 스킬' 카테고리의 다른 글
| Open Design, OpenDesign, 코딩 에이전트가 디자인 결과물을 만드는 로컬 우선 워크스페이스 (0) | 2026.11.17 |
|---|---|
| Impeccable, 코딩 에이전트 UI를 다듬고 검토하는 디자인 어휘 (0) | 2026.11.16 |
| Paperclip, AI 에이전트 팀에 목표와 예산 배정하기 (0) | 2026.11.16 |

