Alex/novel-writing-guide
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Design Guide v1.6.0: Phase 4 태스크 기반 재설계 + 전체 프로세스 검증 완료

Browse Source 
- Phase 4 아키텍처 재설계: 수량 기반 → 태스크 실행 기반
- phase4-master-design.md 신규 (전체 Phase 4 아키텍처)
- 설계 모드 11개 신규/갱신:
  - plot-master-mode/verification (Phase 4-1)
  - volume-timeline-mode/verification (Phase 4-2선행)
  - volume-characters-mode/verification (Phase 4-2선행)
  - volume-plot-mode/verification (Phase 4-2)
  - plot-detail-verification (Phase 4-3)
  - design-verification-mode (Phase 5)
- 검증 프로토콜 강화:
  - 에스컬레이션 경로, 신뢰 모델, 유효성 조건 전 프로토콜 통일
  - 검증 보고서 유효성 관리 (report-management.md 연동)
  - 권 경계 교차 검증 추가 (Phase 4-2 §6.3, 4-3 §4.3, Phase 5 검증 6)
  - 입력 소비 확인 (Phase 4-1 검증 0)
- 작성 파이프라인 보강:
  - writing-mode: Phase 5 통과 전제 명시, vol-XX-plot.md INPUT 추가
  - polish-mode: VERIFICATION→FIX 완료 필수 진입 조건
- 3회 종합 감사 통과 (설계+작성 전체, 실제 문제 0건)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Alex
2026-01-27 21:52:24 +09:00
parent b9351db95e
commit c56b6f1f76
23 changed files with 6627 additions and 971 deletions
Download Patch File Download Diff File Expand all files Collapse all files

305
templates/standards/README.md
View File

@@ -1,7 +1,7 @@
# CWS Writing Standards - 프로토콜 인덱스
> **최종 업데이트:** 2026-01-25
> **CWS Writing Guide 버전:** v4.2.0+
> **최종 업데이트:** 2026-01-27
> **CWS Writing Guide 버전:** v4.3.0+
이 디렉토리는 Creative Writing System (CWS)의 표준 프로토콜을 담고 있습니다.
@@ -135,7 +135,7 @@
**주요 내용:**
- 디렉토리 구조
- 파일명 규칙 (ch-XXX.md)
- 메타데이터 파일 (plot-master.md, timeline.md 등)
- 메타데이터 파일 (plot-master.md, vol-XX-timeline.md 등)
---
@@ -157,12 +157,16 @@
### 8. PLOT 모드 📐
**파일:** `plot-mode.md`
**버전:** v2.0.0
**최종 수정:** 2026-01-25
**버전:** v3.1.0 ⭐ 업데이트
**최종 수정:** 2026-01-27
**용도:** 플롯 상세 설계 및 타임라인 검증 (설계 철저화로 90% 품질 달성)
**주요 기능:**
- 상세 설계 템플릿 ⭐ NEW (v2.0.0)
- vol-XX-plot.md 참조 및 일치성 검증 강화 ⭐ NEW (v2.2.0)
- Phase 2-1: 각 화 작성 전 vol-XX-plot.md 확인 필수
- Phase 3-2: 5화 완성 후 vol-XX-plot.md 일치성 검증
- 계층적 반영 보증 (2단계 → 3단계)
- 상세 설계 템플릿 (v2.0.0)
- 캐릭터 목표 & 갈등 설계
- 감정선 설계 (시작→중간→끝)
- 장면별 상세 (Part 단위: 분량, 분위기, 대화 주제)
@@ -175,25 +179,70 @@
**워크플로우:**
```
상세 설계 → 타임라인 검증 → 감정선 설계 → 장면별 상세 → 커밋
vol-XX-plot.md 확인 → 상세 설계 → 타임라인 검증 → 일치성 검증 → 커밋
```
**최근 변경 (v2.0.0 - Major Update):**
- 📌 상세 설계 템플릿 (프로그래밍 설계서 수준)
- 📌 감정선 설계 추가 (예술성 향상)
- 📌 장면별 Part 단위 상세화
- 철학: 설계가 완벽하면 구현도 완벽 (프로그래밍처럼)
- 예상 효과: 플롯 불일치 80% 감소, 90% 품질 달성 확률 증가
**최근 변경 (v2.2.0):**
- 📌 vol-XX-plot.md 참조 강제화 (각 화 작성 전 필수)
- 📌 vol-XX-plot.md 일치성 검증 추가 (5화 완성 후)
- 철학: 설계도(vol-XX-plot.md) 없이 구현 불가!
- 예상 효과: 플롯 불일치 90% 감소 (10-20건 → 0-2건)
---
### 9. DESIGN-VERIFICATION 모드 ✅ ⭐ NEW
**파일:** `design-verification-mode.md`
**버전:** v1.1.0
**최종 수정:** 2026-01-27
**용도:** Phase 5 설계 검증 - 계층적 반영 검증 (설계 완료 후 최종 검증)
**주요 기능:**
- Phase 5-1: Opus 품질 검증 (간소화)
- 체크리스트 기반 주관적 평가
- 재미, 감정선, 페이싱 평가
- Phase 5-2: Codex 일관성 검증 (상세 프로토콜) ⭐ 핵심
- 계층적 반영 검증 (3단계)
* Step 1: 마스터 → vol-XX-plot.md 반영 검증
* Step 2: vol-XX-plot.md → vol-XX-plot-NNN-MMM.md 반영 검증
* Step 3: 전체 계층 일관성 확인
- 타임라인 일관성 검증
- 설정 충돌 검증
- 복선 검증
- 논리 검증
- 검증 보고서 템플릿 제공
**워크플로우:**
```
Phase 5-1 (Opus 품질) → Phase 5-2 (Codex 일관성) → 검증 보고서 → 통과/수정 판정
```
**철학:**
```
마스터 파일 (settings/)
↓ 반영 검증
권별 플롯 (vol-XX-plot.md)
↓ 반영 검증
5화별 상세 플롯 (vol-XX-plot-NNN-MMM.md)
→ 계층적 반영이 완벽하면 작성도 완벽!
→ Phase 5 = 설계 단계 최후의 보루
```
**예상 효과:**
- 설계 단계 충돌: 검증 단계에서 100% 발견
- 작성 단계 문제: 80% 감소 (설계가 완벽하므로)
- 설계 품질: 대폭 향상
---
## 📝 작성 모드
### 9. WRITING 모드 ✍️
### 10. WRITING 모드 ✍️
**파일:** `writing-mode.md`
**버전:** v2.6.0
**최종 수정:** 2026-01-25
**버전:** v2.7.0
**최종 수정:** 2026-01-27
**용도:** 새로운 챕터 작성 가이드 (형식 자동화 + 내용 검증 체크리스트)
**주요 기능:**
@@ -225,7 +274,7 @@ Phase 5~8: 커밋
- 철학: WRITING = 형식 오류 0건 + 내용 오류 최소화
- 예상 효과: VERIFICATION 발견 건수 65% 감소 (48-68건 → 19-23건)
- 이번 화 등장인물 확인
- characters.md 호칭 테이블 확인
- vol-XX-characters.md 호칭 테이블 확인
- 복수/단수 규칙 확인
- 📌 간이 검증 강화 (Git 커밋 전 필수)
- 호칭 복수/단수 자동 체크
@@ -237,7 +286,7 @@ Phase 5~8: 커밋
## 🎨 예술성 향상
### 10. ARTISTIC-REVIEW 모드 ⭐ NEW
### 11. ARTISTIC-REVIEW 모드 ⭐ NEW
**파일:** `artistic-review-mode.md`
**버전:** v1.0.0
@@ -284,7 +333,7 @@ Sonnet 작성 (기술 95%)
---
### 11. MODIFICATION 모드 🔨
### 12. MODIFICATION 모드 🔨
**파일:** `modification-mode.md`
**용도:** 기존 내용 수정 (플롯/캐릭터/장면)
@@ -297,21 +346,28 @@ Sonnet 작성 (기술 95%)
---
### 11. RETOUCH 모드 🎨
### 13. RETOUCH 모드 🎨
**파일:** `retouch-mode.md`
**용도:** 세밀한 문장 수정
**용도:** 퇴고 - 문체/리듬/표현 개선 (POLISH보다 깊은 수준, MODIFICATION보다 가벼운 수준)
**POLISH vs RETOUCH vs MODIFICATION 구분:**
```
POLISH: 문장 다듬기 (의미 동일, 표현만 변경)
RETOUCH: 퇴고 (문체/리듬 개선, 미세한 의미 조정 가능)
MODIFICATION: 내용 수정 (플롯/캐릭터/장면 변경)
```
---
### 12. Creative Writing 가이드 📖
### 14. Creative Writing 가이드 📖
**파일:** `creative-writing.md`
**용도:** 창작 기법 및 문체 가이드
---
### 13. Writing Guide 총람 📚
### 15. Writing Guide 총람 📚
**파일:** `writing-guide.md`
**용도:** 전체 작문 가이드 통합 문서
@@ -323,39 +379,74 @@ Sonnet 작성 (기술 95%)
### 전체 흐름
```
0. PLOT 모드 (설계 단계) ⭐ NEW
→ 플롯 작성 및 타임라인 검증
→ 설계 단계에서 타임라인 역행 차단
1. WRITING 모드 (작성 단계)
→ 새 챕터 작성
→ 작성 전 타임라인 체크포인트
2. VERIFICATION 모드 (필수)
→ 검증 및 문제 발견
→ 검증 보고서 생성
3. FIX 모드 (필수 - 문제 발견 시)
→ 문제 일괄 수정
→ 재배치, 형식 수정 등
4. RE-VERIFICATION (자동)
→ FIX 후 재검증
→ 문제 0건 확인
5. POLISH 모드 (선택)
→ 문장 품질 다듬기
→ 가독성 최적화
6. 완료!
┌─────────────────────────────────────────────────────────┐
│ 설계 단계 (CWS Design Guide) │
├─────────────────────────────────────────────────────────┤
│ 0-1. PLOT-MASTER 모드 (Phase 4-1) │
│ → 마스터 플롯 작성 (plot-master.md) │
│ │
│ 0-2. TIMELINE/CHARACTERS 모드 (Phase 4-2 선행) │
│ → vol-XX-timeline.md + vol-XX-characters.md 작성 │
│ → 병렬 작성 가능, 둘 다 검증 통과 필수 │
│ │
│ 0-3. VOLUME-PLOT 모드 (Phase 4-2) │
│ → 권별 플롯 작성 (vol-XX-plot.md) │
│ ⚠️ 필수 입력: timeline + characters │
│ │
│ 0-4. PLOT 모드 (Phase 4-3) │
│ → 5화별 상세 플롯 작성 │
│ → vol-XX-plot.md 확인 필수 │
│ → 타임라인 검증 + 일치성 검증 │
│ │
│ 0-5. DESIGN-VERIFICATION 모드 (Phase 5) │
│ → Phase 5-1: Opus 품질 검증 │
│ → Phase 5-2: Codex 일관성 검증 (계층적 반영) │
│ → 핸드오프 체크리스트 → Writing Guide 진입 │
└─────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ 작성 단계 (CWS Writing Guide) │
├─────────────────────────────────────────────────────────┤
│ 1. WRITING 모드 │
│ → 새 챕터 작성 │
│ → 작성 전 타임라인 체크포인트 │
│ │
│ 2. VERIFICATION 모드 (필수) │
│ → 검증 및 문제 발견 │
│ → 검증 보고서 생성 │
│ │
│ 3. FIX 모드 (필수 - 문제 발견 시) │
│ → 문제 일괄 수정 │
│ → 재배치, 형식 수정 등 │
│ │
│ 4. RE-VERIFICATION (자동) │
│ → FIX 후 재검증 │
│ → 문제 0건 확인 │
│ │
│ 5. POLISH 모드 (선택) │
│ → 문장 품질 다듬기 │
│ → 가독성 최적화 │
│ │
│ 6. 완료! │
└─────────────────────────────────────────────────────────┘
```
### 3단계 방어선 (v1.0.0+)
### 3단계 방어선 (v1.0.0+ / v2.2.0 강화)
```
🛡️ 1차 방어선: PLOT 모드 (설계)
🛡️ 0차 방어선: PLOT-MASTER → TIMELINE/CHARACTERS → VOLUME-PLOT (설계 기반)
→ 마스터 플롯 → 타임라인+캐릭터 → 권별 플롯
→ 각 단계 검증 프로토콜 통과 필수
🛡️ 1차 방어선: PLOT 모드 (Phase 4-3 상세 설계)
→ vol-XX-plot.md 확인 필수
→ 플롯 타임라인 검증
→ 설계 오류 차단
→ vol-XX-plot.md 일치성 검증
🛡️ 1.5차 방어선: DESIGN-VERIFICATION (Phase 5 설계 검증)
→ 계층적 반영 검증 (마스터 → 권별 → 5화별)
→ 타임라인/설정/복선/논리 검증
→ 핸드오프 체크리스트 통과 필수
🛡️ 2차 방어선: WRITING 모드 (예방)
→ 작성 전 타임라인 체크포인트
@@ -379,20 +470,35 @@ Sonnet 작성 (기술 95%)
## 📊 버전 관리
### 최신 버전 (2026-01-25)
### 최신 버전 (2026-01-27)
| 프로토콜 | 버전 | 주요 변경 |
|----------|------|-----------|
| PLOT | v1.0.0 | 플롯 타임라인 검증 (설계 단계 품질 보증) |
| WRITING | v2.5.0 | 호칭 규칙 + 타임라인 필수 체크포인트, 간이 검증 강화 |
| VERIFICATION | v2.9.0 | 리포트 유효성 검증 |
| **설계 단계 (Phase 4)** | | **아키텍처: phase4-master-design.md** |
| PLOT-MASTER | v3.1.0 | 마스터 플롯 작성 (Phase 4-1) |
| VOLUME-TIMELINE | v1.1.0 | 권별 타임라인 작성 (Phase 4-2 선행) |
| VOLUME-CHARACTERS | v1.1.0 | 권별 캐릭터 시트 작성 (Phase 4-2 선행) |
| VOLUME-PLOT | v3.1.0 | 권별 플롯 작성 (Phase 4-2) |
| PLOT | v3.1.0 ⭐ | 5화별 상세 플롯 작성 (Phase 4-3) |
| **설계 검증 (Phase 5)** |
| DESIGN-VERIFICATION | v1.1.0 ⭐ | Phase 5 검증 - 계층적 반영 검증 |
| **작성 단계** |
| WRITING | v2.7.0 | 호칭 규칙 + 형식 자동 검증 + 내용 검증 |
| VERIFICATION | v3.1.0 | 리포트 유효성 검증 + INPUT/PROCESS/OUTPUT 구조 |
| FIX | v2.0.0 | 재배치 프로토콜, 롤백 메커니즘 |
| POLISH | v2.4.0 | 리포트 유효성 검증 |
| Report Management | v1.0.0 | 초기 버전 |
| MODIFICATION | v2.2.0 | 챕터 수정/재구성 (영향 범위 분석) |
| **지원** |
| RETOUCH | v1.0.0 | 퇴고 (문체/리듬 개선) |
| ARTISTIC-REVIEW | v1.0.0 | 문학적 품질 심사 |
| Report Management | v1.0.0 | 리포트 관리 |
| Renaming Protocol | v2.0.0 | 리네임 안전 절차 |
### 호환성
모든 프로토콜은 **CWS Writing Guide v4.2.0+**와 호환됩니다.
모든 프로토콜은 **CWS Writing Guide v4.3.0+**, **CWS Design Guide v1.6.0+**와 호환됩니다.
> **v1.6.0 핵심 변경:** 산출물 파일명에 vol-XX 접두사 적용 (vol-XX-plot.md, vol-XX-timeline.md 등)
---
@@ -443,6 +549,13 @@ PATCH: 버그 수정, 문서 개선
- `/volumes/vol-XX/` - 각 권 챕터 및 메타데이터
- `/settings/` - 캐릭터, 세계관 설정
- `/standards/` - 이 디렉토리 (프로토콜)
- **`WORK-MODE.txt`** - 현재 작업 모드 추적 (프로젝트 루트)
- **`claude.md`** - 프로젝트별 Claude 작업 규칙
### 템플릿 파일
- `../WORK-MODE.txt.template` - 작업 모드 추적 템플릿
- `../CURRENT-TASK.md.template` - 현재 작업 상태 템플릿
- `../chapter-template.md` - 챕터 템플릿
### 외부 참조
- Git Repository: [novel-writing-guide](https://git.digien25.co.kr/Alex/novel-writing-guide)
@@ -454,20 +567,56 @@ PATCH: 버그 수정, 문서 개선
### 처음 사용하는 경우
#### 프로젝트 초기 설정 🔴 NEW
1. **WORK-MODE.txt 생성**
```bash
# 템플릿 복사
cp Guide/templates/WORK-MODE.txt.template 프로젝트/WORK-MODE.txt
# 초기 상태로 설정
---
CURRENT_MODE: NONE
READ_FILE: none
---
TASK: 대기 중
STATUS: READY
CREATED: YYYY-MM-DD
---
```
2. **claude.md 생성**
- 프로젝트별 작업 규칙 정의
- 모드 진입 자동 준비 프로토콜 포함
- WORK-MODE.txt 자동 읽기 규칙 포함
#### 신규 작품 시작
1. **PLOT 모드로 시작**
- `plot-mode.md` 읽기
- 플롯 작성 및 타임라인 검증
- 설계 단계에서 품질 확보
**설계 단계 (CWS Design Guide):**
2. **WRITING 모드로 작성**
1. **PLOT 모드로 플롯 작성** (Phase 4-3)
- `plot-mode.md` v2.2.0 읽기
- vol-XX-plot.md 확인하며 5화별 상세 플롯 작성 ⭐
- 타임라인 검증 + 일치성 검증
- WORK-MODE.txt 자동 업데이트
2. **DESIGN-VERIFICATION 모드로 설계 검증** (Phase 5) ⭐ NEW
- `design-verification-mode.md` v1.0.0 읽기
- Phase 5-1: Opus 품질 검증
- Phase 5-2: Codex 일관성 검증 (계층적 반영)
- 설계 완벽성 보증
**작성 단계 (CWS Writing Guide):**
3. **WRITING 모드로 작성**
- `writing-mode.md` 읽기
- 플롯 기반 챕터 작성
- WORK-MODE.txt 자동 업데이트
3. **VERIFICATION 모드로 검증**
4. **VERIFICATION 모드로 검증**
- `verification-mode.md` 읽기
- 전체 검증 실행
- WORK-MODE.txt 자동 업데이트
#### 기존 작품 검증
@@ -489,8 +638,26 @@ PATCH: 버그 수정, 문서 개선
### 자주 묻는 질문
**Q: WORK-MODE.txt는 무엇인가요?** 🔴 NEW
A: 현재 작업 모드를 추적하는 파일입니다. 컴팩트 후 Claude가 자동으로 읽어 현재 모드(PLOT/WRITING/VERIFICATION 등)를 파악하고 해당 프로토콜을 자동으로 읽습니다. `WORK-MODE.txt.template` 참조.
**Q: 컴팩트 후 Claude가 절차를 잊어버리는데요?** 🔴 NEW
A: claude.md에 "컴팩트 후 자동 복구 절차"를 추가하세요. Claude가 claude.md → WORK-MODE.txt → 현재 모드 프로토콜을 자동으로 읽도록 강제합니다. 1945-novel/claude.md 참조.
**Q: 모드 진입 시 Claude가 준비 없이 바로 작업을 시작하는데요?** 🔴 NEW
A: claude.md에 "모드 진입 자동 준비 프로토콜"을 추가하세요. 모든 작업 요청 시 자동으로 프로토콜을 읽고 준비 완료 보고 후 대기하도록 강제합니다.
**Q: 설계 검증은 어떻게 하나요?** ⭐ NEW
A: DESIGN-VERIFICATION 모드(Phase 5)를 사용하세요. Phase 5-1은 Opus 품질 검증, Phase 5-2는 Codex 일관성 검증(계층적 반영 검증)입니다. 설계 완료 후 반드시 실행하여 작성 단계 문제를 80% 감소시킬 수 있습니다. `design-verification-mode.md` 참조.
**Q: vol-XX-plot.md와 vol-XX-plot-NNN-MMM.md가 다른데요?** ⭐ NEW
A: PLOT 모드 v2.2.0을 사용하세요. 각 화 작성 전 vol-XX-plot.md를 확인하고, 5화 완성 후 일치성 검증을 실행합니다. Phase 5-2 계층적 반영 검증에서도 재확인합니다. `plot-mode.md`, `design-verification-mode.md` 참조.
**Q: DESIGN-VERIFICATION과 VERIFICATION의 차이는?**
A: **DESIGN-VERIFICATION (Phase 5)**은 설계 단계 검증입니다. 플롯 계층 반영, 설정 충돌, 복선 등을 검증합니다. **VERIFICATION**은 작성 단계 검증입니다. 챕터 형식, 호칭, 타임라인 등 실제 집필 결과물을 검증합니다. 서로 다른 가이드(Design Guide / Writing Guide)에 속합니다.
**Q: 플롯에 타임라인 역행이 있으면 어떻게 하나요?**
A: PLOT 모드로 플롯 타임라인을 검증하고 수정하세요. 설계 단계에서 오류를 차단하는 것이 가장 효율적입니다. `plot-mode.md` 참조.
A: PLOT 모드로 플롯 타임라인을 검증하고 수정하세요. 설계 단계에서 오류를 차단하는 것이 가장 효율적입니다. Phase 5-2에서도 재검증합니다. `plot-mode.md` 참조.
**Q: 회상 장면은 어떻게 처리하나요?**
A: 플롯 제목에 `[회상]`을 명시하세요. PLOT/WRITING/VERIFICATION 모드에서 자동으로 인식하여 타임라인 역행 검증에서 제외합니다. `plot-mode.md` 참조.
@@ -514,4 +681,12 @@ A: POLISH는 의미 동일하게 문장만 다듬기, MODIFICATION은 내용/플
*이 인덱스는 자동 업데이트되지 않습니다. 새 프로토콜 추가 시 수동으로 업데이트하세요.*
**최종 업데이트:** 2026-01-25
**최종 업데이트:** 2026-01-27
**v4.3.0 주요 변경 (2026-01-26):**
- 🔴 DESIGN-VERIFICATION 모드 추가 (Phase 5 검증 프로토콜)
- 🔴 PLOT 모드 v2.2.0 (vol-XX-plot.md 참조 및 일치성 검증 강화)
- 🔴 계층적 반영 검증 체계 (마스터 → 권별 → 5화별)
- 🔴 설계 품질 보증 체계 완성 (Phase 4-3 + Phase 5-2)
- 🔴 WORK-MODE.txt 템플릿 추가 (작업 모드 추적)
- 🔴 claude.md 모범 사례 추가 (모드 진입 자동 준비)