# 3문서 2유형 체계 Phase 6: 통합 테스트 + 문서화

## 배경
- 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 (task-1872_6.5): 검증 파이프라인 통합 ✅
- **Phase 6: 통합 테스트 + 문서화** ← 현재 (최종)

## 작업 내용

### 1. End-to-End 통합 테스트
파일: `/home/jay/workspace/tests/test_3docs_e2e.py`

전체 파이프라인을 시뮬레이션하는 통합 테스트:

1. **dispatch → 3문서 자동 생성 테스트**
   - `--level critical` dispatch 호출 → `memory/plans/tasks/{task_id}/` 디렉토리 + 3파일 생성 확인
   - YAML frontmatter 유효성 확인 (task_id, type, scope, status)
   - `--level normal` dispatch → 3문서 미생성 확인

2. **team_prompts 3문서 지침 포함 테스트**
   - `level="critical"` → 프롬프트에 "3문서 활용 지침" 섹션 포함
   - `level="critical"` → 프롬프트에 "보고서 작성 전 3문서 업데이트" 리마인더 포함
   - `level="normal"` → 해당 섹션 미포함

3. **QC verifier 3문서 검증 테스트**
   - 완료된 Lv.3 작업(3문서 업데이트됨) → PASS
   - 완료된 Lv.3 작업(3문서 플레이스홀더 그대로) → WARN
   - Lv.2 작업(3문서 없음) → SKIP
   - 3문서 디렉토리 있으나 파일 누락 → FAIL

4. **DIRECT-WORKFLOW 3문서 단계 존재 확인**
   - Step 1.2 "3문서 확인" 텍스트 존재
   - Step 5.2 "3문서 업데이트" 텍스트 존재
   - Step 5.3 "3문서 검증 강제" 텍스트 존재

### 2. 문서화: 3문서 시스템 사용 가이드
파일: `/home/jay/workspace/memory/specs/3docs-usage-guide.md`

내용:
- 3문서란? (plan.md, context-notes.md, checklist.md)
- 2유형: 시스템 3문서 vs 작업 3문서
- 자동 생성 조건 (Lv.3+ = critical/security)
- 팀장 의무 (읽기 → 활용 → 업데이트)
- QC 검증 (three_docs_check verifier)
- 스키마 참조: `memory/specs/3docs-schema.md`
- 경로 규약: 시스템 = `memory/plans/{project}/`, 작업 = `memory/plans/tasks/{task_id}/`

### 3. 시스템 3문서(cross-verification-workflow) 최종 업데이트
파일: `/home/jay/workspace/memory/plans/cross-verification-workflow/checklist.md`

Phase 1~6 전체 체크리스트 완료 상태 업데이트:
- 1872_6.1~6.5 항목 [x] 체크
- Phase 6(현재) 항목 [x] 체크
- plan.md status → completed

## 영향 파일
- `/home/jay/workspace/tests/test_3docs_e2e.py` — 신규
- `/home/jay/workspace/memory/specs/3docs-usage-guide.md` — 신규
- `/home/jay/workspace/memory/plans/cross-verification-workflow/checklist.md` — 수정
- `/home/jay/workspace/memory/plans/cross-verification-workflow/plan.md` — 수정

## 검증 시나리오
1. `pytest tests/test_3docs_e2e.py` 전체 PASS
2. 기존 pytest 회귀 없음
3. 3docs-usage-guide.md 내용 완성도 확인
4. 시스템 3문서 checklist 최종 상태 확인

## 주의
- 기존 테스트와 충돌 없도록 독립 테스트 파일
- cross-verification-workflow 3문서는 시스템 3문서이므로 신중하게 수정
- 수정 후 즉시 커밋