품앗이 위키

graphify

4 min read

graphify

safishamsi/graphify — 안드레이 카르파티(Andrej Karpathy)의 LLM Wiki 개념을 Claude Code 스킬로 구현한 도구. 임의 폴더(코드·문서·논문·이미지·영상)를 쿼리 가능한 지식 그래프로 변환한다.

무엇을 하는가

3 패스 추출:

  1. AST 구조 추출 — 코드 파일에서 import/call 관계 (LLM 무사용, 결정적)
  2. 트랜스크립트 생성 — 영상·오디오는 faster-whisper 로컬 트랜스크립션
  3. 시맨틱 추출 — Claude 서브에이전트 병렬로 문서/이미지/트랜스크립트에서 개념·관계·근거 추출

산출물:

  • graphify-out/graph.html — 인터랙티브 시각화 (브라우저 단독)
  • graphify-out/graph.json — LLM 쿼리 인덱스 (RAG 백본)
  • graphify-out/GRAPH_REPORT.md — god nodes / 커뮤니티 / 놀라운 연결 / 빈틈 / 제안 질문
  • graphify-out/obsidian/ — Obsidian 호환 vault (per-node .md + Canvas)

지금 vs graphify 적용 후

항목옵시디언 기본graphify
연결 인식손으로 적은 [[wikilink]]만본문 읽고 암묵적 개념 관계까지 자동 추출
고립 노드못 봄자동 알람
카테고리 사이 다리백링크 없으면 안 보임”여러 폴더 잇는 브리지 개념” 자동 탐지
LLM 활용마크다운 그대로graph.json이 곧 LLM 쿼리 인덱스
빈 곳 발견직관”이 주제 비어있네요” 자동 제안

후니님 위키 1차 적용 결과 (2026-04-29)

  • 입력: wiki/ 86 .md, 56K 단어
  • 결과: 390 노드 / 724 엣지 / 16 커뮤니티
  • 토큰 절감: 평균 15.6배 (일부 질문 54배)
  • god nodes: [품아이] · [품앗이생협] · 품아이 전체 지도(28)
  • 자동 식별된 다리: 품아이 전체 지도(6 커뮤니티 잇음), 도메인AI 사업(7 커뮤니티 잇음)
  • 자동 발견된 빈틈: 161개 고립 노드 (글감 풀)

명령어

위키 갱신 시 1회 실행 (수동):

cd ~/poomasi/poomasi-notes && /graphify ./wiki --update

자연어로 그래프 쿼리:

graphify query "왜 품아이가 5법인 컨소시엄과 연결되나" --budget 1500
graphify path "품아이" "사회지능"
graphify explain "도메인특화AI"

품아이 RAG 백본으로 통합 (Phase 1 대기)

graph.json을 품아이 엔진(engine.py)에 메모리 로드 + Gemini 프롬프트 prefix로 주입 → ChromaDB(벡터 유사도)와 병존하여 “이게 뭐야”(ChromaDB) + “왜 연결되나”(graph) 둘 다 답 가능.

상세 설계: graphify_rag_백본_설계

함정

graphify install --platform claude는 ~/.claude/CLAUDE.md 끝에 3줄 자동 추가한다 (스킬 트리거 안내). L1 코어 CLAUDE.md 운영 환경에서는 미리 인지. graphify claude install(대시 없는 풀 버전)은 PreToolUse 훅까지 추가 — 더 위험.

관련

그래프 뷰