CWS v2.0 완성: 25개 프로세스 가이드 완성
- 54개 파일 작성 완료 (setup 25개 + guides 25개 + 메타 4개) - 프로세스 체계: P0(3) + P1(10) + P2(3) + P3(6) + P4(3) = 25개 - Claude 가독성: 5-10KB 가이드로 읽기 가능 - 파일명 고유성: vol-XX 접두사 보장 - 히스토리 강제화: logs/ 시스템 - 메타 문서: README, PROCESS-CATALOG, FILE-STRUCTURE, CHANGELOG Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Alex
297
CWS-v1.4-검증-구조-개선.md
Normal file
297
CWS-v1.4-검증-구조-개선.md
Normal file
@@ -0,0 +1,297 @@
|
||||
# CWS v1.4 검증 구조 개선 요약
|
||||
|
||||
> **작성일:** 2026-01-26
|
||||
> **버전:** v1.4
|
||||
> **변경 사유:** Phase 4-2 타임라인 에러 4건 발생 → 근본 원인 분석 → 프로세스 구조적 개선
|
||||
|
||||
---
|
||||
|
||||
## 🚨 문제 발견
|
||||
|
||||
### 표면적 문제
|
||||
- `volumes/vol-04/volume-plot.md` (구 plot-master.md)에서 타임라인 에러 4건 발견
|
||||
- 16-17화 겹침, 21-22화 6.5개월 공백, 44-45화 6개월 공백, 45-46-47화 3중 겹침
|
||||
|
||||
### 근본적 문제
|
||||
```
|
||||
Phase 4-1 작성 → 검증 없음! ❌
|
||||
Phase 4-2 작성 → 검증 없음! ❌
|
||||
Phase 4-3 작성 → 검증 없음! ❌
|
||||
Phase 5 → 모든 것을 한꺼번에 검증
|
||||
|
||||
= 에러 발견 시 50화 재작업 발생!
|
||||
```
|
||||
|
||||
**핵심:** 각 Phase 완료 후 검증 없이 다음 Phase로 진행 → 에러 누적 → 후반부에서 대규모 재작업
|
||||
|
||||
---
|
||||
|
||||
## ✅ 해결 방안: Fail Fast 철학 도입
|
||||
|
||||
```
|
||||
기존 (v1.3):
|
||||
설계 → 설계 → 설계 → 한꺼번에 검증
|
||||
|
||||
개선 (v1.4):
|
||||
설계 → 검증 → 설계 → 검증 → 설계 → 검증 → 최종 검증
|
||||
```
|
||||
|
||||
**원칙:** "실패는 일찍 할수록 좋다" (Fail Fast)
|
||||
|
||||
---
|
||||
|
||||
## 📋 v1.4 변경 사항
|
||||
|
||||
### 1. Phase 4-1 검증 추가 ⭐ 신규
|
||||
|
||||
**변경 전:**
|
||||
```
|
||||
Phase 4-1 작성 → Phase 4-2 진행
|
||||
(검증 없음)
|
||||
```
|
||||
|
||||
**변경 후:**
|
||||
```
|
||||
Phase 4-1 작성
|
||||
↓
|
||||
Phase 4-1 검증 ⭐ 신규!
|
||||
- 프로토콜: plot-master-verification.md v1.0.0
|
||||
- 검증 항목:
|
||||
1. 상위 계층 반영 (project-config, characters, timeline)
|
||||
2. 구조 완성도 (0단계 + 1단계)
|
||||
3. 시즌 간 일관성
|
||||
4. 권별 목표 명확성
|
||||
5. 복선 계획 (시즌 간 3개+, 권 간 5개+)
|
||||
6. 로맨스/갈등 라인
|
||||
- 통과 조건: 모든 항목 ✅
|
||||
- 실패 시: plot-master.md 수정 후 재검증
|
||||
↓
|
||||
검증 통과 후 Phase 4-2 진행 허용
|
||||
```
|
||||
|
||||
**산출물:**
|
||||
- `settings/plot-master-verification-report.md` ← 검증 보고서
|
||||
|
||||
**프로토콜 파일:**
|
||||
- `templates/standards/plot-master-verification.md` v1.0.0 ← 신규 생성
|
||||
|
||||
---
|
||||
|
||||
### 2. Phase 4-2 검증 강화 ⭐ 개선
|
||||
|
||||
**변경 전:**
|
||||
```
|
||||
Phase 4-2 작성 → Phase 4-3 진행
|
||||
(체크리스트만 있고 프로토콜 없음)
|
||||
```
|
||||
|
||||
**변경 후:**
|
||||
```
|
||||
Phase 4-2 작성
|
||||
- 프로토콜: volume-plot-mode.md v1.0.0
|
||||
↓
|
||||
Phase 4-2 검증 ⭐ 프로토콜 추가!
|
||||
- 프로토콜: volume-plot-verification.md v1.0.0
|
||||
- 검증 항목:
|
||||
1. 상위 계층 반영 (plot-master.md)
|
||||
2. 타임라인 일관성 ⭐⭐⭐ 핵심!
|
||||
- 역행 체크 (0건 필수)
|
||||
- 겹침 체크 (0건 필수)
|
||||
- 공백 체크 (>3개월 사유 필요)
|
||||
3. 내용 완성도
|
||||
4. 복선 검증
|
||||
5. 캐릭터 나이 검증
|
||||
- 통과 조건: 타임라인 에러 0건 ⭐ 필수!
|
||||
- 실패 시: volume-plot.md 수정 후 재검증
|
||||
↓
|
||||
검증 통과 후 Phase 4-3 진행 허용
|
||||
```
|
||||
|
||||
**산출물:**
|
||||
- `volumes/vol-XX/volume-plot-verification-report.md` ← 검증 보고서
|
||||
|
||||
**프로토콜 파일:**
|
||||
- `templates/standards/volume-plot-mode.md` v1.0.0 ← 신규 생성
|
||||
- `templates/standards/volume-plot-verification.md` v1.0.0 ← 신규 생성
|
||||
|
||||
---
|
||||
|
||||
### 3. Phase 4-3 참조 파일명 수정
|
||||
|
||||
**변경:**
|
||||
- "Phase 4-2 (권별 플롯) 읽기" → "Phase 4-2 (volume-plot.md) 읽기"
|
||||
- 명확한 파일명 명시로 혼동 방지
|
||||
|
||||
---
|
||||
|
||||
### 4. Phase 5 역할 재정의
|
||||
|
||||
**변경 전:**
|
||||
```
|
||||
Phase 5: 설계 검증
|
||||
- 모든 것을 여기서 처음 검증 (품질 + 일관성)
|
||||
```
|
||||
|
||||
**변경 후:**
|
||||
```
|
||||
Phase 5: 설계 검증 (최종 통합 검증)
|
||||
- Phase 4-1, 4-2는 이미 개별 검증 완료
|
||||
- Phase 5는 전체 통합 품질 및 계층 간 일관성 검증
|
||||
- 개별 에러는 이미 제거된 상태
|
||||
```
|
||||
|
||||
**강조:** Phase 5는 "최초 검증"이 아니라 "최종 통합 검증"
|
||||
|
||||
---
|
||||
|
||||
## 📊 효과 비교
|
||||
|
||||
### 에러 발견 시 재작업 범위
|
||||
|
||||
| 시나리오 | v1.3 (기존) | v1.4 (개선) | 개선율 |
|
||||
|----------|-------------|-------------|--------|
|
||||
| Phase 4-1에 에러 | 전체 50화 재작업 | Phase 4-1만 수정 | 95% 감소 |
|
||||
| Phase 4-2에 에러 | 50화 재작업 | Phase 4-2만 수정 | 90% 감소 |
|
||||
| Phase 4-3에 에러 | 5-10화 재작업 | 5화 재작업 | 50% 감소 |
|
||||
|
||||
**핵심:** 에러를 빨리 발견할수록 재작업 범위 급감!
|
||||
|
||||
---
|
||||
|
||||
## 🗂️ 파일명 재정의 (참고)
|
||||
|
||||
### 변경 사유
|
||||
- 두 파일이 모두 "plot-master.md"로 명명되어 혼동 발생
|
||||
|
||||
### 변경 내용
|
||||
|
||||
| Phase | 기존 파일명 | 신규 파일명 | 내용 |
|
||||
|-------|-------------|-------------|------|
|
||||
| 4-1 | settings/plot-master.md | settings/plot-master.md (유지) | 전체 시즌 플롯 (0단계 + 1단계) |
|
||||
| 4-2 | volumes/vol-XX/plot-master.md | volumes/vol-XX/volume-plot.md ⭐ 변경 | 권별 50화 플롯 (2단계) |
|
||||
| 4-3 | plots/plot-001-005.md | plots/plot-001-005.md (유지) | 5화 상세 플롯 (3단계) |
|
||||
|
||||
---
|
||||
|
||||
## 📝 프로세스 워크플로우 (v1.4)
|
||||
|
||||
```
|
||||
Phase 0-3: 설계 준비
|
||||
↓
|
||||
Phase 4-1: 전체 & 시즌 플롯
|
||||
- settings/plot-master.md 작성
|
||||
↓
|
||||
Phase 4-1 검증 ⭐ 신규!
|
||||
- plot-master-verification.md 프로토콜 실행
|
||||
- 모든 항목 ✅ → 통과
|
||||
- 검증 보고서 작성
|
||||
↓
|
||||
Phase 4-2: 권별 플롯
|
||||
- volumes/vol-XX/volume-plot.md 작성
|
||||
- volume-plot-mode.md 프로토콜 따름
|
||||
↓
|
||||
Phase 4-2 검증 ⭐ 프로토콜 추가!
|
||||
- volume-plot-verification.md 프로토콜 실행
|
||||
- 타임라인 에러 0건 ✅ → 통과
|
||||
- 검증 보고서 작성
|
||||
↓
|
||||
Phase 4-3: 5화별 상세 플롯
|
||||
- plots/plot-001-005.md 작성 (10개 파일)
|
||||
- plot-mode.md v2.0.0 프로토콜 따름
|
||||
- 타임라인 검증 (5화 단위)
|
||||
↓
|
||||
Phase 5: 최종 통합 검증
|
||||
- Phase 5-1: 품질 검증 (Opus)
|
||||
- Phase 5-2: 일관성 검증 (Codex)
|
||||
- 전체 통합 품질 확인
|
||||
↓
|
||||
Phase 6: Writing (실제 집필)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 핵심 원칙
|
||||
|
||||
### 1. Fail Fast
|
||||
- 에러는 발생 즉시 발견되어야 함
|
||||
- 각 Phase 완료 즉시 검증 실행
|
||||
- 검증 실패 시 다음 Phase 진행 금지
|
||||
|
||||
### 2. 계층별 검증
|
||||
- Phase 4-1: 전체 구조 검증
|
||||
- Phase 4-2: 권 단위 검증 (특히 타임라인!)
|
||||
- Phase 4-3: 5화 단위 검증
|
||||
- Phase 5: 전체 통합 검증
|
||||
|
||||
### 3. 프로토콜 기반
|
||||
- 모든 검증은 명문화된 프로토콜 따름
|
||||
- "어떻게 검증할 것인가"가 명확히 정의됨
|
||||
- 주관적 판단 최소화
|
||||
|
||||
---
|
||||
|
||||
## 📦 신규 생성 파일 목록
|
||||
|
||||
### 프로토콜 파일
|
||||
1. `templates/standards/plot-master-verification.md` v1.0.0
|
||||
- Phase 4-1 검증 프로토콜
|
||||
|
||||
2. `templates/standards/volume-plot-mode.md` v1.0.0
|
||||
- Phase 4-2 작성 프로토콜
|
||||
|
||||
3. `templates/standards/volume-plot-verification.md` v1.0.0
|
||||
- Phase 4-2 검증 프로토콜
|
||||
|
||||
### 분석 문서 (참고용)
|
||||
4. `CWS-프로세스-문제-분석-보고서.md`
|
||||
- 타임라인 에러 근본 원인 분석
|
||||
|
||||
5. `CWS-프로세스-근본적-재설계.md`
|
||||
- 프로세스 재설계 제안
|
||||
|
||||
6. `CWS-파일명-및-내용-재정의.md`
|
||||
- 파일명 변경 및 내용 정의
|
||||
|
||||
7. `CWS-v1.4-검증-구조-개선.md` (이 문서)
|
||||
- v1.4 변경 사항 요약
|
||||
|
||||
### 가이드 업데이트
|
||||
8. `CWS Design Guide.md`
|
||||
- Phase 4-1 (8.3, 8.5) 업데이트
|
||||
- Phase 4-2 (9.2) 업데이트
|
||||
- Phase 4-3 (10.3) 업데이트
|
||||
- Phase 5 (11.1, 11.2, 11.4) 업데이트
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 중요 공지
|
||||
|
||||
### 기존 프로젝트 (1945) 적용
|
||||
|
||||
**현재 상태:**
|
||||
- `volumes/vol-04/plot-master.md` → `volumes/vol-04/volume-plot.md`로 리네임 예정
|
||||
- 타임라인 에러 4건 수정 필요
|
||||
- Phase 4-2 재검증 필요
|
||||
|
||||
**적용 순서:**
|
||||
1. CWS Design Guide v1.4 검토 및 승인
|
||||
2. 1945 프로젝트에 새 프로토콜 적용
|
||||
3. volume-plot.md 타임라인 에러 수정
|
||||
4. volume-plot-verification.md 재실행
|
||||
5. 통과 후 Phase 4-3 재개
|
||||
|
||||
---
|
||||
|
||||
## 🔍 추가 개선 필요 사항
|
||||
|
||||
### 1. Phase 4-1 작성 프로토콜
|
||||
- 현재: 검증 프로토콜만 존재
|
||||
- 필요: plot-master-mode.md 작성 (작성 프로토콜)
|
||||
|
||||
### 2. Phase 4-3 검증 프로토콜
|
||||
- 현재: plot-mode.md에 검증 내용 포함
|
||||
- 검토 필요: 별도 검증 프로토콜 분리 여부
|
||||
|
||||
---
|
||||
|
||||
*"The best time to catch a bug is when you write it, not 50 episodes later." - CWS v1.4 철학*
|
||||
Reference in New Issue
Block a user