# 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)로 이동하여 바이브 코딩 보조 도구로 체계화
- 상세 사용법 및 명령어 안내 보강