89 lines
3.1 KiB
Markdown
89 lines
3.1 KiB
Markdown
---
|
|
name: reference_graphify
|
|
description: graphify 도구 전체 개요 — 설치·실행 방법, 출력물 위치, 쿼리 방법
|
|
metadata:
|
|
type: reference
|
|
---
|
|
|
|
## 개요
|
|
|
|
`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` | 스캔 루트 경로 |
|
|
|
|
---
|
|
|
|
## 주요 명령
|
|
|
|
```bash
|
|
# 최초 빌드
|
|
/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에서)
|
|
|
|
1. **소스 파일 읽기·grep/glob 검색·코드베이스 질문 전 항상 `graphify-out/GRAPH_REPORT.md` 먼저 읽기**
|
|
2. `graphify-out/wiki/index.md` 존재 시 raw 파일 대신 탐색
|
|
3. 교차 모듈 관계 질문: grep 대신 `graphify query/path/explain` 우선
|
|
4. graphify 출력물은 대상 프로젝트 루트가 아닌 이 메모리 폴더 하위에서 관리
|
|
|
|
---
|
|
|
|
## 설치 확인
|
|
|
|
```bash
|
|
# 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`) 사용으로 토큰 절감.
|