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

v4.0: Single Source of Truth 시스템 확립

Browse Source 
- claude.md.template 추가 (프로젝트별 필수 파일)
- README.md v4.0: Single Source of Truth 핵심 컨셉 추가
- project-structure.md v4.0: claude.md 필수화, standards 제거
- standards 파일들은 Guide/templates/standards/에서만 관리
- 프로젝트별/권별 standards 복사 금지
- 버전 불일치 원천 차단

주요 변경사항:
1. 새 프로젝트 시작 시 claude.md 생성 필수
2. 모든 모드 진입 시 Guide/templates/standards/ 참조
3. 프로젝트 내 standards/ 디렉토리 생성 금지
4. volumes/vol-XX/validation-standards.md 생성 금지

이유: 표준 파일이 여러 곳에 복사되면 버전 불일치 발생
해결: Guide를 유일한 소스로 지정, claude.md로 강제

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Alex
2026-01-23 12:41:35 +09:00
parent 854ff7d1f5
commit 271c11d6fc
10 changed files with 1768 additions and 190 deletions
Download Patch File Download Diff File Expand all files Collapse all files

529
CWS Design Guide.md
View File

@@ -1,9 +1,11 @@
# Creative Writing System - Design Guide (v1.0)
# Creative Writing System - Design Guide (v1.1)
> **작성일:** 2026-01-18
> **버전:** 1.0.0
> **최종 수정:** 2026-01-21
> **버전:** 1.1.0
> **시스템:** Creative Writing System (CWS)
> **목적:** 창작 프로젝트의 설계 단계를 체계화하여, 작성 단계에서의 수정을 최소화
> **주요 변경 (v1.1):** Multi-작가 시스템 - 작가 문체 정의 기능 추가
---
@@ -49,13 +51,14 @@
1. [모델별 역할 분담](#1-모델별-역할-분담)
2. [설계 원칙](#2-설계-원칙)
3. [Phase 0: 아이디어 → 컨셉](#3-phase-0-아이디어--컨셉)
4. [Phase 1: 세계관 설계](#4-phase-1-세계관-설계)
5. [Phase 2: 캐릭터 설계](#5-phase-2-캐릭터-설계)
6. [Phase 3: 타임라인 설계](#6-phase-3-타임라인-설계)
7. [Phase 4: 플롯 설계](#7-phase-4-플롯-설계)
8. [Phase 5: 설계 검증](#8-phase-5-설계-검증)
9. [산출물 명세](#9-산출물-명세)
10. [Writing Guide로 핸드오프](#10-writing-guide로-핸드오프)
4. [Phase 0.5: 작가 문체 정의](#4-phase-05-작가-문체-정의) ⭐ **v1.1 신규**
5. [Phase 1: 세계관 설계](#5-phase-1-세계관-설계)
6. [Phase 2: 캐릭터 설계](#6-phase-2-캐릭터-설계)
7. [Phase 3: 타임라인 설계](#7-phase-3-타임라인-설계)
8. [Phase 4: 플롯 설계](#8-phase-4-플롯-설계)
9. [Phase 5: 설계 검증](#9-phase-5-설계-검증)
10. [산출물 명세](#10-산출물-명세)
11. [Writing Guide로 핸드오프](#11-writing-guide로-핸드오프)
---
@@ -73,6 +76,7 @@
```
Phase 0: 아이디어/컨셉 → Opus (창의성, 깊이)
Phase 0.5: 작가 문체 정의 → Sonnet (분석, 패턴 추출) ⭐ v1.1 신규
Phase 1: 세계관 설계 → Sonnet (체계적 정리)
Phase 2: 캐릭터 설계 → Opus (심리, 관계, 감정)
Phase 3: 타임라인 설계 → Sonnet (정확성, 구조)
@@ -251,7 +255,430 @@ Phase 0 완료 조건:
---
## 4. Phase 1: 세계관 설계
## 4. Phase 0.5: 작가 문체 정의
> **담당 모델:** Sonnet
> **신규 기능:** v1.1 Multi-작가 시스템
### 4.1 목표
- 프로젝트의 문체(Writing Style) 정의
- 작가 프로필 생성 또는 선택
- 문체 일관성 기준 수립
- 작성 단계에서 문체 준수 가능하도록 명확한 가이드 제공
### 4.2 왜 작가 문체를 정의하는가?
```
❌ 문체 정의 없이 작성:
작성 → 챕터마다 문장 길이 다름 → 어미 불일치 → 독자 위화감
✅ 문체 정의 후 작성:
작가 정의 → 문체 기준 명확 → 일관된 작성 → 독자 몰입
```
**핵심:**
- 여러 세션에 걸쳐 작성해도 문체가 일관됨
- Multi-작가 시스템: 프로젝트마다 다른 작가(문체) 사용 가능
- 검증 단계에서 문체 체크 가능
### 4.3 작가 정의 프로세스
```
1. project-config.md 읽기
- 장르, 톤, 분위기 파악
2. 작가 생성 방법 선택
- 방법 A: 기존 작품 분석 (추천)
- 방법 B: 처음부터 정의
- 방법 C: 기존 작가 프로필 재사용
3. 작가 문체 분석/정의
- 10가지 항목 정의 (아래 템플릿 참조)
4. 산출물: authors/author-XX.md
```
### 4.4 작가 정의 10가지 항목
이 10가지 항목을 모두 정의해야 합니다:
```
1️⃣ 문장 길이 패턴
2️⃣ 어미 패턴 (과거형/현재형 비율)
3️⃣ 문장 구조 (단문/복문 비율)
4️⃣ 어휘 특성 (한자어/고유어, 감탄사, 반복 표현)
5️⃣ 묘사 스타일 (Show Don't Tell, 5감 묘사)
6️⃣ 대화 스타일 (짧음/김, 비율, 호칭)
7️⃣ 단락 구조 (1단락당 문장 수, 빈 줄 사용)
8️⃣ 리듬감 (짧은 문장 연타, 삼박자 등)
9️⃣ 시제 사용 (과거/현재, 독백 시제)
🔟 관점 (1인칭/3인칭, POV 전환)
```
### 4.5 방법 A: 기존 작품 분석 (추천)
**상황:** 이미 작성한 챕터 3~6개가 있을 때
```
1. 기존 챕터 3~6개 읽기
2. 10가지 항목별로 패턴 추출
- 문장 길이: 평균 __자, 짧은 문장 빈도 __%
- 어미 패턴: "-었다" _%, "-는다" _%
- ...
3. author-XX.md 생성
4. 체크리스트 작성
```
**예시:**
- 1945 소설 → ch-001~006 분석 → `author-01.md` 생성
- 로맨스 소설 → ch-001~005 분석 → `author-02.md` 생성
### 4.6 방법 B: 처음부터 정의
**상황:** 새 프로젝트 시작, 작성된 챕터 없음
```
1. project-config.md 톤/분위기 참고
- "진지한 대체역사" → 짧은 문장, 과거형, 직설적
- "가벼운 로맨스" → 긴 문장, 현재형, 감탄사 多
2. 10가지 항목 하나씩 결정
- "문장 길이: 평균 20자, 단문 위주"
- "어미: 과거형 90%, 현재형 10%"
- ...
3. author-XX.md 생성
4. 테스트 작성 (1화 샘플)
- 정의한 문체대로 1화 작성
- 위화감 있으면 조정
- author-XX.md 업데이트
```
### 4.7 방법 C: 기존 작가 재사용
**상황:** 이전 프로젝트와 비슷한 톤/장르
```
1. 기존 author-XX.md 복사
2. project-config.md와 비교
- 톤/분위기 일치하면 그대로 사용
- 차이 있으면 부분 수정
3. authors/author-YY.md로 저장
```
### 4.8 author-XX.md 템플릿
```markdown
# Author-XX: [프로젝트명 또는 장르] 작가 스타일
> **생성일:** YYYY-MM-DD
> **분석 대상:** (기존 챕터 또는 "신규 정의")
> **용도:** [프로젝트명] 집필 시 문체 기준
---
## 📝 작가 개요
**특징:** (한 줄 요약)
**장르:**
**톤:**
---
## 1️⃣ 문장 길이 패턴
### 특징
- 평균 문장 길이: __~__자
- 짧은 문장 (10자 이하) 빈도: __%
- 긴 문장 (40자 이상) 빈도: __%
### 예시
```
(실제 예시 3~5개)
```
### 규칙
- ✅ (작성 시 지킬 규칙)
- ❌ (피해야 할 패턴)
---
## 2️⃣ 어미 패턴
### 통계
- **과거형 "-었다/-였다/-았다"**: __%
- **현재형 "-는다/-ㄴ다"**: __%
- **의문형 "-까/-나/-ㄹ까"**: __%
### 예시
```
(실제 예시)
```
### 규칙
- ✅
- ❌
---
## 3️⃣ 문장 구조
### 특징
- **단문**: __% (한 문장 = 한 정보)
- **복문**: __% (접속사 연결)
### 예시
```
✅ 선호 구조:
(예시)
❌ 비권장 구조:
(예시)
```
### 규칙
- ✅
- ❌
---
## 4️⃣ 어휘 특성
### 특징
- 한자어 vs 고유어 비율: __ : __
- 감탄사/의성어: (많음/보통/적음)
- 핵심 단어 반복: (함/안 함)
### 예시
```
(특징적 어휘 패턴)
```
### 규칙
- ✅
- ❌
---
## 5️⃣ 묘사 스타일
### 원칙
- **Show Don't Tell**: (철저/보통/Tell 허용)
- **5감 묘사**: (시각 _%, 청각 _%, 촉각 _%, ...)
### 예시
```
❌ Tell:
(예시)
✅ Show:
(예시)
```
### 규칙
- ✅
- ❌
---
## 6️⃣ 대화 스타일
### 특징
- 대화 길이: (짧음/보통/김)
- 대화 비율: __% (서술 __%)
- 대화 태그: (많음/적음)
### 예시
```
✅ 선호 스타일:
(예시)
❌ 비권장:
(예시)
```
### 규칙
- ✅
- ❌
---
## 7️⃣ 단락 구조
### 특징
- 1단락 = __~__문장
- 빈 줄 사용: (매 단락/특정 상황만)
- 최대 단락 길이: __문장
### 예시
```
✅ 선호 구조:
(실제 단락 예시)
❌ 비권장:
(너무 긴 단락 예시)
```
### 규칙
- ✅
- ❌
---
## 8️⃣ 리듬감
### 특징
- 짧은 문장 연타: (자주 사용/가끔/안 함)
- 삼박자 리듬 (Rule of Three): (사용/안 함)
### 예시
```
✅ 리듬감 조성:
(예시)
```
### 규칙
- ✅
- ❌
---
## 9️⃣ 시제 사용
### 규칙
- **기본 시제:** (과거/현재)
- **독백 시제:** (과거/현재)
- **회상 시제:** (과거완료/현재)
### 예시
```
✅ 기본:
(예시)
✅ 독백:
(예시)
```
### 규칙
- ✅
- ❌
---
## 🔟 관점 (POV)
### 특징
- **기본 관점:** (1인칭/3인칭 전지적/3인칭 제한)
- **POV 전환:** (함/안 함)
- **내면 묘사:** (빈번/보통/적음)
### 예시
```
(POV 예시)
```
### 규칙
- ✅
- ❌
---
## 📊 문체 체크리스트
작성 후 자가 점검:
### 문장
- [ ] 문장 길이가 기준 범위 내인가?
- [ ] 어미 비율이 기준과 맞는가?
- [ ] 문장 구조가 일관되는가?
### 어휘
- [ ] 어휘 특성이 일관되는가?
- [ ] 부적절한 어휘 사용 없는가?
### 묘사
- [ ] 묘사 스타일 준수했는가?
- [ ] 5감 묘사 비율 적절한가?
### 대화
- [ ] 대화 길이/비율 적절한가?
- [ ] 호칭 일관성 유지했는가?
### 구조
- [ ] 단락 구조 일관되는가?
- [ ] 리듬감 적절한가?
### 시제/관점
- [ ] 시제 사용 일관되는가?
- [ ] POV 일탈 없는가?
---
## 📌 핵심 원칙 (Top 5)
1. (가장 중요한 문체 특징 1)
2. (가장 중요한 문체 특징 2)
3. (가장 중요한 문체 특징 3)
4. (가장 중요한 문체 특징 4)
5. (가장 중요한 문체 특징 5)
---
**이 작가 스타일은 [프로젝트명] 전체에 적용됩니다.**
```
### 4.9 작가 선택 및 적용
```markdown
## project-config.md에 작가 명시
프로젝트 설정 파일에 사용할 작가를 명시:
```markdown
# 프로젝트 설정
## 기본 정보
- **제목:** 1945
- **장르:** 대체역사
- **작가 스타일:** author-01 ⭐ 명시!
...
```
작성 모드 진입 시 AI가 해당 작가 파일을 읽고 문체 준수.
```
### 4.10 Multi-작가 시스템
```
프로젝트A: author-01 (짧고 강렬한 문장)
프로젝트B: author-02 (부드럽고 긴 문장)
프로젝트C: author-01 재사용 (동일 톤)
→ 각 프로젝트마다 일관된 문체 유지
→ 프로젝트 간 문체 혼동 방지
```
### 4.11 체크리스트
```
Phase 0.5 완료 조건:
- [ ] 작가 정의 방법 선택 (A/B/C)
- [ ] 10가지 항목 모두 정의
- [ ] 예시 문장 3개 이상 작성
- [ ] 문체 체크리스트 작성
- [ ] 핵심 원칙 Top 5 명시
- [ ] authors/author-XX.md 생성 완료
- [ ] project-config.md에 작가 명시
```
---
## 5. Phase 1: 세계관 설계
> **담당 모델:** Sonnet
@@ -390,7 +817,7 @@ Phase 1 완료 조건:
---
## 5. Phase 2: 캐릭터 설계
## 6. Phase 2: 캐릭터 설계
> **담당 모델:** Opus
@@ -561,7 +988,7 @@ Phase 2 완료 조건:
---
## 6. Phase 3: 타임라인 설계
## 7. Phase 3: 타임라인 설계
> **담당 모델:** Sonnet
@@ -682,7 +1109,7 @@ Phase 3 완료 조건:
---
## 7. Phase 4: 플롯 설계
## 8. Phase 4: 플롯 설계
> **담당 모델:** Sonnet
@@ -870,9 +1297,9 @@ Phase 4 완료 조건:
---
## 8. Phase 5: 설계 검증
## 9. Phase 5: 설계 검증
### 8.1 2단계 검증 체계
### 9.1 2단계 검증 체계
```
┌─────────────────────────────────────────────────────────┐
@@ -894,7 +1321,7 @@ Phase 4 완료 조건:
└─────────────────────────────────────────────────────────┘
```
### 8.2 Phase 5-1: 품질 검증 (Opus)
### 9.2 Phase 5-1: 품질 검증 (Opus)
> **담당 모델:** Opus
@@ -933,7 +1360,7 @@ Phase 4 완료 조건:
- [ ] 감정 고조와 이완이 번갈아 있는가?
```
### 8.3 Phase 5-2: 일관성 검증 (Codex)
### 9.3 Phase 5-2: 일관성 검증 (Codex)
> **담당 모델:** Codex
@@ -971,7 +1398,7 @@ Phase 4 완료 조건:
- [ ] Deus Ex Machina가 없는가?
```
### 8.4 검증 결과 기록
### 9.4 검증 결과 기록
```markdown
# 설계 검증 보고서
@@ -1023,7 +1450,7 @@ Phase 4 완료 조건:
*검증을 통과한 설계만 작성 단계로 넘어갑니다.*
```
### 8.5 체크리스트
### 9.5 체크리스트
```
Phase 5 완료 조건:
@@ -1036,20 +1463,21 @@ Phase 5 완료 조건:
---
## 9. 산출물 명세
## 10. 산출물 명세
### 9.1 설계 단계 산출물 목록
### 10.1 설계 단계 산출물 목록
| 파일 | Phase | 담당 | 필수 |
|------|-------|------|------|
| `project-config.md` | 0 | Opus | ✅ |
| `authors/author-XX.md` | 0.5 | Sonnet | ✅ ⭐ v1.1 신규 |
| `worldbuilding.md` | 1 | Sonnet | ✅ |
| `characters-master.md` | 2 | Opus | ✅ |
| `timeline-master.md` | 3 | Sonnet | ✅ |
| `plot-master.md` | 4 | Sonnet | ✅ |
| `design-verification.md` | 5 | Opus+Codex | ✅ |
### 9.2 파일 저장 위치
### 10.2 파일 저장 위치
```
project/
@@ -1061,6 +1489,11 @@ project/
│ ├── plot-master.md # Phase 4
│ └── design-verification.md # Phase 5
│
├── authors/ # 작가 문체 프로필 ⭐ v1.1 신규
│ ├── author-01.md # Phase 0.5
│ ├── author-02.md # (필요 시)
│ └── ...
│
├── standards/ # 방법론 (CWS에서 복사)
│ └── ...
│
@@ -1068,47 +1501,54 @@ project/
└── ...
```
### 9.3 파일 간 참조 관계
### 10.3 파일 간 참조 관계
```
project-config.md
│
▼
worldbuilding.md ◀──────────────────┐
│ │
▼ │
characters-master.md ◀──────┐ │
│ │ │
▼ │ │
timeline-master.md ◀────────┼───────┤
│ │ │
▼ │ │
plot-master.md ─────────────┴───────┘
│
▼
design-verification.md
├──────────────────────────────┐
│ │
▼ ▼
authors/author-XX.md worldbuilding.md ◀──────────┐
│ │ │
│ (작성 시 참조) ▼ │
│ characters-master.md ◀──────┤
│ │ │
│ ▼ │
└────────────────────▶ timeline-master.md ◀───────┤
│ │
▼ │
plot-master.md ─────────────┘
│
▼
design-verification.md
```
**v1.1 신규:**
- `author-XX.md`는 `project-config.md` 톤/분위기 기반 생성
- 작성 모드에서 `author-XX.md` 참조하여 문체 준수
---
## 10. Writing Guide로 핸드오프
## 11. Writing Guide로 핸드오프
### 10.1 핸드오프 조건
### 11.1 핸드오프 조건
```
✅ 모든 Phase 완료
✅ 모든 Phase 완료 (0 ~ 5)
✅ 검증 통과
✅ 산출물 6개 완성
✅ 산출물 7개 완성 ⭐ v1.1: author-XX.md 추가
✅ 파일 간 참조 정상
```
### 10.2 핸드오프 체크리스트
### 11.2 핸드오프 체크리스트
```markdown
## 설계 → 작성 핸드오프 체크리스트
### 파일 확인
- [ ] project-config.md 존재
- [ ] authors/author-XX.md 존재 ⭐ v1.1 신규
- [ ] worldbuilding.md 존재
- [ ] characters-master.md 존재
- [ ] timeline-master.md 존재
@@ -1129,12 +1569,13 @@ design-verification.md
- [ ] 작성 모드 진입 가능!
```
### 10.3 Writing Guide에서 읽을 파일
### 11.3 Writing Guide에서 읽을 파일
```
작성 모드 시작 시 AI가 읽는 파일:
✅ CLAUDE.md
✅ authors/author-XX.md ⭐ v1.1 신규 (문체 준수)
✅ settings/characters-master.md (해당 권 부분)
✅ settings/timeline-master.md (해당 권 부분)
✅ volumes/vol-XX/plots/plot-XXX-YYY.md
@@ -1146,7 +1587,7 @@ design-verification.md
❌ design-verification.md (검증용)
```
### 10.4 핸드오프 후 설계 수정
### 11.4 핸드오프 후 설계 수정
```
⚠️ 작성 단계에서 설계 수정이 필요할 때: