# task-1874 방지책 Tier 1 구현 + 시스템3문서 적용

## 배경
task-1874 Agent 미팅에서 "보고서 ≠ 실제 구현" 패턴의 근본 원인 4가지와 방지책 6개를 도출.
3문서 체계(task-1872) Phase 6까지 완료됨. 이제 task-1874 방지책을 시스템3문서에 반영 + Tier 1 방지책 코드 구현.

## 작업 1: 시스템3문서에 task-1874 결과 반영

### 1-1. cross-verification-workflow/plan.md 업데이트
위치: `/home/jay/workspace/memory/plans/cross-verification-workflow/plan.md`

추가할 섹션: "9. 보고서≠구현 방지 체계 (task-1874)"
```
### 9.1 근본 원인
1. Edit 도구 조용한 실패 + 보고 생성 편향
2. 서브에이전트 컨텍스트 격리
3. selfQC 자기보고 맹점
4. 파일 크기-실패 양의 상관관계 (2000줄+)

### 9.2 방지책 로드맵
- Tier 1 (즉시): Edit 직후 grep 검증 의무화, 보고서 planned/verified 분리
- Tier 2 (1주): Large-File Protocol, 심볼 존재 검증기, File-Touch Ratio
- Tier 3 (1개월): G3 독립 검증 에이전트
```

### 1-2. cross-verification-workflow/context-notes.md 업데이트
미팅 기록 참조 추가:
```
### 2026-04-16 보고서≠구현 원인분석 미팅
- 참가자: 9명 (5팀 전체 + 로키/마아트/비너스/아틀라스)
- 상세: memory/meetings/2026-04-16-report-impl-gap-analysis.md
- 합의: Tier 1~3 방지책 채택
```

### 1-3. cross-verification-workflow/checklist.md 업데이트
"보고서≠구현 방지" 섹션 추가:
```
## 보고서≠구현 방지 (task-1874)
- [ ] Tier 1-A: DIRECT-WORKFLOW에 Edit 직후 grep 검증 의무화
- [ ] Tier 1-B: 보고서 템플릿에 planned/verified 분리
- [ ] Tier 2-A: Large-File Protocol (2000줄 임계값)
- [ ] Tier 2-B: qc_verify.py 심볼 존재 검증기
- [ ] Tier 2-C: File-Touch Ratio 메트릭
- [ ] Tier 3-A: G3 독립 검증 에이전트
```

## 작업 2: Tier 1 방지책 코드 구현

### 2-1. Tier 1-A: DIRECT-WORKFLOW에 Edit 직후 grep 검증 의무화
위치: `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md`

Phase 3(구현) 단계에 추가:
```
### ★ Edit 직후 grep 검증 (필수)
파일을 Edit한 후 반드시 grep으로 변경이 실제 반영되었는지 확인하세요:
1. Edit 도구로 코드 수정
2. 즉시 grep -n "삽입한_핵심_키워드" 파일경로 실행
3. grep 결과가 0건이면 Edit이 실패한 것 → 재시도 필수
4. 이 검증 없이 다음 단계로 넘어가지 마세요

★ 대형 파일(2000줄+) 주의: Edit 실패 확률 높음. offset/limit으로 삽입 위치 전후 200줄을 먼저 읽은 후 Edit 권장.
```

### 2-2. Tier 1-B: 보고서 템플릿에 planned/verified 분리
위치: `/home/jay/workspace/teams/shared/QC-RULES.md`

보고서 형식에 추가:
```
### 수정 파일별 검증 상태 (필수)
각 수정 파일에 대해 planned(계획) vs verified(검증됨) 구분:
| 파일 | 변경 내용 | grep 검증 | 상태 |
|------|-----------|-----------|------|
| dispatch.py:854 | --month 인자 추가 | grep "--month" OK | verified |
| routes_get.py:1870 | idle 리셋 | grep "idle" OK | verified |

planned = 계획만 세움 (구현 미확인)
verified = grep/테스트로 실제 존재 확인
★ planned 항목이 1건이라도 있으면 .done 생성 금지
```

### 2-3. team_prompts.py에 Edit 검증 리마인더
위치: `/home/jay/workspace/prompts/team_prompts.py`

모든 레벨 프롬프트에 (Lv.1+) 추가:
```
★ Edit 직후 반드시 grep으로 변경 반영을 확인하세요. grep 0건 = Edit 실패입니다.
```

## 영향 파일
- `/home/jay/workspace/memory/plans/cross-verification-workflow/plan.md` — 수정
- `/home/jay/workspace/memory/plans/cross-verification-workflow/context-notes.md` — 수정
- `/home/jay/workspace/memory/plans/cross-verification-workflow/checklist.md` — 수정
- `/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에 "Edit 직후 grep 검증" 섹션 존재 확인
2. QC-RULES.md에 "planned/verified" 보고서 형식 존재 확인
3. team_prompts 프롬프트에 Edit grep 리마인더 포함 확인
4. 시스템3문서에 task-1874 결과 반영 확인 (plan.md 섹션 9, context-notes.md 미팅 기록, checklist Tier 항목)
5. 기존 pytest 회귀 없음

## 주의
- cross-verification-workflow/plan.md 대용량 (~760줄) — offset/limit
- team_prompts.py 대용량 (~47KB) — offset/limit
- QC-RULES.md 대용량 가능 — offset/limit
- 시스템3문서 수정이므로 기존 내용 삭제/변경 금지, 추가만
- 수정 후 즉시 커밋