# Phase 3: 팀장 봇 Gemini PR 리뷰 대응 워크플로우 구현

## 배경
Gemini Code Assist GitHub App 설치 완료 (2026-04-15).
PR 생성 시 5분 내 자동 코드 리뷰 제공.
현재는 수동으로 PR 생성 + 리뷰 확인. 팀장 봇이 자동으로 PR 생성 → Gemini 리뷰 대응 → merge 하는 워크플로우 필요.

## 3문서 참조
- 계획서 2.5절: Gemini PR 리뷰 판정 프로세스
- 계획서 6.1: 팀장 봇 Gemini 대응 워크플로우
- 체크리스트 Phase 3.1

## 구현 항목

### 1. DIRECT-WORKFLOW.md 업데이트
파일: `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md`

기존 Step 4 (worktree finish/merge) 뒤에 새 단계 추가:

**Step 4.5: Gemini PR 리뷰 대응 (Lv.2+ 작업에만 적용)**

```
1. worktree에서 작업 완료 후, main에 직접 merge하지 않고 PR 생성:
   gh pr create --title "[{task_id}] {작업 요약}" --body "{보고서 요약}" --base main --head {branch}

2. Gemini 리뷰 대기 (최대 5분):
   while true; do
     REVIEWS=$(gh api repos/{owner}/{repo}/pulls/{pr_number}/reviews)
     if echo "$REVIEWS" | grep -q "gemini-code-assist"; then break; fi
     sleep 30
   done

3. Gemini 코멘트 읽기:
   gh api repos/{owner}/{repo}/pulls/{pr_number}/comments

4. 각 코멘트 판정:
   - High severity → 코드 수정 후 재push (수용)
   - High severity but 의도적 설계 → PR에 기각 사유 코멘트
   - Medium/Low → 참고만 (PASS에 영향 없음)

5. 미수정 High 0건 확인 → merge:
   gh pr merge {pr_number} --merge --delete-branch

6. merge 실패 시 → 충돌 해결 후 재시도
```

### 2. worktree_manager.py cmd_finish 수정
파일: `/home/jay/workspace/scripts/worktree_manager.py`

기존 `cmd_finish`에서 `git merge` 대신 `gh pr create` 호출하도록 변경.
단, gate_instructions의 G3 레벨에 따라:
- Lv.0-1: 기존대로 직접 merge (Gemini 리뷰 불필요)
- Lv.2+: PR 생성 → Gemini 대기 → 대응 → merge

레벨 판정: task 파일에서 level 읽기 또는 기본값 Lv.2 적용.

### 3. Gemini 리뷰 판정 기준 (계획서 2.5절)
팀장 봇 프롬프트에 판정 기준 포함:
- PASS: 미수정 High 0건
- 수용(Accept): 실제 버그/보안 → 코드 수정
- 기각(Dismiss): 의도적 설계 → `gh api`로 PR에 기각 코멘트
- 보류(Defer): 판단 불가 → 보고서에 기록, 아누 판단 요청

## 주의사항
- **gh CLI 인증**: 봇 세션에서 gh auth 확인됨 (JonghyukJeon, ghp_*** 토큰)
- **Gemini 대기 타임아웃**: 5분 초과 시 리뷰 없이 merge 진행 (Gemini 장애 대비)
- **기존 직접 merge 경로 유지**: Lv.0-1은 변경 없음
- **PR 생성 시 branch 이름**: task/{task_id}-{team} 형식 (기존 worktree 브랜치명 활용)
- **dashboard 프로젝트**: .git이 없을 수 있음 → workspace 리포(dev_workspace) 기준으로 PR 생성

## affected_files
prompts/DIRECT-WORKFLOW.md, scripts/worktree_manager.py

## 검증 시나리오
1. Lv.2 task 위임 → 팀장 봇이 PR 생성 → Gemini 리뷰 자동 수신
2. Gemini High 코멘트 → 팀장 봇이 코드 수정 + 재push
3. Gemini 리뷰 없음 (5분 타임아웃) → 자동 merge 진행
4. Lv.0-1 task → 기존대로 직접 merge (PR 미생성)
5. 기각 시 PR에 코멘트 정상 기록