@yeongjaeyou/claude-code-config 0.4.0 → 0.5.0

package/.claude/commands/tm/review-prd-with-codex.md

@@ -1,101 +1,101 @@
-# PRD Codex 검토 (review-prd-with-codex)
+# PRD Review with Codex (review-prd-with-codex)
 
-생성된 PRD를 Codex MCP로 검토하고 Claude가 cross-check하여 합의된 결론을 전달합니다.
-합의가 도달할 때까지 최대 3회 핑퐁합니다.
+Review the generated PRD using Codex MCP, with Claude performing cross-check validation to deliver a consensus conclusion.
+Ping-pong up to 3 times until consensus is reached.
 
-**핵심 원칙:**
-- Codex는 context/도구가 제한적이므로 Claude가 반드시 검증
-- 불일치 시 Codex에 재질문 (컨텍스트 재전달 방식)
-- 이모지 사용 금지
-- 범용적 표현 사용 (특정 프로젝트 용어 지양)
+**Core Principles:**
+- Codex has limited context/tools, so Claude must verify
+- On disagreement, re-query Codex (with context re-transmission)
+- No emoji usage
+- Use generic expressions (avoid project-specific terminology)
 
 ---
 
-## 아규먼트
+## Arguments
 
-`$ARGUMENTS`로 PRD 파일 경로를 받습니다.
-- 예: `/tm:review-prd-with-codex .taskmaster/docs/prd.md`
-- 없으면 AskUserQuestion으로 경로 입력 요청
+`$ARGUMENTS` receives the PRD file path.
+- Example: `/tm:review-prd-with-codex .taskmaster/docs/prd.md`
+- If missing, request path input via AskUserQuestion
 
 ---
 
-## Codex 컨텍스트 구성 원칙
-
-### 1. 이번 워크플로우의 Codex 사용 범위
-- 이번 명령은 **Codex MCP 도구**를 사용 (`mcp__codex__codex`)
-- sandbox는 `read-only` 설정
-- **네트워크/웹서치는 사용하지 않음** (재현성과 안전을 위해)
-- 재현성을 위해 PRD/컨텍스트를 프롬프트에 직접 포함 (파일 탐색에 의존하지 않음)
-- git history 접근 불가 (Claude가 cross-check로 보완)
-
-### 2. 필수 포함 정보 (풍부한 컨텍스트)
-- PRD 전문 (라인 번호 포함 - `nl -ba` 형식)
-- **CLAUDE.md 전문** (제한 없이 전체 포함)
-- **프로젝트 기술 스택 상세** (package.json, requirements.txt 내용)
-- **디렉토리 구조** (주요 폴더 구조)
-- **PRD 관련 코드 요약** (선택: PRD에 언급된 파일의 심볼 개요)
-- 검토 기준 명시
-- 출력 형식 강제
-
-### 3. 포함하지 말아야 할 정보
-- Claude 전용 도구 언급 (AskUserQuestion, TodoWrite 등)
-- 내부 워크플로우 세부사항
-
-### 4. 프롬프트 구성 원칙
-- **CLAUDE.md 전체 포함** (1000자 제한 제거)
-- PRD 전체를 한 번에 검토 (분할하지 않음)
-- 기술 스택과 디렉토리 구조로 프로젝트 맥락 제공
-- 타임아웃 발생 시에만 프롬프트 축소 고려
-
-### 5. 출력 형식 강제
-- 구조화된 형식 명시 (테이블, 리스트)
-- "반드시 이 형식으로" 명시
-- 라인 번호 참조 요구
+## Codex Context Configuration Principles
+
+### 1. Codex Usage Scope for This Workflow
+- This command uses **Codex MCP tool** (`mcp__codex__codex`)
+- Set sandbox to `read-only`
+- **No network/web search** (for reproducibility and safety)
+- Include PRD/context directly in prompt for reproducibility (don't rely on file exploration)
+- Git history not accessible (Claude cross-check compensates)
+
+### 2. Required Information (Rich Context)
+- Full PRD text (with line numbers - `nl -ba` format)
+- **Full CLAUDE.md** (include entire content without limits)
+- **Detailed project tech stack** (package.json, requirements.txt contents)
+- **Directory structure** (main folder layout)
+- **PRD-related code summary** (optional: symbol overview of files mentioned in PRD)
+- Explicit review criteria
+- Enforced output format
+
+### 3. Information to Exclude
+- Claude-specific tools (AskUserQuestion, TodoWrite, etc.)
+- Internal workflow details
+
+### 4. Prompt Construction Principles
+- **Include full CLAUDE.md** (remove 1000 character limit)
+- Review entire PRD at once (don't split)
+- Provide project context with tech stack and directory structure
+- Consider prompt reduction only on timeout
+
+### 5. Enforced Output Format
+- Specify structured format (tables, lists)
+- State "Must use this format"
+- Require line number references
 
 ---
 
-## 작업 순서
+## Workflow Steps
 
-### Step 1: 사전 정보 수집 (풍부한 컨텍스트)
+### Step 1: Gather Pre-requisite Information (Rich Context)
 
-#### 1.1 PRD 파일 읽기 (라인 번호 포함)
+#### 1.1 Read PRD File (with line numbers)
 ```bash
 nl -ba $ARGUMENTS
 ```
-- `nl -ba`: 빈 줄 포함 모든 줄에 번호 부여 (cat -n보다 일관적)
-- 파일이 없으면 오류 메시지 출력 후 종료
+- `nl -ba`: Numbers all lines including blank lines (more consistent than cat -n)
+- Output error message and exit if file doesn't exist
 
-#### 1.2 PRD 파일 존재 확인
+#### 1.2 Verify PRD File Exists
 ```bash
-test -f $ARGUMENTS && echo "파일 존재" || echo "파일 없음"
+test -f $ARGUMENTS && echo "File exists" || echo "File not found"
 ```
 
-#### 1.3 CLAUDE.md 전문 읽기
-- 프로젝트 루트의 CLAUDE.md 확인
-- **전체 내용을 프롬프트에 포함** (1000자 제한 없음)
-- 프로젝트 컨벤션, 기술 스택, 주의사항 모두 전달
+#### 1.3 Read Full CLAUDE.md
+- Check CLAUDE.md in project root
+- **Include entire content in prompt** (no 1000 character limit)
+- Convey all project conventions, tech stack, and caveats
 
-#### 1.4 프로젝트 기술 스택 상세 수집
-Claude가 다음 파일들을 읽고 요약:
-- `package.json` (프론트엔드 의존성)
-- `requirements.txt` (백엔드 의존성)
-- `go.mod`, `Cargo.toml` 등 (해당 시)
-- 주요 프레임워크/라이브러리 버전 명시
+#### 1.4 Collect Detailed Project Tech Stack
+Claude reads and summarizes these files:
+- `package.json` (frontend dependencies)
+- `requirements.txt` (backend dependencies)
+- `go.mod`, `Cargo.toml`, etc. (if applicable)
+- Specify major framework/library versions
 
-#### 1.5 디렉토리 구조 수집
+#### 1.5 Collect Directory Structure
 ```bash
-# 주요 디렉토리 구조 (깊이 2-3)
+# Main directory structure (depth 2-3)
 tree -L 3 --dirsfirst -I 'node_modules|__pycache__|.git|dist|build|.next'
 ```
-또는 `ls -la` 조합으로 구조 파악
+Or use `ls -la` combinations to understand structure
 
-#### 1.6 PRD 관련 코드 파일 요약 (선택)
-- PRD에 언급된 주요 파일/모듈이 있으면 해당 파일의 심볼 개요 수집
-- 예: "인증 시스템 개선" PRD라면 `routes/auth.py`, `middleware.ts` 등 확인
-- 기존 구현과 PRD 설계의 관계 파악에 도움
+#### 1.6 Summarize PRD-Related Code Files (Optional)
+- If major files/modules are mentioned in PRD, collect symbol overview
+- Example: For "Authentication System Improvement" PRD, check `routes/auth.py`, `middleware.ts`, etc.
+- Helps understand relationship between existing implementation and PRD design
 
-#### 1.7 TaskMaster PRD 템플릿 참조
-`.taskmaster/templates/example_prd.txt` 구조:
+#### 1.7 Reference TaskMaster PRD Template
+`.taskmaster/templates/example_prd.txt` structure:
 ```
 <context>
 # Overview
@@ -111,29 +111,29 @@ tree -L 3 --dirsfirst -I 'node_modules|__pycache__|.git|dist|build|.next'
 </PRD>
 ```
 
-### Step 2: Codex 프롬프트 구성 (풍부한 컨텍스트)
+### Step 2: Construct Codex Prompt (Rich Context)
 
-다음 템플릿을 사용하여 프롬프트 작성:
+Use this template to write the prompt:
 
 ```
-## 역할
-당신은 PRD(Product Requirements Document) 검토 전문가입니다.
+## Role
+You are a PRD (Product Requirements Document) review expert.
 
-## 프로젝트 컨텍스트
+## Project Context
 
-### 기술 스택
-[package.json / requirements.txt 내용 요약]
-예시:
+### Tech Stack
+[Summary of package.json / requirements.txt contents]
+Example:
 - Frontend: Next.js 15, React 19, Tailwind CSS v4, shadcn/ui
 - Backend: FastAPI, Google Gemini API, Decord
-- 배포: Docker + Cloudflare Tunnel
+- Deployment: Docker + Cloudflare Tunnel
 
-### 프로젝트 구조
-[tree 또는 ls 출력 결과]
+### Project Structure
+[tree or ls output]
 ```
 frontend/
 ├── src/app/          # App Router
-├── src/components/   # UI 컴포넌트
+├── src/components/   # UI components
 └── src/hooks/        # Custom hooks
 
 services/
@@ -142,308 +142,301 @@ services/
 └── child_safety_processor.py
 ```
 
-### 프로젝트 지침 (CLAUDE.md)
-[CLAUDE.md 전문 - 제한 없이 전체 포함]
+### Project Guidelines (CLAUDE.md)
+[Full CLAUDE.md - include entire content without limits]
 
-### PRD 관련 기존 코드 (선택)
-[PRD에 언급된 주요 파일이 있다면 심볼 개요]
+### Existing Code Related to PRD (Optional)
+[Symbol overview of major files mentioned in PRD]
 
-## 검토 대상
-파일: [PRD 파일 경로]
+## Review Target
+File: [PRD file path]
 
-### PRD 내용 (라인 번호 포함)
-[PRD 전문 - nl -ba 형식으로]
+### PRD Content (with line numbers)
+[Full PRD - in nl -ba format]
 
-## TaskMaster PRD 형식 기준
+## TaskMaster PRD Format Criteria
 <context>: Overview, Core Features, User Experience
-<PRD>: Technical Architecture, Development Roadmap (Phase 단위),
+<PRD>: Technical Architecture, Development Roadmap (by Phase),
        Logical Dependency Chain, Risks and Mitigations, Appendix
 
-## 검토 기준
-1. 구조: TaskMaster PRD 형식 준수 여부
-2. 명확성: 모호한 표현, 정의되지 않은 용어, 측정 불가능한 목표
-3. 실행가능성: 구현 가능한 수준의 구체성, 기술적 현실성
-4. 완전성: 누락된 섹션 (User Stories, Acceptance Criteria,
-   Success Metrics, Risk/Dependencies 등)
-5. 일관성: 내부 모순, 중복 정의, 버전 불일치
+## Review Criteria
+1. Structure: Compliance with TaskMaster PRD format
+2. Clarity: Ambiguous expressions, undefined terms, unmeasurable goals
+3. Feasibility: Implementation-level specificity, technical realism
+4. Completeness: Missing sections (User Stories, Acceptance Criteria,
+   Success Metrics, Risk/Dependencies, etc.)
+5. Consistency: Internal contradictions, duplicate definitions, version mismatches
 
-## 출력 형식 (반드시 이 형식으로)
+## Output Format (Must use this format)
 
-### 타당한 점 (Strengths)
-- [항목]: [설명] (라인 번호)
+### Strengths
+- [Item]: [Description] (line number)
 
-### 개선 필요 사항 (Issues)
-| 항목 | 위치(라인) | 문제점 | 권장 수정 |
-|------|-----------|--------|----------|
+### Issues
+| Item | Location (line) | Problem | Recommended Fix |
+|------|-----------------|---------|-----------------|
 
-### 개방 질문 (Open Questions)
-- [질문 1]
-- [질문 2]
+### Open Questions
+- [Question 1]
+- [Question 2]
 
-### 종합 평가
-[1-2문장 요약]
+### Overall Assessment
+[1-2 sentence summary]
 ```
 
-### Step 3: Codex MCP 첫 실행
+### Step 3: Execute Codex MCP (First Run)
 
-**mcp__codex__codex 도구 호출:**
+**Call mcp__codex__codex tool:**
 
-파라미터:
-- `prompt`: Step 2에서 구성한 전체 프롬프트
+Parameters:
+- `prompt`: Full prompt constructed in Step 2
 - `sandbox`: "read-only"
-- `cwd`: 프로젝트 루트 경로 (선택)
+- `cwd`: Project root path (optional)
 
-**호출 예시:**
+**Call example:**
 ```
-mcp__codex__codex 도구 호출:
-- prompt: [구성한 프롬프트]
+mcp__codex__codex tool call:
+- prompt: [constructed prompt]
 - sandbox: "read-only"
 ```
 
-**참고:**
-- MCP 도구 응답에서 텍스트 결과를 파싱
-- 타임아웃 발생 시 프롬프트 길이 줄이기
+**Notes:**
+- Parse text results from MCP tool response
+- Reduce prompt length on timeout
 
-### Step 4: Codex 피드백 수신 및 파싱
+### Step 4: Receive and Parse Codex Feedback
 
-Codex 응답을 다음 구조로 정리:
-- Strengths: 타당한 점 목록
-- Issues: 개선 필요 사항 테이블
-- Open Questions: 개방 질문 목록
-- Summary: 종합 평가
+Organize Codex response into this structure:
+- Strengths: List of valid points
+- Issues: Table of items needing improvement
+- Open Questions: List of open questions
+- Summary: Overall assessment
 
 ### Step 5: Claude Cross-check
 
-**Codex가 놓칠 수 있는 항목 검증:**
+**Verify items Codex may have missed:**
 
-1. **이미 해결된 이슈 확인**
+1. **Check for already-resolved issues**
    ```bash
    git log --oneline -20
    ```
-   - PRD에 언급된 이슈가 이미 커밋으로 해결되었는지 확인
+   - Verify if issues mentioned in PRD were already resolved via commits
 
-2. **패키지/의존성 존재 여부 검증**
-   - npm: `npm view [패키지명]`
-   - pip: `pip show [패키지명]` 또는 PyPI 검색
-   - 실제로 존재하지 않는 패키지 언급 여부
+2. **Validate package/dependency existence**
+   - npm: `npm view [package-name]`
+   - pip: `pip show [package-name]` or PyPI search
+   - Check for mentions of non-existent packages
 
-3. **코드베이스-PRD 동기화 확인**
-   - PRD에 언급된 파일/모듈이 실제 존재하는지
-   - 기존 구현과 PRD 설계 일치 여부
+3. **Verify codebase-PRD synchronization**
+   - Confirm files/modules mentioned in PRD actually exist
+   - Check alignment between existing implementation and PRD design
 
-4. **CLAUDE.md 지침 준수 확인**
-   - 프로젝트 컨벤션 준수 여부
-   - TaskMaster 워크플로우 적합성
+4. **Verify CLAUDE.md guideline compliance**
+   - Project convention adherence
+   - TaskMaster workflow compatibility
 
-5. **Codex 틀린 부분 식별**
-   - 검증 결과 틀린 내용 목록화
-   - 근거 준비 (git commit, 실제 파일 등)
+5. **Identify Codex errors**
+   - List incorrect items from validation
+   - Prepare evidence (git commit, actual files, etc.)
 
-### Step 6: 불일치 확인 및 재검토 (컨텍스트 재전달 방식)
+### Step 6: Disagreement Check and Re-review (Context Re-transmission)
 
-**불일치 항목이 있으면:**
+**If there are disagreements:**
 
-`mcp__codex__codex` 새 세션으로 호출하되, **이전 대화 맥락을 프롬프트에 포함**:
+Call `mcp__codex__codex` as new session, **including previous conversation context in prompt**:
 
-#### 재검토 프롬프트 템플릿:
+#### Re-review Prompt Template:
 ```
-## 역할
-당신은 PRD 검토 전문가입니다.
+## Role
+You are a PRD review expert.
 
-## 이전 검토 맥락
+## Previous Review Context
 
-### 1차 검토 결과 요약
-[Codex 1차 응답 핵심 내용 - Strengths, Issues, Questions, Summary]
+### First Review Summary
+[Key content from Codex first response - Strengths, Issues, Questions, Summary]
 
-### Claude Cross-check 결과
-[불일치 항목 및 근거]
+### Claude Cross-check Results
+[Disagreement items and evidence]
 
-## 재검토 요청
-위 Cross-check 결과를 반영하여 다음 항목만 재검토해주세요:
-1. [불일치 항목 1]
-2. [불일치 항목 2]
+## Re-review Request
+Please re-review only the following items reflecting the cross-check results:
+1. [Disagreement item 1]
+2. [Disagreement item 2]
 
-기존 평가 중 변경이 필요한 부분만 수정된 형식으로 답변해주세요.
+Respond only with modified sections from the original assessment.
 
-## 참고 정보
-[필요시 추가 컨텍스트 - 관련 코드, git log 등]
+## Reference Information
+[Additional context if needed - related code, git log, etc.]
 ```
 
-**MCP 호출:**
+**MCP Call:**
 ```
-mcp__codex__codex 도구 호출:
-- prompt: [재검토 프롬프트]
+mcp__codex__codex tool call:
+- prompt: [re-review prompt]
 - sandbox: "read-only"
 ```
 
-**핑퐁 종료 조건:**
-- 합의 도달 (불일치 항목 없음)
-- 최대 3회 도달
-- Codex가 Claude의 근거를 수용
+**Ping-pong termination conditions:**
+- Consensus reached (no disagreement items)
+- Maximum 3 iterations reached
+- Codex accepts Claude's evidence
 
-**반복 횟수 추적:**
-- 1회차: 초기 검토
-- 2회차: 1차 재검토 (이전 맥락 포함)
-- 3회차: 2차 재검토 (마지막)
+**Iteration tracking:**
+- Round 1: Initial review
+- Round 2: First re-review (includes previous context)
+- Round 3: Second re-review (final)
 
-### Step 7: 합의 도출 및 전달
+### Step 7: Reach Consensus and Deliver Results
 
-**출력 형식:**
+**Output Format:**
 
 ```markdown
-## PRD 검토 결과 (Codex + Claude 합의)
+## PRD Review Results (Codex + Claude Consensus)
 
-### 검토 과정
-- 핑퐁 횟수: [N]회
-- 합의 상태: [완전 합의 / 부분 합의 / Claude 판단]
+### Review Process
+- Ping-pong iterations: [N]
+- Consensus status: [Full consensus / Partial consensus / Claude determination]
 
-### [VALID] 타당한 피드백
-| 항목 | 설명 | 출처 |
-|------|------|------|
+### [VALID] Valid Feedback
+| Item | Description | Source |
+|------|-------------|--------|
 
-### [ISSUE] 개선 필요 사항
-| 항목 | 문제점 | 권장 수정 | 출처 |
-|------|--------|----------|------|
+### [ISSUE] Items Needing Improvement
+| Item | Problem | Recommended Fix | Source |
+|------|---------|-----------------|--------|
 
-### [CORRECTION] Codex 오류 교정
-| Codex 주장 | 실제 상황 | 근거 |
-|-----------|----------|------|
+### [CORRECTION] Codex Error Corrections
+| Codex Claim | Actual Situation | Evidence |
+|-------------|------------------|----------|
 
-### [DECISION] 결정 필요 사항
-(선택지가 있으면 AskUserQuestion으로 질문)
+### [DECISION] Items Requiring Decision
+(If there are options, ask via AskUserQuestion)
 
-### [SUMMARY] 종합 결론
-[최종 요약]
+### [SUMMARY] Final Conclusion
+[Final summary]
 ```
 
 ---
 
-## 작업 지침
-
-- 한글로 답변
-- 코드나 문서 작성 시 이모지 사용 금지
-- **불명확한 사항은 추측하지 말고 AskUserQuestion으로 질문**
-- PRD 수정 제안은 사용자 확인 후 진행
-- Codex와 Claude 의견 불일치 시 근거를 명확히 제시
-- 검토 기준이 애매하면 사용자에게 우선순위 질문
+> See [Work Guidelines](../guidelines/work-guidelines.md)
 
 ---
 
-## 오류 처리
+## Error Handling
 
-- **PRD 파일 없음**: "파일을 찾을 수 없습니다. 경로를 확인해주세요."
-- **Codex MCP 호출 실패**: "Codex MCP 도구 호출에 실패했습니다. MCP 서버 상태를 확인해주세요."
-- **타임아웃**: "Codex 응답 시간 초과. 프롬프트 길이를 줄이거나 다시 시도해주세요."
-- **재검토 필요**: "이전 맥락을 포함하여 새 세션으로 재검토를 진행합니다."
+- **PRD file not found**: "File not found. Please verify the path."
+- **Codex MCP call failed**: "Codex MCP tool call failed. Please check MCP server status."
+- **Timeout**: "Codex response timeout. Please reduce prompt length or try again."
+- **Re-review needed**: "Proceeding with re-review in new session including previous context."
 
 ---
 
-## Codex MCP 도구 참조
+## Codex MCP Tool Reference
 
-### Claude가 사용하는 MCP 도구
-| 도구 | 파라미터 | 설명 |
-|------|----------|------|
-| `mcp__codex__codex` | `prompt`, `sandbox`, `cwd`, `model` 등 | 새 Codex 세션 시작 |
+### MCP Tools Used by Claude
+| Tool | Parameters | Description |
+|------|------------|-------------|
+| `mcp__codex__codex` | `prompt`, `sandbox`, `cwd`, `model`, etc. | Start new Codex session |
 
-**주요 파라미터:**
-- `prompt` (필수): 초기 프롬프트
-- `sandbox`: "read-only" (파일 읽기만 허용, 안전)
-- `cwd`: 작업 디렉토리 (선택)
-- `model`: 모델 지정 (선택, 예: "o3", "o4-mini")
+**Key Parameters:**
+- `prompt` (required): Initial prompt
+- `sandbox`: "read-only" (only file reading allowed, safe)
+- `cwd`: Working directory (optional)
+- `model`: Model specification (optional, e.g., "o3", "o4-mini")
 
-**참고:**
-- 핑퐁 시에는 새 세션에 이전 맥락을 프롬프트에 포함하여 호출
-- CLI의 `codex resume`과 달리 MCP에서는 컨텍스트 재전달 방식 사용
+**Notes:**
+- For ping-pong, call new session with previous context included in prompt
+- Unlike CLI's `codex resume`, MCP uses context re-transmission method
 
 ---
 
-## Cross-check 체크리스트
+## Cross-check Checklist
 
-| 검증 항목 | 방법 | 예시 |
-|----------|------|------|
-| 이미 해결된 이슈 | `git log --grep="이슈번호"` | 특정 이슈가 이미 커밋으로 해결됨 |
-| 패키지 존재 여부 | `npm view` / `pip show` | 존재하지 않는 SDK 언급 |
-| 파일/모듈 존재 | `ls`, `find`, `grep` | 특정 어댑터 파일 위치 확인 |
-| 버전 일치 | `package.json`, `requirements.txt` | 명시된 버전과 실제 버전 |
+| Verification Item | Method | Example |
+|-------------------|--------|---------|
+| Already resolved issues | `git log --grep="issue-number"` | Specific issue already resolved via commit |
+| Package existence | `npm view` / `pip show` | Non-existent SDK mentioned |
+| File/module existence | `ls`, `find`, `grep` | Specific adapter file location |
+| Version match | `package.json`, `requirements.txt` | Specified version vs actual version |
 
 ---
 
-## 사용 예시
+## Usage Examples
 
 ```bash
-# PRD 생성 후 검토
+# Review after PRD generation
 /tm:convert-prd .taskmaster/docs/my-idea.md
-# prd.md 생성됨
+# prd.md generated
 
 /tm:review-prd-with-codex .taskmaster/docs/prd.md
-# Codex MCP 검토 + Claude cross-check + 핑퐁 + 합의 결과 출력
+# Codex MCP review + Claude cross-check + ping-pong + consensus results output
 ```
 
 ---
 
-## 워크플로우 다이어그램
+## Workflow Diagram
 
 ```
-[Step 1: 풍부한 컨텍스트 수집]
+[Step 1: Gather Rich Context]
     |
     v
-[Step 2: 프롬프트 구성]
+[Step 2: Construct Prompt]
     |
     v
-[Step 3: Codex MCP 1차 검토] ─────────────────────────┐
-    |     (mcp__codex__codex)                         |
-    v                                                  |
-[Step 4: 피드백 파싱]                                  |
-    |                                                  |
-    v                                                  |
-[Step 5: Claude Cross-check]                           |
-    |                                                  |
-    v                                                  |
-[Step 6: 불일치 있음?]                                 |
-    |                                                  |
-    ├─ YES & 반복 < 3 ─> [새 MCP 호출 + 컨텍스트 재전달]┘
-    |                     (이전 대화 요약 포함)
+[Step 3: Codex MCP First Review] ──────────────────────────┐
+    |     (mcp__codex__codex)                              |
+    v                                                       |
+[Step 4: Parse Feedback]                                    |
+    |                                                       |
+    v                                                       |
+[Step 5: Claude Cross-check]                                |
+    |                                                       |
+    v                                                       |
+[Step 6: Disagreements?]                                    |
+    |                                                       |
+    ├─ YES & iterations < 3 ─> [New MCP call + context]────┘
+    |                          (includes conversation summary)
     |
-    └─ NO 또는 반복 >= 3 ─> [Step 7: 합의 결과 전달]
+    └─ NO or iterations >= 3 ─> [Step 7: Deliver Consensus]
 ```
 
-**핵심 플로우:**
-1. Codex MCP 검토 실행
-2. Claude가 cross-check로 검증
-3. 불일치 발견 시 새 MCP 호출 (이전 맥락을 프롬프트에 포함)
-4. 합의 도달 또는 최대 3회까지 반복
-5. 최종 결과 전달
+**Core Flow:**
+1. Execute Codex MCP review
+2. Claude validates via cross-check
+3. On disagreement, new MCP call (include previous context in prompt)
+4. Repeat until consensus or maximum 3 iterations
+5. Deliver final results
 
 ---
 
-## 예상 결과물 예시
+## Expected Output Example
 
 ```markdown
-## PRD 검토 결과 (Codex + Claude 합의)
-
-### 검토 과정
-- 핑퐁 횟수: 2회
-- 합의 상태: 완전 합의
-
-### [VALID] 타당한 피드백
-| 항목 | 설명 | 출처 |
-|------|------|------|
-| 성공 지표 없음 | Goals에 기능 목표만 있음, 성능/비용 기준 미정의 | Codex |
-| 에러 처리 누락 | API 호출 코드에 예외 처리 없음 | Codex + Claude |
-| 테스트 시나리오 | happy-path만 있고 실패 케이스 없음 | Codex |
-
-### [ISSUE] 개선 필요 사항
-| 항목 | 문제점 | 권장 수정 | 출처 |
-|------|--------|----------|------|
-| 의존성 목록 | 존재하지 않는 패키지 언급 | 실제 패키지로 수정 | Claude 검증 |
-| Milestone 상태 | 이미 해결된 이슈 포함 | 완료 표시 또는 제거 | Claude 검증 |
-
-### [CORRECTION] Codex 오류 교정
-| Codex 주장 | 실제 상황 | 근거 |
-|-----------|----------|------|
-| 특정 기능 미구현 | 해당 기능 이미 존재 | src/modules/ 폴더 확인 |
-
-### [SUMMARY] 종합 결론
-PRD는 구조적으로 양호하나, 비기능 요구사항(성능, 보안, 에러 처리)과
-의존성 정보 업데이트가 필요함. 이미 해결된 이슈는 Milestone에서 제거 권장.
+## PRD Review Results (Codex + Claude Consensus)
+
+### Review Process
+- Ping-pong iterations: 2
+- Consensus status: Full consensus
+
+### [VALID] Valid Feedback
+| Item | Description | Source |
+|------|-------------|--------|
+| No success metrics | Goals only list functional goals, no performance/cost criteria defined | Codex |
+| Missing error handling | No exception handling in API call code | Codex + Claude |
+| Test scenarios | Only happy-path exists, no failure cases | Codex |
+
+### [ISSUE] Items Needing Improvement
+| Item | Problem | Recommended Fix | Source |
+|------|---------|-----------------|--------|
+| Dependency list | Non-existent package mentioned | Update to actual package | Claude verification |
+| Milestone status | Includes already-resolved issues | Mark complete or remove | Claude verification |
+
+### [CORRECTION] Codex Error Corrections
+| Codex Claim | Actual Situation | Evidence |
+|-------------|------------------|----------|
+| Feature not implemented | Feature already exists | Verified in src/modules/ folder |
+
+### [SUMMARY] Final Conclusion
+PRD is structurally sound, but non-functional requirements (performance, security, error handling)
+and dependency information need updates. Recommend removing already-resolved issues from Milestone.
 ```