3.1 KiB
3.1 KiB
name, description, metadata
| name | description | metadata | ||
|---|---|---|---|---|
| reference_graphify | graphify 도구 전체 개요 — 설치·실행 방법, 출력물 위치, 쿼리 방법 |
|
개요
graphify (pip 패키지명: graphifyy)는 폴더의 코드·문서·이미지·영상을 Knowledge Graph로 변환하는 도구.
트리거: /graphify 슬래시 명령 → Skill tool skill: "graphify" 호출 필수.
공유 리소스 가능성: graphify 출력물을 다른 AI Agent(예: Google Antigravity)와 공유하는 경우, 출력물 수정·재빌드 시 다른 Agent의 참조에 영향을 줄 수 있으므로 주의.
- Skill 위치:
Claude_Memory/claude_skills/graphify/SKILL.md
출력물 구조 (graphify-out/)
| 파일 | 설명 |
|---|---|
GRAPH_REPORT.md |
코드베이스 질문 시 먼저 읽어야 할 파일. God Nodes·커뮤니티·Surprising Connections 포함 |
graph.json |
원본 그래프 데이터 (GraphRAG-ready JSON) |
graph.html |
브라우저에서 여는 인터랙티브 시각화 |
manifest.json |
이전 실행 기록 (incremental update용) |
cache/ |
파일별 시멘틱 추출 캐시 |
.graphify_labels.json |
커뮤니티 레이블 |
.graphify_python |
사용 중인 Python 인터프리터 경로 |
.graphify_root |
스캔 루트 경로 |
주요 명령
# 최초 빌드
/graphify <path>
# 변경 파일만 재추출 (코드만 변경 시 LLM 불필요)
/graphify <path> --update
# 그래프 질문 (BFS: 넓은 컨텍스트)
/graphify query "<질문>"
# 그래프 질문 (DFS: 특정 경로 추적)
/graphify query "<질문>" --dfs
# 두 개념 간 최단 경로
/graphify path "<A>" "<B>"
# 단일 노드 설명
/graphify explain "<노드명>"
# 커뮤니티 재클러스터링만 (추출 생략)
/graphify <path> --cluster-only
관리 정책
- graphify 출력물(
graphify-out/)은 대상 프로젝트 루트가 아니라 이 메모리 폴더(Agent_Memories) 하위에서 관리하는 것을 기본 원칙으로 한다 (프로젝트 저장소를 캐시로 오염시키지 않기 위함). - 프로젝트별로 스캔 제외 규칙(불필요한 대용량/생성물 폴더)이 필요할 수 있음 — 대상 프로젝트의
.gitignore패턴을 기본으로 따르고, 프로젝트 전용 제외 규칙은 해당 프로젝트의 자체 메모리/문서에 기록한다.
사용 규칙 (CLAUDE.md에서)
- 소스 파일 읽기·grep/glob 검색·코드베이스 질문 전 항상
graphify-out/GRAPH_REPORT.md먼저 읽기 graphify-out/wiki/index.md존재 시 raw 파일 대신 탐색- 교차 모듈 관계 질문: grep 대신
graphify query/path/explain우선 - graphify 출력물은 대상 프로젝트 루트가 아닌 이 메모리 폴더 하위에서 관리
설치 확인
# uv 기반 (권장)
uv tool install --upgrade graphifyy
# pip 기반
pip install graphifyy --break-system-packages
GEMINI_API_KEY 또는 GOOGLE_API_KEY 미설정 시 → Claude Code 서브에이전트로 시멘틱 추출 수행.
설정 시 → Gemini(gemini-3-flash-preview) 사용으로 토큰 절감.