# Phase 3.1 사전 리서치 — 교차검증 파이프라인 CONDITIONAL 해소

## 배경
3문서 체크리스트(task-1837) Phase 3.1에 정의된 사전 리서치 항목들.
Phase 1 ✅, Phase 2/4 ✅ 완료. 핵미사일 승인 완료. Phase 3 진입.

## 리서치 항목 (체크리스트 3.1 기준)

### R1: Codex API 키 상태 확인
- `codex whoami` 또는 `codex --version` 실행
- `~/.codex/auth.json` 확인 (만료 여부)
- 현재 모델 확인: gpt-5.2-codex vs gpt-5.4-mini
- codex-plugin-cc가 설치됨 (task-1848) — 실제 `/codex:review` 동작 가능 여부 확인
- **결과물**: Codex 연동 가능 여부 + 필요한 조치 목록

### R2: Gemini Code Assist 운영 테스트
- GitHub App 이미 설치됨 (All repositories)
- 테스트 PR 생성하여 Gemini 자동 리뷰 동작 확인
  - 간단한 코드 변경 → PR 생성 → Gemini 코멘트 확인
- 리뷰 판정 기준(계획서 2.5절) 운영 가능성 확인
- **결과물**: Gemini 리뷰 실동작 확인 + 응답 시간 + 품질 평가

### R3: worktree finish → PR 생성 자동화 설계
- 현재: worktree finish → 직접 머지 (PR 없음)
- 필요: worktree finish → PR 생성 → Gemini 리뷰 대기 → 머지
- `auto_merge.py` 또는 `worktree-finish.sh` 수정 필요 범위 파악
- `gh pr create` CLI 사용 가능 여부 확인
- **결과물**: 전환 설계 문서 (현재→목표 플로우 + 수정 파일 목록)

### R4: sanitize 스킬 현황 확인
- `.claude/skills/sanitize.md` 존재 여부 + 내용 확인
- 외부 AI 전송 전 PII 마스킹 자동화 현실성 평가
- 마스킹 대상: 고객 데이터, 수수료 로직, API 키
- **결과물**: sanitize 통합 난이도 평가 + 구현 방안

### R5: 비용 산정
- Gemini Code Assist: 무료 tier 한도 확인 (월간 리뷰 수)
- Codex CLI: ChatGPT Plus $20/월 한도 내 사용량 추정
- 8팀 병렬 시 일일 예상 리뷰/검증 횟수
- **결과물**: 월간 예상 비용 + ROI 추정

### R6: codex-plugin-cc 실동작 확인
- `/codex:setup` 결과 확인 (대화형 세션에서만 가능하면 보고)
- `codex --version`: 0.106.0 설치됨
- auth.json 만료 여부
- **결과물**: 플러그인 즉시 사용 가능 여부

## 보고 형식
각 항목별 PASS/FAIL/CONDITIONAL + 상세 내용을 보고서에 정리.
Phase 3.2~3.5 구현 우선순위 제안 포함.

## 검증 시나리오 (이게 되면 성공)
1. R1~R6 모든 항목에 대해 현재 상태 + 필요 조치가 명확히 정리됨
2. Phase 3.2~3.5 중 즉시 구현 가능한 것과 추가 작업 필요한 것이 구분됨
3. 비용 산정이 대략적이라도 포함됨

## 주의사항
- 리서치만 수행, 구현하지 말 것
- 테스트 PR 생성 시 test 브랜치에서 진행 (main 직접 수정 금지)
- API 키/토큰을 보고서에 노출하지 말 것