48 lines
2.7 KiB
Markdown
48 lines
2.7 KiB
Markdown
|
# 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
|