v4.0: Single Source of Truth 시스템 확립
- claude.md.template 추가 (프로젝트별 필수 파일) - README.md v4.0: Single Source of Truth 핵심 컨셉 추가 - project-structure.md v4.0: claude.md 필수화, standards 제거 - standards 파일들은 Guide/templates/standards/에서만 관리 - 프로젝트별/권별 standards 복사 금지 - 버전 불일치 원천 차단 주요 변경사항: 1. 새 프로젝트 시작 시 claude.md 생성 필수 2. 모든 모드 진입 시 Guide/templates/standards/ 참조 3. 프로젝트 내 standards/ 디렉토리 생성 금지 4. volumes/vol-XX/validation-standards.md 생성 금지 이유: 표준 파일이 여러 곳에 복사되면 버전 불일치 발생 해결: Guide를 유일한 소스로 지정, claude.md로 강제 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -1,10 +1,10 @@
|
||||
# 검증 모드 프로토콜
|
||||
|
||||
> **버전:** 2.4.1
|
||||
> **최종 수정:** 2026-01-20
|
||||
> **버전:** 2.4.2
|
||||
> **최종 수정:** 2026-01-21
|
||||
> **호환:** CWS Writing Guide v4.2.0+
|
||||
> **용도:** 전체 검증 및 기록 (수정 없음)
|
||||
> **주요 변경:** 날씨/계절 일관성 검증 추가 (명시적)
|
||||
> **주요 변경:** 오류 카운트 원칙 추가 (중복 카운트 방지)
|
||||
|
||||
---
|
||||
|
||||
@@ -345,6 +345,206 @@ FIX = 수정
|
||||
|
||||
---
|
||||
|
||||
## 📏 오류 카운트 원칙 (v2.4.2 신규)
|
||||
|
||||
**목적:** 중복 카운트 방지 및 정확한 오류 개수 산출
|
||||
|
||||
### ⚠️ 주의: 중복 카운트 금지
|
||||
|
||||
**문제 상황:**
|
||||
```
|
||||
타임라인 헤더 오류: 7건
|
||||
챕터 간 연결 오류: 3건
|
||||
---
|
||||
합계: 10건 ❌ 잘못된 카운트!
|
||||
```
|
||||
|
||||
**왜 잘못되었나?**
|
||||
- "챕터 간 연결 오류" 3건이 **타임라인 문제에서 발생**
|
||||
- 실제로는 **같은 오류**를 두 번 센 것!
|
||||
- 정확한 합계: 7건 (타임라인 헤더만)
|
||||
|
||||
---
|
||||
|
||||
### ✅ 정확한 카운트 방식
|
||||
|
||||
#### 1. 유형별 카운트 (Primary)
|
||||
|
||||
**각 오류를 정확히 하나의 카테고리에만 분류:**
|
||||
|
||||
```markdown
|
||||
1. 타임라인 헤더 오류: 7건
|
||||
- ch-002, 003, 004, 005, 006, 007, 008
|
||||
- 헤더 날짜 ≠ 본문 날짜
|
||||
|
||||
2. 챕터 간 연결 오류: 3건
|
||||
- ch-002→003, ch-003→004, ch-004→005
|
||||
- 날짜 건너뜀, 본문 표현 문제
|
||||
- ⚠️ 타임라인 오류와 **별개**
|
||||
|
||||
3. 호칭 복수/단수 오류: 2건
|
||||
- ch-002:139, ch-011:511
|
||||
|
||||
4. 설정 모순: 2건
|
||||
- ch-003:417 (나이), ch-003:427 (신분)
|
||||
|
||||
---
|
||||
총 오류: 7+3+2+2 = 14건 ✅
|
||||
```
|
||||
|
||||
#### 2. 챕터별 카운트 (Verification)
|
||||
|
||||
**각 챕터에서 발견된 오류를 개별로 세기:**
|
||||
|
||||
```markdown
|
||||
- ch-002: 2건 (타임라인 1 + 호칭 1)
|
||||
- ch-003: 2건 (타임라인 1 + 설정 1)
|
||||
- ch-004: 3건 (타임라인 1 + 연결 1 + 설정 1)
|
||||
- ch-005: 2건 (타임라인 1 + 연결 1)
|
||||
- ch-006: 1건 (타임라인 1)
|
||||
- ch-007: 1건 (타임라인 1)
|
||||
- ch-008: 1건 (타임라인 1)
|
||||
- ch-011: 2건 (타임라인 1 + 호칭 1)
|
||||
|
||||
---
|
||||
챕터별 합계: 2+2+3+2+1+1+1+2 = 14건 ✅
|
||||
```
|
||||
|
||||
#### 3. 검증 (Mandatory)
|
||||
|
||||
**두 방식의 합계가 반드시 일치해야 함:**
|
||||
|
||||
```
|
||||
유형별 합계: 14건
|
||||
챕터별 합계: 14건
|
||||
---
|
||||
✅ 일치! 정확한 카운트
|
||||
```
|
||||
|
||||
**불일치 시:**
|
||||
```
|
||||
유형별 합계: 17건
|
||||
챕터별 합계: 12건
|
||||
---
|
||||
❌ 불일치! 중복 카운트 발생
|
||||
→ 재확인 필수
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 🚨 중복 카운트가 발생하는 패턴
|
||||
|
||||
#### 패턴 1: 연결 문제를 두 번 세기
|
||||
|
||||
**잘못된 방식:**
|
||||
```markdown
|
||||
타임라인 오류 (10건):
|
||||
- 헤더 오류: ch-002~008 (7건)
|
||||
- 연결 문제: ch-002→003, ch-003→004, ch-004→005 (3건)
|
||||
|
||||
챕터 간 연결 오류 (3건):
|
||||
- ch-002→003, ch-003→004, ch-004→005
|
||||
|
||||
---
|
||||
합계: 10 + 3 = 13건 ❌ (연결 3건 중복!)
|
||||
```
|
||||
|
||||
**올바른 방식:**
|
||||
```markdown
|
||||
타임라인 헤더 오류 (7건):
|
||||
- ch-002~008
|
||||
|
||||
챕터 간 연결 오류 (3건):
|
||||
- ch-002→003, ch-003→004, ch-004→005
|
||||
|
||||
---
|
||||
합계: 7 + 3 = 10건 ✅
|
||||
```
|
||||
|
||||
#### 패턴 2: 하위 카테고리를 상위와 중복
|
||||
|
||||
**잘못된 방식:**
|
||||
```markdown
|
||||
설정 오류 (5건):
|
||||
- 나이 불일치: 2건
|
||||
- 신분 모순: 1건
|
||||
- 위치 충돌: 2건
|
||||
|
||||
나이 불일치 (2건):
|
||||
- ch-003, ch-015
|
||||
|
||||
---
|
||||
합계: 5 + 2 = 7건 ❌ (나이 2건 중복!)
|
||||
```
|
||||
|
||||
**올바른 방식:**
|
||||
```markdown
|
||||
설정 오류 (5건):
|
||||
- 나이 불일치: 2건 (ch-003, ch-015)
|
||||
- 신분 모순: 1건
|
||||
- 위치 충돌: 2건
|
||||
|
||||
---
|
||||
합계: 5건만 ✅
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 📋 보고서 작성 체크리스트
|
||||
|
||||
**보고서 완성 전 필수 확인:**
|
||||
|
||||
- [ ] 1. 유형별 오류 합계 계산
|
||||
- [ ] 2. 챕터별 오류 합계 계산
|
||||
- [ ] 3. 두 합계가 일치하는지 확인
|
||||
- [ ] 4. 불일치 시 중복 카운트 찾기
|
||||
- [ ] 5. 중복 제거 후 재계산
|
||||
- [ ] 6. 최종 합계 확정
|
||||
- [ ] 7. "총 X건" 표기
|
||||
|
||||
**예시:**
|
||||
```markdown
|
||||
## 검증 요약
|
||||
|
||||
### 유형별
|
||||
- 타임라인: 7건
|
||||
- 연결: 3건
|
||||
- 호칭: 2건
|
||||
- 설정: 2건
|
||||
**합계: 14건**
|
||||
|
||||
### 챕터별
|
||||
- ch-002: 2건
|
||||
- ch-003: 2건
|
||||
- ...
|
||||
**합계: 14건**
|
||||
|
||||
✅ 검증 완료 (일치)
|
||||
|
||||
**총 발견 오류: 14건**
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 🔧 보완 권장 사항
|
||||
|
||||
1. **validation 작성 시**
|
||||
- 각 오류를 정확히 하나의 카테고리에만 할당
|
||||
- 중복 가능성이 있는 항목은 명시적으로 분리
|
||||
- 예: "타임라인 헤더" vs "챕터 간 연결"
|
||||
|
||||
2. **최종 보고 전**
|
||||
- 유형별/챕터별 합계 검증 필수
|
||||
- 불일치 발생 시 중복 카운트 재확인
|
||||
- 정확한 숫자 확정 후 보고
|
||||
|
||||
3. **카운트 방식 표준화**
|
||||
- 명확한 카테고리 정의
|
||||
- 중복 방지 원칙 적용
|
||||
- 검증 절차 준수
|
||||
|
||||
---
|
||||
|
||||
## 📊 검증 보고서 형식
|
||||
|
||||
```markdown
|
||||
|
||||
Reference in New Issue
Block a user