Files

Alex 45bc3face4 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>

2026-02-01 20:38:16 +09:00

7.9 KiB

Raw Blame History

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. 프로토콜 기반

모든 검증은 명문화된 프로토콜 따름
"어떻게 검증할 것인가"가 명확히 정의됨
주관적 판단 최소화

📦 신규 생성 파일 목록

프로토콜 파일

templates/standards/plot-master-verification.md v1.0.0
- Phase 4-1 검증 프로토콜
templates/standards/volume-plot-mode.md v1.0.0
- Phase 4-2 작성 프로토콜
templates/standards/volume-plot-verification.md v1.0.0
- Phase 4-2 검증 프로토콜

분석 문서 (참고용)

CWS-프로세스-문제-분석-보고서.md
- 타임라인 에러 근본 원인 분석
CWS-프로세스-근본적-재설계.md
- 프로세스 재설계 제안
CWS-파일명-및-내용-재정의.md
- 파일명 변경 및 내용 정의
CWS-v1.4-검증-구조-개선.md (이 문서)
- v1.4 변경 사항 요약

가이드 업데이트

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 재검증 필요

적용 순서:

CWS Design Guide v1.4 검토 및 승인
1945 프로젝트에 새 프로토콜 적용
volume-plot.md 타임라인 에러 수정
volume-plot-verification.md 재실행
통과 후 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 철학

7.9 KiB Raw Blame History

CWS v1.4 검증 구조 개선 요약

🚨 문제 발견

표면적 문제

근본적 문제

✅ 해결 방안: Fail Fast 철학 도입

📋 v1.4 변경 사항

1. Phase 4-1 검증 추가 ⭐ 신규

2. Phase 4-2 검증 강화 ⭐ 개선

3. Phase 4-3 참조 파일명 수정

4. Phase 5 역할 재정의

📊 효과 비교

에러 발견 시 재작업 범위

🗂️ 파일명 재정의 (참고)

변경 사유

변경 내용

📝 프로세스 워크플로우 (v1.4)

🎯 핵심 원칙

1. Fail Fast

2. 계층별 검증

3. 프로토콜 기반

📦 신규 생성 파일 목록

프로토콜 파일

분석 문서 (참고용)

가이드 업데이트

⚠️ 중요 공지

기존 프로젝트 (1945) 적용

🔍 추가 개선 필요 사항

1. Phase 4-1 작성 프로토콜

2. Phase 4-3 검증 프로토콜

7.9 KiB

Raw Blame History