# 3문서 2유형 체계 Phase 5: 검증 파이프라인 통합

## 배경
- Phase 1 (task-1872_6.1): 스키마 확정 ✅
- Phase 2 (task-1872_6.2): 템플릿 + dispatch 자동 생성 ✅
- Phase 3 (task-1872_6.3): team_prompts + DIRECT-WORKFLOW 연동 ✅
- Phase 4 (task-1872_6.4): QC verifier 3문서 검증 연동 ✅
- **Phase 5: 검증 파이프라인 통합** ← 현재
- Phase 6: 테스트 + 문서화

Phase 1~4에서 개별 컴포넌트가 구현됐으나 end-to-end 파이프라인이 연결되지 않은 부분이 있음:
1. .done 생성 전 3문서 검증이 자동 실행되지 않음
2. QC-RULES.md에 3문서 검증 항목이 명시되지 않음
3. qc_verify.py의 three_docs_check가 Lv.3+ 자동 판별하지 못함 (디렉토리 존재로만 판단)

## 작업 내용

### 1. DIRECT-WORKFLOW.md의 완료 단계에 3문서 검증 강제
위치: `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md`

Phase 5(보고서 작성) 또는 Phase 6(완료) 단계에서:
```
### 3문서 검증 (Lv.3+ 작업)
memory/plans/tasks/{task_id}/ 디렉토리가 존재하면:
1. plan.md status가 completed 또는 in-progress인지 확인
2. checklist.md에서 [x] 비율 50% 이상인지 확인
3. 위 조건 미충족 시 .done 생성 전 3문서 업데이트 필수
```

### 2. QC-RULES.md에 3문서 검증 항목 추가
위치: `/home/jay/workspace/teams/shared/QC-RULES.md`

셀프 QC 체크리스트에 추가:
```
- [ ] 11. 3문서 업데이트 (Lv.3+): plan.md/context-notes.md/checklist.md가 존재하면 status 업데이트 + 체크리스트 체크 완료
```

자동 검증 섹션에 three_docs_check 설명 추가:
```
### three_docs_check (Lv.3+ 작업 전용)
- 3문서 디렉토리 존재 시 자동 실행
- PASS: 3문서 존재 + YAML 유효 + status 업데이트 + 플레이스홀더 제거 + 체크리스트 50%+
- WARN: 부분 미충족 (작업은 계속 가능)
- FAIL: 디렉토리 존재하나 파일 누락 또는 YAML 파싱 실패
- SKIP: 디렉토리 미존재 (Lv.2 이하 작업 = 정상)
```

### 3. team_prompts.py 보고서 단계 3문서 검증 리마인더
위치: `/home/jay/workspace/prompts/team_prompts.py`

`_build_three_docs_section()` 함수 또는 build_prompt()에서:
Lv.3+ 프롬프트 끝부분에 추가:
```
⚠️ 보고서 작성 전 3문서 업데이트를 잊지 마세요:
- plan.md: status → completed (또는 in-progress)
- context-notes.md: 결정 근거 기록
- checklist.md: 완료 항목 [x] 체크
```

### 4. 통합 테스트 (end-to-end)
실제 `task-1872_6.4` (완료된 Lv.3 작업) 기준으로:
1. `qc_verify.py --task-id task-1872_6.4` 실행 → three_docs_check PASS 확인
2. `qc_verify.py --task-id task-1879` (Lv.2 작업) 실행 → three_docs_check SKIP 확인
3. 플레이스홀더 그대로인 3문서에 대해 실행 → WARN 확인

## 영향 파일
- `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md` — 수정
- `/home/jay/workspace/teams/shared/QC-RULES.md` — 수정
- `/home/jay/workspace/prompts/team_prompts.py` — 수정 (리마인더 추가)

## 검증 시나리오
1. DIRECT-WORKFLOW.md에 3문서 검증 단계 존재 확인
2. QC-RULES.md에 셀프 QC 11번 + three_docs_check 설명 존재 확인
3. `--level critical` 프롬프트에 3문서 업데이트 리마인더 포함 확인
4. `qc_verify.py --task-id task-1872_6.4` → three_docs_check PASS
5. `qc_verify.py --task-id task-1879` → three_docs_check SKIP
6. 기존 pytest 회귀 없음

## 주의
- QC-RULES.md 대용량 가능성 — offset/limit
- team_prompts.py 대용량 (46KB) — offset/limit 필수
- 수정 후 즉시 커밋