# Novel Writing Guide

> **버전:** 4.2
> **최종 수정:** 2026-01-25
> **용도:** AI 협업 장편 소설 작성 시스템
> **주요 변경:** PLOT 모드 추가 - 설계 단계 타임라인 검증

---

## 📚 이 저장소는

AI(Claude)와 협업하여 **장편 소설**(10권 이상)을 체계적으로 작성하기 위한 **공통 가이드 및 템플릿 모음**입니다.

각 소설 프로젝트는 독립적인 Git 저장소로 관리되며, 이 Guide 저장소의 표준과 템플릿을 참조하여 구축됩니다.

---

## 📐 문서 구조 (v4.2 명확화)

### 1. **CWS Design Guide.md** - 설계 단계
**용도:** 아이디어 → 플롯 완성까지 (작성 전 단계)

```
Phase 0: 아이디어/컨셉
Phase 0.5: 작가 문체 정의
Phase 1: 세계관 설계
Phase 2: 캐릭터 설계
Phase 3: 타임라인 설계
Phase 4: 플롯 설계 + 타임라인 검증 ⭐ v1.2 신규
Phase 5: 설계 검증

Output: 검증된 설정 파일들 (settings/)
```

**버전:** v1.2.0 (2026-01-25)
**주요 기능:** 플롯 타임라인 검증 프로토콜 (설계 단계 품질 보증)

---

### 2. **CWS Writing Guide.md** - 작성/검증/수정 단계
**용도:** 플롯 기반 챕터 작성 및 품질 관리

```
PLOT 모드: 플롯 타임라인 검증 ⭐ v4.2 신규
WRITING 모드: 챕터 작성 (타임라인 체크)
VERIFICATION 모드: 전체 검증
FIX 모드: 문제 수정 (재배치 포함)
POLISH 모드: 문장 다듬기

3단계 방어선:
🛡️ PLOT = 설계 오류 차단
🛡️ WRITING = 작성 시 예방
🛡️ VERIFICATION = 최후의 보루
```

**버전:** v4.2.0 (2026-01-25)
**주요 기능:** PLOT 모드 통합, 타임라인 역행 3단계 방어

---

### 3. **templates/standards/** - 개별 모드 프로토콜
**용도:** 각 모드의 상세 절차 및 체크리스트

```
plot-mode.md ⭐ v1.0.0 신규
writing-mode.md v2.4.0
verification-mode.md v2.9.0
fix-mode.md v2.0.0
polish-mode.md v2.4.0
report-management.md v1.0.0
+ 기타 지원 프로토콜
```

**참조:** `templates/standards/README.md` (프로토콜 인덱스)

---

### 4. **README.md (이 문서)** - 메인 인덱스
**용도:** 전체 CWS 시스템 개요 및 시작 가이드

---

## 📖 주요 문서 (Legacy)

### **Novel Writing Project Guide.md**
메인 가이드 문서입니다.

**포함 내용:**
- 전체 워크플로우 (Phase 1~6)
- 파일 구조 및 명명 규칙
- 토큰 효율 관리 전략
- 5화 단위 작성 시스템
- 누적 서머리 시스템
- Git 자동화
- **v3.0 모드 시스템:**
  - WRITING: 신규 작성 모드
  - MODIFICATION: 기존 수정 모드
  - VERIFICATION: 전체 점검 모드
  - DISCUSSION: 협의/논의 모드

### **validation-standards.md** (v3.1 신규)
검증 모드 전용 가이드 문서입니다.

**포함 내용:**
- **3가지 검증 모드:**
  - 본문 검증: 챕터 자체 완결성 확인
  - 플롯 검증: 플롯과 본문 일치성 확인
  - 요약본 검증: 2종 요약본 크로스체크
- **배치 검증 시스템:**
  - 10개씩 6개 배치로 나눠 검증
  - 각 배치마다 검증 요약본 생성
  - 컴팩팅 대응 프로토콜
- **검증 요약본 형식:**
  - 챕터별 상세 정보
  - 제목-내용 일치 확인
  - 타임라인 검증
  - 캐릭터 일관성 체크
- **검증 보고서 템플릿:**
  - 본문 검증 보고서
  - 플롯 검증 보고서
  - 요약본 검증 보고서

---

## 📁 템플릿 폴더 (templates/)

새 소설 프로젝트 시작 시 복사해서 사용하는 템플릿 파일들입니다.

### 제공 템플릿:
- **CLAUDE.md.template**: AI 협업 프로토콜 템플릿
- **chapter-template.md**: 챕터 파일 기본 형식
- **project-structure.md**: 프로젝트 폴더 구조 가이드

---

## 🚀 새 프로젝트 시작하기

### 1. 이 가이드 읽기
```
L:\내 드라이브\Writing\Guide\Novel Writing Project Guide.md
```
전체 워크플로우와 시스템을 이해합니다.

### 2. 프로젝트 폴더 생성
```bash
cd "L:\내 드라이브\Writing"
mkdir my-novel-project
cd my-novel-project
```

### 3. 템플릿 복사 (필수!)
```bash
# ⭐ claude.md (필수!) - Claude 작업 규칙
cp ../Guide/templates/claude.md.template ./claude.md

# 프로젝트 구조 참고용
cp ../Guide/templates/project-structure.md ./docs/

# CLAUDE.md (선택, deprecated)
cp ../Guide/templates/CLAUDE.md.template ./CLAUDE.md
```

**⚠️ 중요:**
- `claude.md`는 **반드시** 생성해야 함!
- Claude가 표준 파일을 Guide에서 읽도록 강제
- standards 파일들은 프로젝트에 복사하지 않음!

### 4. claude.md 수정
```markdown
# Claude 작업 규칙 (my-novel-project)  ← 프로젝트명 수정

...

## 📌 프로젝트별 설정

### 이 프로젝트만의 특별한 규칙

- 특정 캐릭터 호칭 규칙
- 고유 용어 사전
- 시대 배경 설정
```

### 5. 프로젝트 설정
AI와 함께 "큰 틀 정하자" 명령으로 설계 시작:
- Phase 1: 설계 (마스터 파일 생성)
- Phase 2: 권별 플롯 작성
- Phase 3: 실행 준비 (자동화)
- Phase 4: 작성 시작

---

## 🎯 핵심 컨셉

### 1. **Single Source of Truth (v4.0 신규)**
- **표준 파일 위치**: `Guide/templates/standards/` (유일한 소스)
- **프로젝트 규칙**: `claude.md`로 표준 위치 명시 (필수!)
- **금지**: 프로젝트별/권별 standards 복사 ❌
- **목적**: 버전 불일치 원천 차단, 기준 통일

### 2. **설계와 실행의 분리**
- **마스터 파일**: 전체 10권 통합 설계 (크고 무거움, 작성 시 읽지 않음)
- **작업 파일**: 필요한 부분만 추출 (작고 가벼움, 매 세션 읽음)

### 2. **토큰 효율 최우선**
- 한글 1글자 ≈ 1.5 토큰
- 권별 작업 파일로 토큰 13,000 이하 유지
- 작성 여유 토큰 187,000 확보

### 3. **5화 = 1작업 단위**
- plot-001-005.md (5화 플롯)
- "1~5화 작성해" 1번 명령
- summary-001-005.md (5화 결과)

### 4. **누적 서머리로 일관성 유지**
- summary-001-005.md
- summary-001-010.md (1-10화 전체 누적!)
- summary-001-050.md (1권 전체!)
- summary-vol-01-final.md (압축, 다음 권용)

### 5. **모드 기반 워크플로우 (v3.0)**
- **WORK-MODE.txt**로 현재 작업 모드 명시
- 컴팩팅 후에도 맥락 유지
- 수정 시 Summary 재생성 강제화
- 타임라인 검증 자동화

---

## 📐 파일 구조 예시

```
my-novel-project/
│
├── claude.md                    # ⭐ Claude 작업 규칙 (필수!)
├── CLAUDE.md                    # AI 협업 프로토콜 (선택)
├── README.md
├── CHANGELOG.md
│
├── settings/                    # 마스터 파일 (설계용)
│   ├── characters-master.md
│   ├── timeline-master.md
│   ├── plot-master.md
│   └── writing-guide.md
│
│   # ⚠️ standards 파일들은 Guide/templates/standards/에서 읽기!
│   # 프로젝트별로 복사하지 않음!
│
├── volumes/                     # 권별 폴더
│   ├── vol-01/
│   │   ├── CHANGELOG.md              # v3.0
│   │   ├── WORK-MODE.txt             # v3.0 (임시)
│   │   ├── plot-master.md
│   │   ├── characters.md
│   │   ├── timeline.md
│   │   ├── plots/
│   │   │   ├── plot-001-005.md
│   │   │   └── ...
│   │   ├── summaries/
│   │   │   ├── summary-001-005.md
│   │   │   ├── summary-001-010.md
│   │   │   └── ...
│   │   └── chapters/
│   │       ├── ch-001.md
│   │       └── ...
│   └── vol-02/
│       └── (동일 구조)
│
└── .git/
```

---

## 🔧 v3.0 주요 개선

### 문제 해결
**이전 문제:**
- 컴팩팅 → 맥락 손실 → 수정이 이상한 방향으로
- Summary 누락 → 플롯/본문/서머리 불일치
- 리네임 시 파일 손실 위험
- 변경 이력 추적 불가

**v3.0 해결:**
- `WORK-MODE.txt` → 모드 명시 → 맥락 유지
- `modification-mode.md` → Summary 재생성 강제
- `renaming-protocol.md` → 안전한 2단계 리네임
- `CHANGELOG.md` → 변경 이력 추적

### 모드별 워크플로우

**작성 모드:**
```
"1~5화 작성해" → 작성 → summary 누적 → Git
```

**수정 모드:**
```
"수정 준비해" → 계획서 → WORK-MODE.txt 생성
→ [컴팩팅]
→ "수정 실행" → 수정 → summary 재생성 → 검증 → CHANGELOG → Git
```

**점검 모드:**
```
"점검해" → 전수 검사 → 보고서 작성 → Git
```

---

## 📊 적용 예시

### 실제 프로젝트
- **1945-novel**: "1945, 다시 시작된 역사" (대체역사 소설, 10권)
  - 위치: `L:\내 드라이브\Writing\1945-novel\`
  - 상태: 2권 작성 중 (65화)
  - v3.0 시스템 적용 완료

---

## 🔗 참고 링크

### Git 저장소 (Gitea)
- **서버**: git.digien25.co.kr
- **사용자**: Alex
- **프로젝트 예시**:
  - `https://git.digien25.co.kr/Alex/1945-novel.git`
  - `https://git.digien25.co.kr/Alex/novel-writing-guide.git`

### 백업 전략
- **Google Drive**: 실시간 클라우드 동기화
- **Git + Gitea**: 버전 관리 및 원격 백업
- **이중 백업**: 최대 안정성 확보

---

## 📝 버전 히스토리

### v4.2 (2026-01-25)
- ✅ **PLOT 모드 추가 - 설계 단계 타임라인 검증**
- ✅ `templates/standards/plot-mode.md` v1.0.0 추가
- ✅ CWS Design Guide v1.2.0 업데이트
  - Phase 4 (플롯 설계)에 타임라인 검증 프로토콜 추가
  - Phase 5 (설계 검증)에 플롯 타임라인 검증 추가
- ✅ CWS Writing Guide v4.2.0 업데이트 (예정)
  - PLOT 모드 통합
- ✅ writing-mode.md v2.4.0: 타임라인 역행 방지 체크포인트
- ✅ verification-mode.md v2.9.0: 리포트 유효성 검증
- ✅ fix-mode.md v2.0.0: 재배치 프로토콜
- ✅ report-management.md v1.0.0: 리포트 관리
- ✅ **3단계 방어선 체계 확립**
  - 1차: PLOT (설계 단계)
  - 2차: WRITING (작성 단계)
  - 3차: VERIFICATION (검증 단계)
- ✅ 문서 구조 및 역할 명확화

### v4.0 (2026-01-23)
- ✅ **Single Source of Truth 시스템 확립**
- ✅ `claude.md` 파일 도입 (프로젝트별 필수)
- ✅ `templates/claude.md.template` 추가
- ✅ standards 파일 Guide 중앙 관리 (복사 금지)
- ✅ 프로젝트/권별 standards 생성 금지
- ✅ 버전 불일치 원천 차단

### v3.1 (2026-01-17)
- ✅ **validation-standards.md 추가** (검증 모드 전용 가이드)
- ✅ 배치 검증 시스템 (10개씩 분할, 컴팩팅 대응)
- ✅ 검증 요약본 시스템 (validation-batch-XX.md)
- ✅ 2종 요약본 크로스체크 (작성 요약본 vs 검증 요약본)
- ✅ 검증 보고서 템플릿 3종

### v3.0 (2026-01-17)
- ✅ 모드 시스템 구축 (WRITING/MODIFICATION/VERIFICATION/DISCUSSION)
- ✅ 수정 프로토콜 체계화 (Summary 재생성 강제, 타임라인 검증)
- ✅ 챕터 형식 표준 문서화
- ✅ 안전한 리네임 절차
- ✅ WORK-MODE.txt 시스템 (컴팩팅 대응)
- ✅ CHANGELOG.md 도입

### v2.0 (2026-01-15)
- ✅ 완전 재작성
- ✅ 설계/실행 분리
- ✅ 토큰 효율 최우선
- ✅ 5화 작업 단위
- ✅ 누적 서머리
- ✅ Git 자동화

### v1.0 (2026-01-14)
- 초기 버전

---

## 🤝 기여

이 가이드는 Alex의 개인 프로젝트이지만, 개선 제안은 언제나 환영합니다.

---

## 📧 연락처

- **작성자**: Alex
- **이메일**: alex@digien25.co.kr

---

**마지막 업데이트**: 2026-01-23
**버전**: 4.0
**라이선스**: 개인 프로젝트