ae9b4a61fd
배경: - 문제: VERIFICATION에서 형식/내용 오류 다수 발견 (48-68건) - 원인 1: 형식 검증이 수동이라 깜빡하면 통과 (바텀, 작가의 말, 챕터 번호) - 원인 2: 내용 검증 프로세스 자체가 없음 (플롯 일치, 연결성, 설정) - 결과: VERIFICATION 부담 과다, FIX 모드 수정 비효율 추가: - Phase 3: 형식 자동 검증 스크립트 (Bash + PowerShell) - 바텀 3개 자동 카운트 (정확히 3개 강제) - 작가의 말 형식 자동 체크 (> [!NOTE] 필수) - 챕터 번호 일치 자동 검증 (파일명 vs 헤더) - 타임라인 형식 자동 검증 - Phase 4: 내용 검증 체크리스트 (신규) - 플롯 일치도 확인 (제목, 타임라인, 핵심 이벤트) - 이전 챕터 연결 확인 (시간/장소/상황 흐름) - 설정 일관성 확인 (숫자, 물리, 캐릭터) 예상 효과: - 형식 오류: 15건 → 0건 (100% 감소, 자동 검증) - 내용 오류: 35건 → 7건 (80% 감소, 체크리스트) - VERIFICATION 총 발견: 48-68건 → 19-23건 (65% 감소) 철학: ``` WRITING 모드 = 형식 오류 0건 + 내용 오류 최소화 VERIFICATION 모드 = 정말 최후 확인만 → 작성 단계에서 모든 문제 원천 차단! ``` 관련 파일: - writing-mode.md: v2.5.0 → v2.6.0 - README.md: 프로토콜 인덱스 업데이트 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
457 lines
11 KiB
Markdown
457 lines
11 KiB
Markdown
# CWS Writing Standards - 프로토콜 인덱스
|
|
|
|
> **최종 업데이트:** 2026-01-25
|
|
> **CWS Writing Guide 버전:** v4.2.0+
|
|
|
|
이 디렉토리는 Creative Writing System (CWS)의 표준 프로토콜을 담고 있습니다.
|
|
|
|
---
|
|
|
|
## 📚 코어 프로토콜 (검증 & 수정)
|
|
|
|
### 1. VERIFICATION 모드 ✅
|
|
|
|
**파일:** `verification-mode.md`
|
|
**버전:** v2.9.0
|
|
**최종 수정:** 2026-01-25
|
|
**용도:** 전체 검증 및 문제 발견 (수정하지 않음)
|
|
|
|
**주요 기능:**
|
|
- 6단계 통합 검증 (구조, 형식, 타임라인, 내용, 일관성, 보고서)
|
|
- 배치 검증 (10개 챕터씩)
|
|
- 통합 검증 (전체 권 구조 확인)
|
|
- 리포트 유효성 검증 ⭐ NEW (v2.9.0)
|
|
- 소설 특성 반영 (병렬 서사, 다중 시점)
|
|
|
|
**워크플로우:**
|
|
```
|
|
배치 1~N 검증 → 통합 검증 → FIX 모드 필수 진입
|
|
```
|
|
|
|
**최근 변경 (v2.9.0):**
|
|
- 리포트 유효성 검증 추가
|
|
- 파일 수정 시 리포트 자동 무효화
|
|
|
|
---
|
|
|
|
### 2. FIX 모드 🔧
|
|
|
|
**파일:** `fix-mode.md`
|
|
**버전:** v2.0.0
|
|
**최종 수정:** 2026-01-25
|
|
**용도:** 검증 보고서 기반 일괄 수정 (타임라인 역행 재배치 포함)
|
|
|
|
**주요 기능:**
|
|
- 심각도별 수정 (🔴 → 🟡 → 🟢)
|
|
- 챕터 재배치 프로토콜 ⭐ NEW (3-stage 안전 프로세스)
|
|
- 롤백 메커니즘 ⭐ NEW
|
|
- 리포트 유효성 검증 ⭐ NEW
|
|
- Git 워크플로우 명확화 ⭐ NEW
|
|
- 영향받는 배치 자동 무효화 ⭐ NEW
|
|
|
|
**워크플로우:**
|
|
```
|
|
리포트 체크 → 재배치 → 형식/호칭 수정 → 커밋 → 재검증(자동)
|
|
```
|
|
|
|
**최근 변경 (v2.0.0 - Major Update):**
|
|
- 챕터 재배치 프로토콜 추가
|
|
- 롤백 및 에러 복구 메커니즘
|
|
- Git 커밋 타이밍 명확화
|
|
|
|
---
|
|
|
|
### 3. POLISH 모드 ✨
|
|
|
|
**파일:** `polish-mode.md`
|
|
**버전:** v2.4.0
|
|
**최종 수정:** 2026-01-25
|
|
**용도:** 문장 품질 다듬기 (내용 수정 없음)
|
|
|
|
**주요 기능:**
|
|
- 문장 가독성 (길이, 문단)
|
|
- 반복 표현 제거
|
|
- 대화/묘사 비율
|
|
- 문체 일관성
|
|
- 플랫폼 가독성 (문피아 최적화)
|
|
- 리포트 유효성 검증 ⭐ NEW (v2.4.0)
|
|
|
|
**워크플로우:**
|
|
```
|
|
배치 검토 → 빈 줄 패턴 통일 → 문장 다듬기 → 커밋
|
|
```
|
|
|
|
**최근 변경 (v2.4.0):**
|
|
- 리포트 유효성 검증 추가
|
|
- MODIFICATION 경계 명확화 (v2.3.0)
|
|
|
|
---
|
|
|
|
## 🛠️ 지원 프로토콜
|
|
|
|
### 4. 리포트 관리 📋
|
|
|
|
**파일:** `report-management.md`
|
|
**버전:** v1.0.0
|
|
**최종 수정:** 2026-01-25
|
|
**용도:** 모든 검증/POLISH 리포트의 유효성 관리
|
|
|
|
**주요 기능:**
|
|
- 리포트 유효성 검증 로직
|
|
- 파일 수정 시간 vs 리포트 날짜 비교
|
|
- 무효화 조건 명확화
|
|
- 리포트 관리 Best Practices
|
|
|
|
**적용 범위:**
|
|
- VERIFICATION 모드 v2.9.0
|
|
- FIX 모드 v2.0.0
|
|
- POLISH 모드 v2.4.0
|
|
|
|
---
|
|
|
|
### 5. 챕터 포맷 📄
|
|
|
|
**파일:** `chapter-format.md`
|
|
**용도:** 챕터 파일 형식 표준
|
|
|
|
**주요 내용:**
|
|
- 헤더 형식: `# X권 Y화: 제목`
|
|
- 타임라인 형식: `> **타임라인:** YYYY.M.D-M.D`
|
|
- Part 구분 방법
|
|
- 바텀 금지 사항
|
|
|
|
---
|
|
|
|
### 6. 파일 포맷 📁
|
|
|
|
**파일:** `file-formats.md`
|
|
**용도:** 프로젝트 전체 파일 구조 및 명명 규칙
|
|
|
|
**주요 내용:**
|
|
- 디렉토리 구조
|
|
- 파일명 규칙 (ch-XXX.md)
|
|
- 메타데이터 파일 (plot-master.md, timeline.md 등)
|
|
|
|
---
|
|
|
|
### 7. 재명명 프로토콜 🔄
|
|
|
|
**파일:** `renaming-protocol.md`
|
|
**용도:** 챕터 번호 변경 시 안전 절차
|
|
|
|
**주요 내용:**
|
|
- 3-stage 프로세스
|
|
- temp 파일 사용
|
|
- 헤더 업데이트
|
|
- 검증 절차
|
|
|
|
---
|
|
|
|
## 🎨 설계 모드
|
|
|
|
### 8. PLOT 모드 📐
|
|
|
|
**파일:** `plot-mode.md`
|
|
**버전:** v1.0.0
|
|
**최종 수정:** 2026-01-25
|
|
**용도:** 플롯 작성 및 타임라인 검증 (설계 단계 품질 보증)
|
|
|
|
**주요 기능:**
|
|
- 플롯 작성 시 타임라인 검증
|
|
- 이전 화 종료일 ≤ 다음 화 시작일 강제 검증
|
|
- 전체 플롯 타임라인 일관성 체크
|
|
- 회상/병렬 서사 명시 규칙
|
|
- 플롯 형식 표준
|
|
|
|
**워크플로우:**
|
|
```
|
|
플롯 작성 → 각 화 타임라인 검증 → 전체 타임라인 검증 → 커밋
|
|
```
|
|
|
|
**최근 변경 (v1.0.0):**
|
|
- 📌 초기 버전 릴리즈
|
|
- 설계 단계 타임라인 역행 방지
|
|
- 철학: PLOT = 설계, WRITING = 예방, VERIFICATION = 최후의 보루
|
|
|
|
---
|
|
|
|
## 📝 작성 모드
|
|
|
|
### 9. WRITING 모드 ✍️
|
|
|
|
**파일:** `writing-mode.md`
|
|
**버전:** v2.6.0
|
|
**최종 수정:** 2026-01-25
|
|
**용도:** 새로운 챕터 작성 가이드 (형식 자동화 + 내용 검증 체크리스트)
|
|
|
|
**주요 기능:**
|
|
- 작성 프로세스 (3/5/7화 유연)
|
|
- 플롯 반영
|
|
- 호칭 규칙 필수 체크포인트 (v2.5.0)
|
|
- 타임라인 역행 방지 필수 체크포인트 (v2.4.0)
|
|
- 형식 자동 검증 ⭐ NEW (v2.6.0)
|
|
- 바텀 3개 자동 카운트
|
|
- 작가의 말 형식 자동 체크
|
|
- 챕터 번호 일치 자동 검증
|
|
- 내용 검증 체크리스트 ⭐ NEW (v2.6.0)
|
|
- 플롯 일치도 확인
|
|
- 이전 챕터 연결 확인
|
|
- 설정 일관성 확인
|
|
|
|
**워크플로우:**
|
|
```
|
|
Phase 1: 준비 (호칭 규칙 숙지)
|
|
Phase 2: 작성 (호칭 + 타임라인 체크포인트)
|
|
Phase 3: 형식 자동 검증 (Bash 스크립트)
|
|
Phase 4: 내용 검증 체크리스트
|
|
Phase 5~8: 커밋
|
|
```
|
|
|
|
**최근 변경 (v2.6.0):**
|
|
- 📌 형식 자동 검증 스크립트 추가 (바텀, 작가의 말, 챕터 번호)
|
|
- 📌 내용 검증 체크리스트 추가 (Phase 4 신규)
|
|
- 철학: WRITING = 형식 오류 0건 + 내용 오류 최소화
|
|
- 예상 효과: VERIFICATION 발견 건수 65% 감소 (48-68건 → 19-23건)
|
|
- 이번 화 등장인물 확인
|
|
- characters.md 호칭 테이블 확인
|
|
- 복수/단수 규칙 확인
|
|
- 📌 간이 검증 강화 (Git 커밋 전 필수)
|
|
- 호칭 복수/단수 자동 체크
|
|
- 시기별 호칭 정확성 체크
|
|
- 형식 자동 체크
|
|
- 철학: WRITING = 호칭 오류 원천 차단
|
|
|
|
---
|
|
|
|
### 10. MODIFICATION 모드 🔨
|
|
|
|
**파일:** `modification-mode.md`
|
|
**용도:** 기존 내용 수정 (플롯/캐릭터/장면)
|
|
|
|
**주요 내용:**
|
|
- POLISH와의 경계
|
|
- 플롯 변경 절차
|
|
- 캐릭터 관계 수정
|
|
- 장면 추가/삭제
|
|
|
|
---
|
|
|
|
### 11. RETOUCH 모드 🎨
|
|
|
|
**파일:** `retouch-mode.md`
|
|
**용도:** 세밀한 문장 수정
|
|
|
|
---
|
|
|
|
### 12. Creative Writing 가이드 📖
|
|
|
|
**파일:** `creative-writing.md`
|
|
**용도:** 창작 기법 및 문체 가이드
|
|
|
|
---
|
|
|
|
### 13. Writing Guide 총람 📚
|
|
|
|
**파일:** `writing-guide.md`
|
|
**용도:** 전체 작문 가이드 통합 문서
|
|
|
|
---
|
|
|
|
## 🔄 프로토콜 워크플로우
|
|
|
|
### 전체 흐름
|
|
|
|
```
|
|
0. PLOT 모드 (설계 단계) ⭐ NEW
|
|
→ 플롯 작성 및 타임라인 검증
|
|
→ 설계 단계에서 타임라인 역행 차단
|
|
|
|
1. WRITING 모드 (작성 단계)
|
|
→ 새 챕터 작성
|
|
→ 작성 전 타임라인 체크포인트
|
|
|
|
2. VERIFICATION 모드 (필수)
|
|
→ 검증 및 문제 발견
|
|
→ 검증 보고서 생성
|
|
|
|
3. FIX 모드 (필수 - 문제 발견 시)
|
|
→ 문제 일괄 수정
|
|
→ 재배치, 형식 수정 등
|
|
|
|
4. RE-VERIFICATION (자동)
|
|
→ FIX 후 재검증
|
|
→ 문제 0건 확인
|
|
|
|
5. POLISH 모드 (선택)
|
|
→ 문장 품질 다듬기
|
|
→ 가독성 최적화
|
|
|
|
6. 완료!
|
|
```
|
|
|
|
### 3단계 방어선 (v1.0.0+)
|
|
|
|
```
|
|
🛡️ 1차 방어선: PLOT 모드 (설계)
|
|
→ 플롯 타임라인 검증
|
|
→ 설계 오류 차단
|
|
|
|
🛡️ 2차 방어선: WRITING 모드 (예방)
|
|
→ 작성 전 타임라인 체크포인트
|
|
→ 역행 즉시 중단
|
|
|
|
🛡️ 3차 방어선: VERIFICATION 모드 (최후의 보루)
|
|
→ 전체 검증
|
|
→ 누락된 문제 발견
|
|
```
|
|
|
|
### 필수 워크플로우 (v2.8.0+)
|
|
|
|
```
|
|
⚠️ 강제 규칙:
|
|
- VERIFICATION에서 문제 발견 → FIX 필수
|
|
- FIX 완료 → RE-VERIFICATION 자동 실행
|
|
- 문제 0건 확인 전까지 다른 모드 전환 금지
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 버전 관리
|
|
|
|
### 최신 버전 (2026-01-25)
|
|
|
|
| 프로토콜 | 버전 | 주요 변경 |
|
|
|----------|------|-----------|
|
|
| PLOT | v1.0.0 | 플롯 타임라인 검증 (설계 단계 품질 보증) |
|
|
| WRITING | v2.5.0 | 호칭 규칙 + 타임라인 필수 체크포인트, 간이 검증 강화 |
|
|
| VERIFICATION | v2.9.0 | 리포트 유효성 검증 |
|
|
| FIX | v2.0.0 | 재배치 프로토콜, 롤백 메커니즘 |
|
|
| POLISH | v2.4.0 | 리포트 유효성 검증 |
|
|
| Report Management | v1.0.0 | 초기 버전 |
|
|
|
|
### 호환성
|
|
|
|
모든 프로토콜은 **CWS Writing Guide v4.2.0+**와 호환됩니다.
|
|
|
|
---
|
|
|
|
## 📋 CHANGELOG 정책
|
|
|
|
### 버전 넘버링
|
|
|
|
**Semantic Versioning:**
|
|
```
|
|
MAJOR.MINOR.PATCH
|
|
|
|
MAJOR: 하위 호환성 깨지는 변경
|
|
MINOR: 기능 추가 (하위 호환)
|
|
PATCH: 버그 수정, 문서 개선
|
|
```
|
|
|
|
**예시:**
|
|
- v2.9.0 → v3.0.0: 프로토콜 구조 대폭 변경
|
|
- v2.8.0 → v2.9.0: 리포트 검증 기능 추가
|
|
- v2.9.0 → v2.9.1: 오타 수정, 예시 추가
|
|
|
|
### 변경 이력 기록
|
|
|
|
**모든 프로토콜은 CHANGELOG 섹션 포함:**
|
|
```markdown
|
|
## 📋 CHANGELOG
|
|
|
|
### vX.Y.Z (YYYY-MM-DD)
|
|
|
|
**추가:**
|
|
- 새 기능 목록
|
|
|
|
**변경:**
|
|
- 기존 기능 수정
|
|
|
|
**삭제:**
|
|
- 제거된 기능
|
|
|
|
**수정:**
|
|
- 버그 수정
|
|
```
|
|
|
|
---
|
|
|
|
## 🔗 관련 문서
|
|
|
|
### 프로젝트 구조
|
|
- `/volumes/vol-XX/` - 각 권 챕터 및 메타데이터
|
|
- `/settings/` - 캐릭터, 세계관 설정
|
|
- `/standards/` - 이 디렉토리 (프로토콜)
|
|
|
|
### 외부 참조
|
|
- Git Repository: [novel-writing-guide](https://git.digien25.co.kr/Alex/novel-writing-guide)
|
|
- CWS Writing Guide v4.2.0
|
|
|
|
---
|
|
|
|
## 💡 사용 가이드
|
|
|
|
### 처음 사용하는 경우
|
|
|
|
#### 신규 작품 시작
|
|
|
|
1. **PLOT 모드로 시작**
|
|
- `plot-mode.md` 읽기
|
|
- 플롯 작성 및 타임라인 검증
|
|
- 설계 단계에서 품질 확보
|
|
|
|
2. **WRITING 모드로 작성**
|
|
- `writing-mode.md` 읽기
|
|
- 플롯 기반 챕터 작성
|
|
|
|
3. **VERIFICATION 모드로 검증**
|
|
- `verification-mode.md` 읽기
|
|
- 전체 검증 실행
|
|
|
|
#### 기존 작품 검증
|
|
|
|
1. **VERIFICATION 모드부터 시작**
|
|
- `verification-mode.md` 읽기
|
|
- 1권 전체 검증 실행
|
|
|
|
2. **문제 발견 시 FIX 모드**
|
|
- `fix-mode.md` 읽기
|
|
- 검증 보고서 기반 수정
|
|
|
|
3. **플롯 타임라인 역행 발견 시**
|
|
- `plot-mode.md` 읽기
|
|
- 플롯 타임라인 재검증 및 수정
|
|
|
|
4. **품질 개선은 POLISH 모드**
|
|
- `polish-mode.md` 읽기
|
|
- 문장 다듬기
|
|
|
|
### 자주 묻는 질문
|
|
|
|
**Q: 플롯에 타임라인 역행이 있으면 어떻게 하나요?**
|
|
A: PLOT 모드로 플롯 타임라인을 검증하고 수정하세요. 설계 단계에서 오류를 차단하는 것이 가장 효율적입니다. `plot-mode.md` 참조.
|
|
|
|
**Q: 회상 장면은 어떻게 처리하나요?**
|
|
A: 플롯 제목에 `[회상]`을 명시하세요. PLOT/WRITING/VERIFICATION 모드에서 자동으로 인식하여 타임라인 역행 검증에서 제외합니다. `plot-mode.md` 참조.
|
|
|
|
**Q: 리포트가 무효화되는 이유는?**
|
|
A: 리포트 작성 후 파일이 수정되면 리포트가 과거 상태를 반영하므로 재검증이 필요합니다. `report-management.md` 참조.
|
|
|
|
**Q: 재배치는 언제 하나요?**
|
|
A: 타임라인 역행 발견 시 FIX 모드에서 자동으로 실행됩니다. 하지만 PLOT 모드에서 미리 검증하면 재배치를 방지할 수 있습니다. `fix-mode.md` 참조.
|
|
|
|
**Q: POLISH와 MODIFICATION 차이는?**
|
|
A: POLISH는 의미 동일하게 문장만 다듬기, MODIFICATION은 내용/플롯 변경. `polish-mode.md` 참조.
|
|
|
|
---
|
|
|
|
## 📧 문의 및 기여
|
|
|
|
프로토콜 개선 제안은 Git Issues로 등록해주세요.
|
|
|
|
---
|
|
|
|
*이 인덱스는 자동 업데이트되지 않습니다. 새 프로토콜 추가 시 수동으로 업데이트하세요.*
|
|
|
|
**최종 업데이트:** 2026-01-25
|