코드 워크스페이스에 Graphify를 깔고 코드베이스 학습·기술 부채 분석에 쓰기 위한 부트스트랩 패키지. 새 프로젝트마다 이 폴더 통째로 가져가서 5분 안에 셋업.
본 가이드의 모든 명령은 graphifyy v0.7.5+ (v0.7.6 포함)에서 검증.
Graphify는 폴더(코드·문서·논문·이미지·영상)를 queryable knowledge graph로 자동 변환하는 도구. AST + LLM 시멘틱 추출 + Leiden 클러스터링으로 god nodes·커뮤니티·의외 연결을 발견.
이 패키지의 범위 — 코드 워크스페이스 단독 사용:
- 새 프로젝트 온보딩 (코드베이스 학습)
- 기술 부채 식별 (과결합·분리 가능 모듈)
- 아키텍처 의도 추적 (god nodes·bridge nodes)
- 변경 영향 분석 (cross-module 관계)
이 패키지의 범위 외 — 별도 시스템 필요:
- PKM/세컨드 브레인 운영 (raw/wiki/Output 3계층) → Karpathy LLM Wiki 패턴 참조
- 다중 도메인 지식 누적 → 별도 wiki 볼트 부트스트랩
→ 이 패키지는 Graphify-only. wiki 시스템 만들지 않음. 기존 코드 디렉토리에 깔고 끝.
| 파일 | 청중 | 언제 |
|---|---|---|
README.md (this) |
모두 | 처음 한 번. 패키지 전체 그림 |
INSTALL.md |
AI 에이전트 + 사람 | 새 워크스페이스에 graphify 깔 때 |
USAGE.md |
사람 | 설치 후 일상 사용·베스트 프랙티스·FAQ |
templates/graphifyignore.template |
사람 | 새 워크스페이스 부트스트랩 시 .graphifyignore로 복사 |
templates/claude-md-section.template.md |
사람 | 기존 CLAUDE.md에 graphify 섹션 수동 통합 시 |
templates/claude-settings-hook.json |
사람 | .claude/settings.json PreToolUse hook 수동 등록 시 |
skills/graphify-bootstrap/SKILL.md |
AI 에이전트 | 새 워크스페이스에서 /graphify-bootstrap 한 줄로 자동 셋업 |
git clone https://github.com/lyunix/graphify_pkg ~/dev/graphify_pkg(선택, Claude Code 사용자) — 새 워크스페이스마다 /graphify-bootstrap 한 줄로 셋업하려면 스킬 글로벌 등록:
~/dev/graphify_pkg/bootstrap.sh또는 수동:
cp -R ~/dev/graphify_pkg/skills/graphify-bootstrap ~/.claude/skills/cd ~/dev/your-projectClaude Code 세션에서:
/graphify-bootstrap
→ 자동으로: CLI 확인·설치 → .graphifyignore 적용 → 첫 빌드 (옵션 A) → always-on hook → 검증 + god nodes top 5 보고.
cd ~/dev/your-project
pip install graphifyy # CLI 설치 (1회만, 머신당)
cp ~/dev/graphify_pkg/templates/graphifyignore.template .graphifyignore
graphify update . # 첫 빌드 (AST-only, API key 무관)
graphify claude install # always-on (Claude Code) — 다른 도구는 INSTALL.md §3.2
graphify hook install # (선택) 매 commit 후 자동 incremental| 옵션 | 명령 | 비용 | 언제 |
|---|---|---|---|
| A — AST-only | graphify update . |
무 | 코드 위주 (default 권장) |
| B — Claude Code 풀 | /graphify . |
세션 토큰 | docs/papers 풍부 |
| C — 헤드리스 풀 (CI) | graphify extract . |
API key 필요 (ANTHROPIC_API_KEY 또는 MOONSHOT_API_KEY) |
CI/배치 |
빌드 후 권장 git 정책 — graphify-out/{cache,manifest.json,cost.json} ignore, graph.json·graph.html·GRAPH_REPORT.md commit. 상세 → INSTALL.md §2.4. 그 외 절차·사용법 → USAGE.md.
| 도구 | 최소 버전 | 비고 |
|---|---|---|
| Python | 3.10+ | graphify가 networkx·tree-sitter 사용 |
| pip | 21+ | graphifyy 설치 |
| git | 2.30+ | (선택) post-commit hook 사용 시 |
| AI 코딩 도구 | 최신 | (선택) always-on 통합 — Claude Code / Codex / Cursor / Gemini / OpenCode / Aider / Copilot / VS Code / Antigravity / Hermes / Kiro / Pi / Trae / Claw / Droid 지원 |
| LLM API key | (선택) | graphify extract 또는 kimi 백엔드 사용 시. /graphify . Claude Code 슬래시는 불필요 |
| 문제 | 도구 없이 | graphify 적용 후 |
|---|---|---|
| 새 코드베이스 이해 | 파일별 grep·읽기 반복 | god nodes 5개로 코어 추상 1분 파악 |
| 코드 질문 답변 비용 | 매번 grep → 풀 컨텍스트 로드 | graph 먼저 참조 → 토큰 5~70× 절감 (코퍼스 크기 의존) |
| 기술 부채 발견 | 직관·경험에 의존 | cohesion < 0.1 커뮤니티 = 분리 가능 모듈 자동 식별 |
| 변경 영향 추적 | 수동 추적 | graphify path "X" "Y" BFS 경로 |
→ 쉽게 말해: 코드를 grep하기 전에 graph를 먼저 본다. 검색이 연결 추적으로 바뀜.
라이선스: MIT License — Copyright (c) 2026 lyunix. Graphify 본체와 동일 라이선스로 일관성·호환성 유지.
Upstream attribution (Graphify 본체):
- GitHub: github.com/safishamsi/graphify (MIT, Copyright 2026 Safi Shamsi)
- 한국어 랜딩: graphify.net/kr
- 본 패키지의
templates/claude-md-section.template.md·templates/claude-settings-hook.json은graphify claude install명령이 산출하는 내용을 오프라인 참조용으로 수록 (Graphify MIT 라이선스 하).
본 패키지 (graphify_pkg): graphify 사용을 위한 부트스트랩 키트. graphify 소스 코드는 재배포하지 않음 — 문서·템플릿·스킬만 제공.
본 패키지의 가이드는 실제 운영 환경 풀 빌드 (305 nodes / 27 communities / 4.2× 절감) 기반으로 작성. 모든 명령은 graphifyy v0.7.5+ (v0.7.6 포함)에서 검증.