JunHo Kim
25256ec417
Extracted and cleaned up from a prior WSL/Windows agent-memory setup. Contains only project-agnostic content: - Claude_Memory/: feedback rules, user profile, reusable reference docs, session scratch space (claude_info/, claude_log/), mirrored skill defs - caveman/: ultra-compressed communication mode skill + subcommands - html-slide-deck/: self-contained HTML slide deck builder skill Project-specific knowledge (previously mixed in) was moved out to each project's own repository as part of this cleanup.
89 lines
3.1 KiB
Markdown
Executable File
89 lines
3.1 KiB
Markdown
Executable File
---
|
|
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`) 사용으로 토큰 절감.
|