install-sh/VIBE-WORK/261012/INSTALL-GRAPHIFY-IMP-PLAN.md

Graphify 설치 스크립트 구현 계획 (INSTALL-GRAPHIFY-IMP-PLAN)

1. 개요

지식 그래프 기반의 코드베이스 분석 도구인 graphify를 설치하고, 다양한 바이브 코딩 에이전트(Antigravity, Claude, Codex, OpenCode) 및 Gemini MCP 연동을 자동으로 구성하는 크로스 플랫폼 설치 스크립트(install-graphify.sh, install-graphify.ps1)를 구현하고 문서를 개편합니다.

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: 실행 계획 수립 및 환경 분석

• 작업 계획서(VIBE-WORK/261012/INSTALL-GRAPHIFY-IMP-PLAN.md) 작성

단계 2: Unix / macOS용 install-graphify.sh 구현

• uv 설치 여부 확인 로직 구현 (미설치 시 친절한 안내 메시지 출력 후 종료)
• uv tool install --upgrade 'graphifyy[pdf,openai,anthropic,gemini]' 실행
• 바이브 코딩 에이전트 연동 명령어 실행:
  • graphify antigravity install
  • graphify claude install
  • graphify codex install
  • graphify opencode install
• ~/.gemini/antigravity/mcp_config.json 생성 및 갱신 로직 구현 (python uv run 활용)
• 실행 권한 부여 (chmod +x install-graphify.sh) 및 문법 검증

단계 3: Windows PowerShell용 install-graphify.ps1 구현

• uv 존재 여부 확인 (Get-Command uv) 및 미설치 시 에러 출력 후 종료
• uv tool install --upgrade 'graphifyy[pdf,openai,anthropic,gemini]' 실행
• 바이브 코딩 에이전트 연동 실행 (오류 발생 시에도 유연하게 처리)
• $env:USERPROFILE\.gemini\antigravity\mcp_config.json 생성 및 갱신 로직 구현
• PowerShell 문법 검증

단계 4: README.md 문서 개편

• 최상단 목차에 5. 바이브 코딩 도우미 (Vibe Coding Assistants) 추가
• 5장에 graphify (5.1) 추가
• 기존 4장에 있던 Open Code Review를 5장 하위(5.2)로 이동 및 번호 재정렬
• Bash / PowerShell 원클릭 설치 스크립트 안내에 install-graphify 추가 및 문서 정리

단계 5: 완료 보고서 작성 및 Graphify 갱신 / Git 커밋

• 완료 보고서(VIBE-WORK/261012/INSTALL-GRAPHIFY-PHASE01.md) 작성
• uv tool run --from graphifyy graphify . --update 실행
• Git commit 및 push