verification-mode v2.5.0 - 통합 검증 단계 추가

문제 발견:
- 배치 검증만으로는 전체 구조 파악 불가
- ch-050 "회고와 전망"을 "2권 마무리"로 오인
- 실제 마지막: ch-059-2 "2부를 향하여" (9개 차이)

해결:
- 통합 검증 (최종 단계) 추가
- 전체 챕터 개수 확인
- 첫/마지막 화 확인
- "마무리" 키워드 검증
- 권 구조 확인 (기승전결)
- 배치 경계 재검증
- 전체 타임라인 검증

워크플로우 업데이트:
- 배치 1~N 검증 → 통합 검증 → 완료

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Alex
2026-01-24 10:15:16 +09:00
parent e61b8ec233
commit f3ace39dc5

View File

@@ -1,10 +1,10 @@
# 검증 모드 프로토콜 # 검증 모드 프로토콜
> **버전:** 2.4.2 > **버전:** 2.5.0
> **최종 수정:** 2026-01-21 > **최종 수정:** 2026-01-24
> **호환:** CWS Writing Guide v4.2.0+ > **호환:** CWS Writing Guide v4.2.0+
> **용도:** 전체 검증 및 기록 (수정 없음) > **용도:** 전체 검증 및 기록 (수정 없음)
> **주요 변경:** 오류 카운트 원칙 추가 (중복 카운트 방지) > **주요 변경:** 통합 검증 단계 추가 (권 전체 구조 확인)
--- ---
@@ -65,6 +65,238 @@ STARTED: 2026-01-20 14:20
--- ---
## 🔄 통합 검증 (최종 단계, v2.5.0 신규)
### 개요
**통합 검증이란?**
- 모든 배치 검증 완료 **후** 실행
- 권 전체 구조 확인 (배치는 나무, 통합은 숲)
- 배치 검증에서 놓칠 수 있는 전체 문제 발견
**왜 필요한가?**
```
문제 사례 (실제 발생):
- 배치 5 검증 시: ch-050 "회고와 전망" 제목 확인 → 마무리처럼 보임
- 배치 6 검증 시: ch-051부터 시작 → "이전 배치 있었겠지" 추정
- ❌ 결과: ch-050이 "2권 마무리"인 줄 잘못 판단
- ✅ 실제: ch-059-2 "2부를 향하여"가 진짜 마지막
→ 배치만 보면 전체 구조를 놓침!
```
### 실행 시점
```
배치 1 검증 → 배치 2 검증 → ... → 배치 N 검증
📋 통합 검증 (NEW!)
검증 완료
```
**마지막 배치 완료 후 즉시 실행**
### 통합 검증 체크 항목
#### 1. 전체 챕터 개수 확인
```markdown
✅ 파일 리스트 확인
- ls volumes/vol-XX/chapters/ch-*.md | wc -l
- 예상 개수와 비교
예시:
- 예상: 50화 (설계 문서 기준)
- 실제: 59화 (ch-001.md ~ ch-059-2.md)
- 판정: ❌ 9개 차이! 확인 필요
✅ 분할 파일 확인
- ch-XXX-1.md, ch-XXX-2.md 존재 여부
- 각 분할 파일 용도 확인
- 원본 ch-XXX.md 삭제 여부 확인
```
#### 2. 첫 화 / 마지막 화 확인
```markdown
✅ 첫 화 확인
- 파일명: ch-001.md
- 제목: "X권 1화: ..."
- 타임라인: 시작 날짜
- 판정: ✅ / ❌
✅ 마지막 화 확인
- 파일 목록 정렬 후 마지막 파일 확인
- ls volumes/vol-XX/chapters/ch-*.md | sort | tail -1
- 예: ch-059-2.md
- 제목 확인: "2부를 향하여" 등
- 마무리 키워드: "끝", "마무리", "다음 권" 등
- 판정: ✅ / ❌
```
#### 3. "마무리" 키워드 검증
```markdown
⚠️ 중요: "마무리" 키워드가 실제 마지막인가?
✅ 검색 실행
- grep -n "회고\|마무리\|결산\|끝" volumes/vol-XX/chapters/ch-*.md
✅ 발견 시 확인
- 위치: ch-050 "회고와 전망"
- 실제 마지막: ch-059-2 "2부를 향하여"
- 판정: ❌ ch-050은 중간 회고, 마지막 아님!
기록:
- "마무리" 키워드 위치: ch-050
- 실제 마지막: ch-059-2
- ⚠️ 혼동 가능성: 높음
```
#### 4. 권 구조 검증
```markdown
✅ 기-승-전-결 구조
- 시작 (1/4 지점): ch-001 ~ ch-015
- 전개 (2/4 지점): ch-016 ~ ch-030
- 위기 (3/4 지점): ch-031 ~ ch-045
- 결말 (4/4 지점): ch-046 ~ 마지막
확인:
- 각 구간이 자연스러운가?
- 갑자기 끝나는 느낌 없는가?
- 마지막 챕터가 정말 끝인가?
예시:
- 2권 총 59화
- 1/4: ch-001~015 (15화)
- 2/4: ch-016~030 (15화)
- 3/4: ch-031~045 (15화)
- 4/4: ch-046~059 (14화)
→ ✅ 균형적
```
#### 5. 배치 경계 재검증
```markdown
✅ 배치 간 연결 확인
- 배치 1 → 배치 2: ch-010 → ch-011
- 배치 2 → 배치 3: ch-020 → ch-021
- ...
- 배치 5 → 배치 6: ch-050 → ch-051
각 경계에서:
- 타임라인 연속성
- 내용 연결성
- 갑작스러운 변화 없음
```
#### 6. 전체 타임라인 검증
```markdown
✅ 시작 → 끝 흐름
- 시작: ch-001 타임라인
- 끝: ch-059 타임라인
- 총 기간 계산
- 역행 없음 재확인
예시:
- 시작: 1947.1.1 (ch-001)
- 끝: 1955.1.1 (ch-059-2)
- 총 기간: 8년
→ ✅ 자연스러움
```
### 통합 검증 보고서 형식
```markdown
# X권 통합 검증 보고서
> **검증일:** YYYY-MM-DD
> **전체 범위:** ch-001 ~ ch-XXX
> **모드:** 통합 검증 (Final Integration Check)
---
## 📊 전체 구조 요약
### 챕터 개수
- **예상:** 50화
- **실제:** 59화
- **판정:** ⚠️ 9개 차이 (확인 필요)
### 첫 화 / 마지막 화
- **첫 화:** ch-001.md "X권 1화: ..." ✅
- **마지막 화:** ch-059-2.md "2부를 향하여" ✅
### "마무리" 키워드 검증
- **발견 위치:** ch-050 "회고와 전망"
- **실제 마지막:** ch-059-2
- **판정:** ⚠️ ch-050은 중간 회고, 혼동 주의!
### 권 구조
- 시작 (1/4): ch-001~015 ✅
- 전개 (2/4): ch-016~030 ✅
- 위기 (3/4): ch-031~045 ✅
- 결말 (4/4): ch-046~059 ✅
### 전체 타임라인
- **시작:** 1947.1.1
- **끝:** 1955.1.1
- **총 기간:** 8년 ✅
---
## 🔴 발견된 문제
### 1. 챕터 개수 불일치
- 예상 50화 vs 실제 59화
- 원인: [확인 필요]
### 2. "마무리" 키워드 혼동 가능성
- ch-050 "회고와 전망"이 마지막처럼 보임
- 실제 마지막: ch-059-2
---
## ✅ 최종 판정
- 전체 구조: ✅ / ⚠️ / ❌
- 챕터 개수: ✅ / ⚠️ / ❌
- 타임라인: ✅ / ⚠️ / ❌
---
**통합 검증 완료**
```
### 통합 검증 체크리스트
```markdown
- [ ] 1. 전체 챕터 개수 확인
- [ ] 2. 첫 화 확인 (ch-001)
- [ ] 3. 마지막 화 확인 (ls | sort | tail -1)
- [ ] 4. "마무리" 키워드 검색 및 검증
- [ ] 5. 권 구조 균형 확인 (기승전결)
- [ ] 6. 배치 경계 재검증
- [ ] 7. 전체 타임라인 흐름 확인
- [ ] 8. 통합 검증 보고서 생성
```
### 통합 검증 실행 명령
```
"통합 검증해"
"권 전체 검증"
"전체 구조 확인해"
```
---
## 📋 검증 모드 개요 ## 📋 검증 모드 개요
**검증 모드는:** **검증 모드는:**
@@ -104,7 +336,9 @@ FIX = 수정
--- ---
## 🎯 6단계 통합 검증 ## 🎯 검증 워크플로우
### 배치 검증 (6단계)
``` ```
사용자: "검증해" 사용자: "검증해"
@@ -116,7 +350,27 @@ FIX = 수정
[5/6] 일관성 검증 중... [5/6] 일관성 검증 중...
[6/6] 보고서 생성 중... [6/6] 보고서 생성 중...
검증 보고서 출력 배치 검증 보고서 출력
```
### 전체 워크플로우 (v2.5.0)
```
배치 1 검증 (6단계)
배치 2 검증 (6단계)
...
배치 N 검증 (6단계)
📋 통합 검증 (최종 단계) ← NEW!
- 전체 챕터 개수 확인
- 첫/마지막 화 확인
- "마무리" 키워드 검증
- 권 구조 확인
통합 검증 보고서
"FIX 모드로 수정하시겠습니까?" "FIX 모드로 수정하시겠습니까?"
``` ```