graphify 설치 스크립트 추가 및 README 바이브 코딩 도우미 섹션 개편

2026-10-12 09:00:56 +09:00
1 parent 4e82bde404
commit 1de104e30c
@@ -0,0 +1,48 @@
+# Graphify 설치 스크립트 구현 계획 (INSTALL-GRAPHIFY-IMP-PLAN)
+
+## 1. 개요
+지식 그래프 기반의 코드베이스 분석 도구인 `graphify`를 설치하고, 다양한 바이브 코딩 에이전트(Antigravity, Claude, Codex, OpenCode) 및 Gemini MCP 연동을 자동으로 구성하는 크로스 플랫폼 설치 스크립트(`install-graphify.sh`, `install-graphify.ps1`)를 구현하고 문서를 개편합니다.
+
+```mermaid
+flowchart TD
+    Start([시작]) --> CheckUV{uv 설치 여부 확인}
+    CheckUV -- 미설치 --> ErrorExit[uv 필요 안내 및 종료]
+    CheckUV -- 설치됨 --> InstallGraphify[uv tool install 'graphifyy[pdf,openai,anthropic,gemini]']
+    InstallGraphify --> AgentConfig[각 에이전트 연동 설정<br/>antigravity/claude/codex/opencode]
+    AgentConfig --> GeminiMCP[Gemini MCP 설정 반영<br/>~/.gemini/antigravity/mcp_config.json]
+    GeminiMCP --> Done([완료])
+```
+
+## 2. 작업 단계 및 체크리스트
+
+### 단계 1: 실행 계획 수립 및 환경 분석
+- [x] 작업 계획서(`VIBE-WORK/261012/INSTALL-GRAPHIFY-IMP-PLAN.md`) 작성
+
+### 단계 2: Unix / macOS용 `install-graphify.sh` 구현
+- [x] `uv` 설치 여부 확인 로직 구현 (미설치 시 친절한 안내 메시지 출력 후 종료)
+- [x] `uv tool install --upgrade 'graphifyy[pdf,openai,anthropic,gemini]'` 실행
+- [x] 바이브 코딩 에이전트 연동 명령어 실행:
+  - `graphify antigravity install`
+  - `graphify claude install`
+  - `graphify codex install`
+  - `graphify opencode install`
+- [x] `~/.gemini/antigravity/mcp_config.json` 생성 및 갱신 로직 구현 (python `uv run` 활용)
+- [x] 실행 권한 부여 (`chmod +x install-graphify.sh`) 및 문법 검증
+
+### 단계 3: Windows PowerShell용 `install-graphify.ps1` 구현
+- [x] `uv` 존재 여부 확인 (`Get-Command uv`) 및 미설치 시 에러 출력 후 종료
+- [x] `uv tool install --upgrade 'graphifyy[pdf,openai,anthropic,gemini]'` 실행
+- [x] 바이브 코딩 에이전트 연동 실행 (오류 발생 시에도 유연하게 처리)
+- [x] `$env:USERPROFILE\.gemini\antigravity\mcp_config.json` 생성 및 갱신 로직 구현
+- [x] PowerShell 문법 검증
+
+### 단계 4: `README.md` 문서 개편
+- [x] 최상단 목차에 `5. 바이브 코딩 도우미 (Vibe Coding Assistants)` 추가
+- [x] 5장에 `graphify` (5.1) 추가
+- [x] 기존 4장에 있던 `Open Code Review`를 5장 하위(5.2)로 이동 및 번호 재정렬
+- [x] Bash / PowerShell 원클릭 설치 스크립트 안내에 `install-graphify` 추가 및 문서 정리
+
+### 단계 5: 완료 보고서 작성 및 Graphify 갱신 / Git 커밋
+- [x] 완료 보고서(`VIBE-WORK/261012/INSTALL-GRAPHIFY-PHASE01.md`) 작성
+- [x] `uv tool run --from graphifyy graphify . --update` 실행
+- [x] Git commit 및 push
@@ -0,0 +1,50 @@
+# Graphify 설치 스크립트 구현 완료 보고서 (INSTALL-GRAPHIFY-PHASE01)
+
+## 1. 개요
+지식 그래프 기반의 코드베이스 분석 및 컨텍스트 이해 도구인 `graphify`의 크로스 플랫폼 원클릭 설치 스크립트(`install-graphify.sh`, `install-graphify.ps1`)를 구현하고, `README.md` 문서를 개편하여 "5. 바이브 코딩 도우미" 섹션을 신설하였습니다.
+
+```mermaid
+flowchart LR
+    subgraph Prerequisites[사전 요구사항]
+        UV["uv 확인 (없으면 안내 후 종료)"]
+    end
+
+    subgraph Install[설치]
+        UV --> Graphify["uv tool install 'graphifyy[pdf,openai,anthropic,gemini]'"]
+    end
+
+    subgraph Integrations[에이전트 및 MCP 연동]
+        Graphify --> Agents["graphify {antigravity,claude,codex,opencode} install"]
+        Graphify --> GeminiMCP["~/.gemini/antigravity/mcp_config.json 구성"]
+    end
+
+    subgraph Assistants[바이브 코딩 도우미]
+        Agents --> Section5["README.md 5장: graphify (5.1) & ocr (5.2)"]
+        GeminiMCP --> Section5
+    end
+```
+
+## 2. 세부 구현 내역
+
+### 2.1. Unix/macOS용 설치 스크립트 (`install-graphify.sh`)
+- `uv` 설치 여부 점검 (`command -v uv`), 미설치 시 친절한 설치 안내 메시지 및 에러 종료 처리
+- `uv tool install --upgrade 'graphifyy[pdf,openai,anthropic,gemini]'` 실행으로 추가 옵션 포함 설치
+- 4대 주요 바이브 코딩 에이전트 연동:
+  - `graphify antigravity install`
+  - `graphify claude install`
+  - `graphify codex install`
+  - `graphify opencode install`
+- `~/.gemini/antigravity/mcp_config.json` 자동 구성:
+  - `mcpServers.graphify` 또는 루트 레벨 `"graphify"` 엔트리로 안전하게 병합 및 저장
+
+### 2.2. Windows PowerShell용 설치 스크립트 (`install-graphify.ps1`)
+- `Get-Command uv`를 통해 `uv` 설치 여부 확인 및 안내
+- `uv tool install --upgrade 'graphifyy[pdf,openai,anthropic,gemini]'` 실행
+- 각 에이전트 연동 명령 실행 및 에러 허용 처리
+- `$env:USERPROFILE\.gemini\antigravity\mcp_config.json`을 읽고 파싱하여 JSON 형태로 안전하게 생성/갱신
+
+### 2.3. 문서 개편 (`README.md`)
+- 최상단 카테고리에 `5. 바이브 코딩 도우미 (Vibe Coding Assistants)` 신설
+- 5.1로 `graphify` 등록 및 원클릭 설치 명령어(Bash, PowerShell, CMD) 추가
+- 4장에 있던 `Open Code Review (ocr)`를 5장 하위(5.2)로 이동하여 바이브 코딩 보조 도구로 체계화
+- 상세 사용법 및 명령어 안내 보강