LLM Wiki

Graphify

4 min read

Graphify

한 줄 정의

Graphify는 프로젝트 코드와 문서를 지식 그래프로 변환하는 Claude Code 스킬로, /graphify 명령어 한 번으로 전체 프로젝트 구조를 AI가 이해하기 쉬운 형태로 압축한다.

핵심 요지

  • 컨텍스트 절감: Karpathy 저장소 + 5편 논문 + 4개 이미지 기준 71.5배 토큰 절감
  • 멀티모달 통합: 코드, PDF 논문, 이미지, 영상을 하나의 그래프로 연결
  • 신뢰도 투명화: 모든 관계가 EXTRACTED/INFERRED/AMBIGUOUS 태그로 구분됨
  • 지속적 메모리: graph.json과 GRAPH_REPORT.md가 세션 간 맥락을 유지

상세

Graphify는 프로젝트 평더를 입력받아 지식 그래프를 생성한다. 코드는 tree-sitter AST를 이용해 로컬에서만 처리하므로 API 비용이 들지 않는다. 문서와 이미지만 Claude API를 통해 개념을 추출한다.

주요 출력물 (graphify-out/ 평더):

  • graph.html: 인터랙티브 시각화
  • GRAPH_REPORT.md: God nodes, Surprising connections, Suggested questions
  • graph.json: 영속적 그래프 데이터
  • wiki/: 마크다운 위키 (—wiki 옵션)

핵심 명령어:

  • /graphify .: 현재 평더 전체 그래프화
  • /graphify query "...": 자연어 그래프 쿼리
  • /graphify ./docs --watch: 파일 변경 감시 및 자동 재빌드
  • /graphify add <url>: 외부 자원(YouTube, arXiv 등) 추가

15개 이상 플랫폼 지원: Claude Code, Codex, OpenCode, Cursor, GitHub Copilot, Aider 등.

예시

# 1단계: 프로젝트 그래프화
/graphify .
 
# 2단계: 특정 관계 질의
/graphify query "what connects auth to the database?"
 
# 3단계: 자동 동기화 설정
graphify hook install

바이브 코딩 활용

Graphify는 바이브 코딩을 체계화한다. AI가 매 턴 전체 코드베이스를 읽는 대신 그래프를 쿼리하면 비용이 급감하고, --wiki 모드로 생성된 마크다운을 통해 에이전트가 직접 파일을 탐색할 수 있다. 다중 에이전트가 병렬 작업할 때 중앙 그래프를 공유 컨텍스트로 활용하면 중복 파일 읽기를 방지한다.

충돌

없음

관련 노트

그래프 뷰

백링크