4e6f61ef0c
배경:
- plot-mode.md v1.0.0 추가로 설계 단계 타임라인 검증 가능
- 하지만 CWS Design Guide에 반영되지 않음
- 문서 간 역할 (README, CWS Design, CWS Writing) 불명확
변경 사항:
1. CWS Design Guide.md v1.2.0 업데이트
- CHANGELOG 섹션 추가 (v1.0.0, v1.1.0, v1.2.0)
- Phase 4 (플롯 설계)에 타임라인 검증 프로토콜 추가
- 3단계 체크포인트 (각 화 작성 시)
- 전체 플롯 완성 후 검증
- [회상]/[병렬] 서사 명시 규칙
- Phase 4 완료 조건에 타임라인 검증 필수 추가
- Phase 5-2 일관성 검증에 플롯 타임라인 검증 추가
- plot-master.md 템플릿에 타임라인 검증 필드 추가
- 문서 역할 섹션 업데이트 (3단계 방어선 명시)
2. README.md v4.2 업데이트
- 문서 구조 섹션 신규 추가 (4개 문서 역할 명확화)
1. CWS Design Guide: 설계 단계
2. CWS Writing Guide: 작성/검증/수정 단계
3. templates/standards/: 개별 모드 프로토콜
4. README.md: 메인 인덱스
- 3단계 방어선 체계 명시
- PLOT = 설계 오류 차단
- WRITING = 작성 시 예방
- VERIFICATION = 최후의 보루
- v4.2 버전 히스토리 추가
- 최종 수정일 및 버전 업데이트
철학:
```
설계 단계 타임라인 검증 = 1차 방어선
작성 단계 타임라인 체크 = 2차 방어선
검증 단계 타임라인 검증 = 3차 방어선 (최후의 보루)
→ 설계가 올바르면 작성도 올바르다!
```
효과:
- 플롯 단계에서 타임라인 역행 원천 차단
- FIX 모드 재배치 작업 대폭 감소
- 문서 간 역할 명확화로 학습 곡선 개선
참조:
- templates/standards/plot-mode.md v1.0.0
- templates/standards/writing-mode.md v2.4.0
- templates/standards/verification-mode.md v2.9.0
- templates/standards/fix-mode.md v2.0.0
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
406 lines
11 KiB
Markdown
406 lines
11 KiB
Markdown
# 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
|
|
**라이선스**: 개인 프로젝트
|