AI 칼럼

문서@donghyeok99운영진

Archify: 한 문장을 인터랙티브 다이어그램으로

한 문장 설명을, 눌러서 경로를 따라가는 다이어그램 HTML 한 장으로 바꿔 주는 에이전트 스킬

에이전트에게 한 문장을 건네면 Browser·API·Redis·PostgreSQL 구조도가 생기고, 캐시 미스 경로가 빛난 뒤 네 가지 검사를 통과한 HTML 파일이 나와요
에이전트에게 한 문장을 건네면 Browser·API·Redis·PostgreSQL 구조도가 생기고, 캐시 미스 경로가 빛난 뒤 네 가지 검사를 통과한 HTML 파일이 나와요
누가
tt-a1i가 만든 오픈소스 에이전트 스킬이에요. 시스템이나 계획을 그림으로 설명해야 하는 사람을 위해 만들었어요
언제
2026년 4월 저장소가 열렸고, 최신 릴리스는 2026년 10월 19일의 v3.2.0이에요
어디서
Claude Code, Codex CLI, Cursor, OpenCode에서 Node.js 18 이상으로 로컬 실행, 결과는 브라우저에서 여는 HTML 파일

이게 불편했어요

시스템 구조나 계획을 남에게 설명하려면 그림이 필요한데, 그릴 때마다 상자를 하나씩 놓고 화살표를 이어야 했어요. 다 그려도 이미지 한 장이라, '캐시 미스일 때 경로만 보여 줘' 같은 질문이 오면 다시 그려야 했고요.

그래서 이렇게 풀어요

Archify는 에이전트에게 말로 설명하면 다이어그램을 HTML 파일 한 장으로 돌려줘요. 핵심은 에이전트가 그림을 직접 그리는 대신 타입이 정해진 JSON을 쓰고, 검증과 실제 브라우저 검사를 모두 통과한 결과만 파일이 된다는 점이에요. 받은 파일에서는 노드를 눌러 위아래로 이어진 곳을 따라가고, 두 지점 사이 경로를 강조하고, 테마를 바꾸거나 이미지로 내보낼 수 있어요. 그다음엔 '인증 추가해 줘'처럼 채팅으로 고쳐 나가면 돼요.

35초 데모: 한 문장으로 저장소를 지도로 만들고, 소스 링크와 경로를 따라가요
한 페이지 설명서: 답이 먼저 오고, 단계 옆의 시퀀스 다이어그램이 함께 밝아져요
한 페이지 설명서: 답이 먼저 오고, 단계 옆의 시퀀스 다이어그램이 함께 밝아져요
사용자가 만든 상하이 4일 CityWalk 일정. 날짜를 바꾸고 장소를 눌러 지도로 가요
사용자가 만든 상하이 4일 CityWalk 일정. 날짜를 바꾸고 장소를 눌러 지도로 가요
캐시 미스 시퀀스에서 Web App부터 Postgres까지 경로만 강조한 화면
캐시 미스 시퀀스에서 Web App부터 Postgres까지 경로만 강조한 화면

이걸로 만든 사람들

GitHub@staygrounded12026-10-16

공무원 진로를 소개하는 영상을 에이전트(WorkBuddy, DeepSeek 모델)에게 정리시켜, 국가 시험·성 시험·선조생 세 갈래를 레인별 워크플로 다이어그램으로 만들어 올렸어요.

是参考一个介绍编制的视频 针对他的视频让ai跑了一下 包含图表,方便以后查看
댓글 0 (2026-10-30 기준)GitHub ↗
GitHub@naveen160042026-08-30

Gemini Chat에 이 한 문장을 주고, Python 라우터와 Ollama·Llama 3로 도는 로컬 AI 비서 'Guts'의 구조도를 만들어 HTML과 검증 결과를 함께 올렸어요.

Map a privacy-first local AI assistant using a Python router to manage context, with Ollama handling local Llama 3 inference.
댓글 0 (2026-10-30 기준)GitHub ↗
GitHub@pioneer666-user2026-09-06

학생인 작성자가 Codex로 가상의 행사 신청 시스템 워크플로를 그린 뒤, 노드마다 쉬운 설명과 그 소스 줄을 붙여 주는 읽기 레이어를 덧붙여 공개했어요.

a small reading layer that sits on top of an Archify diagram and explains every node in plain language, paired with the exact source lines behind it
댓글 4 (2026-10-30 기준)GitHub ↗

안에서는 이렇게 돌아가요

  1. 1

    나 → Claude Code · Codex

    "웹 요청을 그려 줘" 같은 한 문장말로 한 설명이나 Mermaid, 또는 저장소를 읽어 달라는 요청으로 시작해요archify/SKILL.md
  2. 2

    Claude Code · Codex → archify/SKILL.md

    10가지 유형 중 하나와 그 스키마·예제Type router 표에서 유형을 고르고, 그 유형의 스키마와 예제를 읽어요archify/SKILL.md
  3. 3

    Claude Code · Codex → candidate.json

    .archify/<type>-<slug>-<시각>/ 폴더에 JSON좌표를 그리는 대신 노드, 관계, 라벨을 스키마에 맞는 JSON으로 써요archify/schemas/architecture.schema.json
  4. 4

    candidate.json → archify.mjs finalize

    finalize <type> candidate.json --quality showcasevalidate, deliver, check, browser-check 네 관문을 차례로 돌리고 처음 막힌 곳에서 멈춰요archify/bin/finalize.mjs
  5. 5

    archify.mjs finalize → Claude Code · Codex

    실패하면 규칙 코드와 supportedFixes어디가 왜 막혔는지 JSON으로 돌려주고, 에이전트는 두 번까지 고쳐 다시 돌려요archify/renderers/shared/diagnostics.mjs
  6. 6

    archify.mjs finalize → <slug>.html

    통과한 HTML만 기존 파일과 교체검사를 통과한 후보만 파일을 바꾸고, 실패하면 직전의 좋은 파일이 그대로 남아요archify/renderers/shared/atomic-output.mjs

넣으면 이렇게 나와요

Browser -> API -> Redis cache -> PostgreSQL fallback.캐시 미스 경로를 따라갈 수 있는 구조도 HTML
API P99가 80 ms에서 600 ms로 뛴 이유결론이 먼저 오고 패널마다 표, 단계, 다이어그램이 있는 한 페이지 설명서
상하이 CityWalk 가이드D1–D4를 바꿔 보고 장소에서 지도 앱으로 넘어가는 4일 일정
mco-org/mco 저장소커밋 9f1a1cf에 고정된 소스 링크가 달린 런타임 구조도

나한테 맞을까요

이럴 때 좋아요

  • 새로 맡은 저장소의 구조를 한 장으로 파악하고 싶을 때
  • API 호출이나 캐시 미스 같은 흐름을 팀에 보여 줘야 할 때
  • DB 스키마를 표와 키가 다 보이는 ERD로 정리할 때
  • 여행 일정, 학습 계획처럼 단계가 있는 계획을 정리할 때
  • 질문에 대한 답을 결론부터 보이는 한 페이지로 공유하고 싶을 때

이건 안 돼요

  • Mermaid 자동 변환, 범용 자동 레이아웃, 호스팅 공유, WYSIWYG 편집은 지금 범위 밖이에요
  • Timeline·Waterfall 예제의 시각과 시간은 예시 값이라, 로그나 트레이스에서 가져온 값일 때만 실제로 봐야 해요
  • Claude.ai에 zip으로 올리면 샌드박스에서 Node.js를 쓸 수 있어야 하고, 프로젝트 지식으로 올리면 프롬프트만으로 구조도를 그려요
  • 대시보드를 만드는 용도는 아니에요

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기