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

Guide 저장소 초기화 (v3.0)

Browse Source 
**생성 파일:**
- Novel Writing Project Guide.md (v3.0, 45KB)
- README.md (저장소 소개)
- .gitignore

**템플릿:**
- templates/CLAUDE.md.template
- templates/chapter-template.md
- templates/project-structure.md

**목적:**
- 소설 프로젝트 공통 가이드 버전 관리
- 템플릿 파일 제공
- 다른 프로젝트 시작 시 참조

**v3.0 특징:**
- 모드 시스템 (WRITING/MODIFICATION/VERIFICATION)
- 컴팩팅 대응 (WORK-MODE.txt)
- 수정 프로토콜 체계화

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Alex
2026-01-17 09:38:06 +09:00
commit 91d3715737
6 changed files with 3085 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

288
templates/CLAUDE.md.template Normal file
View File

@@ -0,0 +1,288 @@
# CLAUDE.md - AI 협업 프로토콜
> **프로젝트:** [소설 제목]
> **장르:** [장르]
> **권수:** [N]권
> **작성일:** YYYY-MM-DD
---
## 🔴 절대 규칙 (최우선)
1. **세션 시작 시 자동 실행** - 아래 "세션 시작 프로토콜" 무조건 실행
2. **모드 확인** - WORK-MODE.txt 확인 후 해당 모드 프로토콜 실행 (v3.0)
3. **5화 단위 작성** - 항상 5화씩 연속 작성
4. **서머리 자동 업데이트** - 각 화 완료 시 즉시 summary 업데이트
5. **설정 파일 우선** - settings/ 및 vol-XX/ 내용이 최우선
6. **일관성 검증** - 매 화마다 캐릭터/타임라인 체크
7. **마스터 파일 동기화** - 작업 파일 변경 시 마스터도 업데이트
---
## 📋 세션 시작 프로토콜 (v3.0)
**Step 1: 이 파일 읽기** ✅ (자동)
**Step 2: 모드 확인 (최우선!)** ⭐⭐⭐
```bash
# WORK-MODE.txt 확인
if [ -f "volumes/vol-XX/WORK-MODE.txt" ]; then
MODE=$(grep "^MODE:" volumes/vol-XX/WORK-MODE.txt | cut -d: -f2 | xargs)
else
MODE="UNKNOWN"
fi
```
**MODE별 분기:**
**MODE = "MODIFICATION"** (수정 모드)
```
→ settings/modification-mode.md 읽기
→ 수정 프로토콜 실행
→ 이 파일 이하 실행 중단! (modification-mode.md만 따름)
```
**MODE = "VERIFICATION"** (점검 모드)
```
→ settings/verification-mode.md 읽기
→ 점검 프로토콜 실행
→ 이 파일 이하 실행 중단!
```
**MODE = "UNKNOWN"** 또는 **없음** (작성 모드, 기본)
```
→ 계속 진행 (아래 Step 3 실행)
→ settings/writing-mode.md 읽기 (선택)
```
**Step 3: 작성 모드 파일 읽기**
세션 시작 시 자동 실행:
```
1. 이 파일 (CLAUDE.md) 읽기 ✅ (자동)
2. WORK-MODE.txt 확인 ✅ (Step 2)
3. volumes/vol-XX/characters.md 읽기
4. volumes/vol-XX/timeline.md 읽기
5. settings/writing-guide.md 읽기
6. plots/plot-XXX-YYY.md 읽기 (이번 5화)
7. summaries/summary-이전.md 읽기 ⭐
8. summaries/summary-vol-이전-final.md 읽기 (다른 권이면)
9. docs/todo.md 읽기 (있으면)
```
**읽기 완료 후:**
```
"준비 완료. ch-XXX부터 시작합니다."
```
---
## 📝 작성 프로세스
### 각 화 작성 시:
```
1. plot 파일 확인
- 날짜, 장소, 등장인물
- 핵심 내용, 주요 장면
- 분량, 복선
2. 메모리 참조 (파일 읽기 X!)
- characters.md: 성격, 말투
- timeline.md: 날짜 확인
- writing-guide.md: 작성 규칙
- summary: 이전 내용
3. 작성
- Show, Don't Tell
- 5감 묘사
- 대화:묘사:서술 = 40:40:20
- 분량: 8,000-12,000자
4. 완료 후 즉시
- chapters/ch-XXX.md 저장
- summaries/summary 업데이트 (누적!)
- 변경사항 있으면 마스터 동기화
```
---
## 🔄 변경사항 처리
### 새 캐릭터 추가 시:
```
1. volumes/vol-XX/characters.md 업데이트
2. settings/characters-master.md 업데이트 ⭐
3. summary에 기록
```
### 복선 추가 시:
```
1. volumes/vol-XX/timeline.md 복선 추적표
2. settings/timeline-master.md 복선 추적표 ⭐
3. summary에 기록
```
### 설정 변경 시:
```
즉시 사용자에게 보고:
"[변경사항] 발생. 확인 필요합니다."
```
---
## 📊 서머리 관리
### 형식:
```markdown
# X-Y화 누적 서머리
> 최종 업데이트: YYYY-MM-DD HH:MM
> 현재: ch-YYY (총 Y화)
## 📌 전체 줄거리
{누적 3-5문단}
## 📖 챕터별 핵심
### ch-XXX: [제목]
**날짜:** YYYY-MM-DD
**핵심:** 1줄 요약
## 🎭 캐릭터 상태
### [이름]:
- ch-XXX: 상태
## ⚠️ 복선
- [ ] [내용] (ch-XXX) → 회수: [시점]
## 📊 통계
- 총 챕터: Y화
- 총 분량: Z자
```
---
## ✅ 5화 완료 체크리스트
```
각 5화 완료 시 자동 실행:
✅ 5개 챕터 파일 생성
✅ summary 누적 업데이트
✅ 캐릭터/타임라인 변경사항 마스터 동기화
✅ Git 커밋
형식:
"X-Y화 작성 완료
- ch-XXX: [제목] (Z자)
...
- summary-XXX-YYY.md 업데이트
총 Z자
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
✅ Git 푸시
✅ 다음 5화 안내
```
---
## 🎯 권 완료 체크리스트
```
50화 완료 시:
✅ summary-001-050.md 확인
✅ summary-vol-XX-final.md 생성 (압축!)
✅ 미회수 복선 정리
✅ Git 커밋
"X권 완료
- 50화 전체 (Z자)
- summary-vol-XX-final.md 생성
- 미회수 복선 N개
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
✅ Git 푸시
✅ 다음 권 안내
```
---
## 📌 프로젝트 정보
**제목:** [소설 제목]
**장르:** [장르]
**권수:** [N]권
**화/권:** 50화
**분량/화:** 8,000-12,000자
**총 분량:** 약 [N * 500,000]자
**시간 배경:** [시작] - [종료]
**주인공:** [이름]
**핵심 줄거리:**
{3문장}
---
## 🚫 금지 사항
❌ 설정 파일 읽지 않고 작성
❌ 서머리 업데이트 생략
❌ 마스터 파일 동기화 누락
❌ 날짜/나이 오류
❌ 캐릭터 OOC
❌ 복선 누락
❌ WORK-MODE.txt 무시 (v3.0)
❌ 수정 시 summary 재생성 누락 (v3.0)
---
## 💡 명령어
### 설계:
- "큰 틀 정하자" → Phase 1
- "X권 플롯 작성" → Phase 2
### 실행:
- "실행 준비" → Phase 3
- "1~5화 작성해" → Phase 4
### 수정 (v3.0):
- "수정 준비해: [문제명]" → 수정 모드 준비
- "수정 실행" → 수정 모드 실행
### 점검 (v3.0):
- "점검해" → 전체 검증
### 유틸:
- "타임라인 검증" → 날짜 체크
- "복선 현황" → 미회수 떡밥
- "캐릭터 상태" → 현재 상태
---
## 📚 참고 파일
### 공통 (settings/):
- `writing-guide.md`: 전체 작성 규칙
- `chapter-format-standard.md`: 챕터 형식 표준 (v3.0)
- `writing-mode.md`: 작성 모드 절차 (v3.0)
- `modification-mode.md`: 수정 모드 절차 (v3.0)
- `verification-mode.md`: 점검 모드 절차 (v3.0)
- `renaming-protocol.md`: 안전한 리네임 (v3.0)
### 권별 (volumes/vol-XX/):
- `CHANGELOG.md`: 변경 이력 (v3.0)
- `WORK-MODE.txt`: 현재 모드 (v3.0, 임시)
---
*AI는 이 파일을 항상 우선 읽고 규칙을 준수한다.*
*v3.0에서는 WORK-MODE.txt 확인이 최우선이다!*

129
templates/chapter-template.md Normal file
View File

@@ -0,0 +1,129 @@
# X권 Y화: [제목]
> **타임라인:** YYYY.M.D-M.D
> **장소:** [장소1], [장소2]
> **등장인물:** [인물A], [인물B], [인물C]
---
## Part 1: [소제목]
[첫 장면 묘사]
[대화]
"대사 내용," [인물A]가 말했다.
"답변 내용," [인물B]가 고개를 끄덕이며 답했다.
[행동 묘사]
---
## Part 2: [소제목]
[두 번째 장면]
---
## Part 3: [소제목]
[세 번째 장면]
---
## Part 4: [소제목]
[네 번째 장면]
---
## Part 5: [소제목]
[마지막 장면]
---
**[권 X화 종료]**
---
## 📝 작성 가이드
### 헤더 형식 (필수!)
```markdown
# X권 Y화: [제목]
> **타임라인:** YYYY.M.D-M.D
> **장소:** [장소1], [장소2]
> **등장인물:** [주요 등장인물 나열]
```
### 분량 가이드
- **권장 분량:** 8,000 ~ 12,000자
- **최소 분량:** 6,000자 (너무 짧음 주의)
- **최대 분량:** 15,000자 (너무 길면 분할 고려)
### 구조
- **Part 개수:** 3~7개 (유동적)
- **Part별 분량:** 1,500~3,000자
- **시작:** 장면 설정 및 분위기
- **중간:** 갈등/사건 전개
- **끝:** 다음 화로 연결
### 작성 원칙
#### 1. Show, Don't Tell
```markdown
❌ "강민준은 화가 났다."
✅ "강민준의 주먹이 떨렸다. 그의 눈빛이 차갑게 식었다."
```
#### 2. 5감 묘사
- **시각:** 색, 형태, 움직임
- **청각:** 소리, 음색, 리듬
- **촉각:** 질감, 온도, 압력
- **후각:** 향기, 냄새
- **미각:** 맛 (필요시)
#### 3. 대화와 묘사 균형
- **대화:** 40%
- **묘사:** 40%
- **서술:** 20%
#### 4. 타임라인 연속성
- **이전 화 종료일 ≤ 현재 화 시작일**
- 시간 역행 금지
- 날짜 겹침 금지
#### 5. 캐릭터 일관성
- **성격:** characters.md 참조
- **말투:** 캐릭터별 특징 유지
- **나이:** 계산 정확히
---
## 🚫 금지 사항
❌ 갑작스러운 시간 점프 (설명 없이)
❌ 캐릭터 OOC (Out Of Character)
❌ 설정 모순
❌ Deus Ex Machina (신의 개입)
❌ 타임라인 오류
❌ 과도한 설명 (Tell)
❌ 감정 직접 서술
---
## 📌 참고
- **플롯:** plots/plot-XXX-YYY.md
- **캐릭터:** volumes/vol-XX/characters.md
- **타임라인:** volumes/vol-XX/timeline.md
- **작성 규칙:** settings/writing-guide.md
- **챕터 형식:** settings/chapter-format-standard.md
---
**작성일:** YYYY-MM-DD
**버전:** 1.0

307
templates/project-structure.md Normal file
View File

@@ -0,0 +1,307 @@
# 소설 프로젝트 폴더 구조
> **버전:** 3.0 (모드 시스템 포함)
> **작성일:** YYYY-MM-DD
> **용도:** 새 프로젝트 폴더 구조 참조
---
## 📁 전체 구조
```
novel-project/
│
├── CLAUDE.md # AI 협업 프로토콜 ⭐
├── README.md # 프로젝트 소개
├── CHANGELOG.md # 전체 변경 이력
├── .gitignore # Git 제외 파일
├── .gitattributes # Git 속성
│
├── settings/ # 🎨 마스터 파일 (설계용)
│ ├── characters-master.md # 전체 권 통합 캐릭터
│ ├── timeline-master.md # 전체 타임라인
│ ├── plot-master.md # 전체 권 줄거리
│ ├── writing-guide.md # 전체 공통 작성 규칙
│ │
│ ├── chapter-format-standard.md # v3.0: 챕터 형식 표준
│ ├── writing-mode.md # v3.0: 작성 모드 절차
│ ├── modification-mode.md # v3.0: 수정 모드 절차
│ ├── verification-mode.md # v3.0: 점검 모드 절차
│ └── renaming-protocol.md # v3.0: 안전한 리네임
│
├── volumes/ # 📚 권별 폴더
│ ├── vol-01/
│ │ ├── CHANGELOG.md # v3.0: 1권 변경 이력
│ │ ├── WORK-MODE.txt # v3.0: 현재 작업 모드 (임시)
│ │ ├── plot-master.md # 1권 전체 플롯 (50화)
│ │ ├── characters.md # 1권 캐릭터 (작업용, 작음!)
│ │ ├── timeline.md # 1권 타임라인 (작업용, 작음!)
│ │ │
│ │ ├── plots/ # 📝 5화별 플롯 (작업용)
│ │ │ ├── plot-001-005.md
│ │ │ ├── plot-006-010.md
│ │ │ ├── plot-011-015.md
│ │ │ └── ...
│ │ │
│ │ ├── summaries/ # 📋 누적 서머리
│ │ │ ├── summary-001-005.md
│ │ │ ├── summary-001-010.md (누적!)
│ │ │ ├── summary-001-015.md (누적!)
│ │ │ ├── ...
│ │ │ ├── summary-001-050.md (1권 전체)
│ │ │ └── summary-vol-01-final.md ⭐ (압축, 2권용)
│ │ │
│ │ └── chapters/ # 📖 실제 원고
│ │ ├── ch-001.md
│ │ ├── ch-002.md
│ │ ├── ch-003.md
│ │ └── ...
│ │
│ ├── vol-02/
│ │ ├── CHANGELOG.md # v3.0
│ │ ├── WORK-MODE.txt # v3.0 (임시)
│ │ └── (동일 구조)
│ │
│ └── ...
│
├── docs/ # 📁 문서
│ ├── todo.md
│ └── notes/
│
└── .git/ # Git 저장소
```
---
## 📂 폴더별 설명
### 루트 폴더
| 파일 | 용도 | 업데이트 주기 |
|------|------|--------------|
| `CLAUDE.md` | AI 협업 프로토콜, 세션마다 자동 읽음 | 거의 없음 |
| `README.md` | 프로젝트 소개, 독자/협업자용 | 필요 시 |
| `CHANGELOG.md` | 전체 변경 이력 (선택) | 주요 변경 시 |
---
### settings/ (마스터 파일)
**용도:** 전체 권 통합 설계, 작성 시 읽지 않음!
| 파일 | 크기 | 용도 | 읽기 시점 |
|------|------|------|----------|
| `characters-master.md` | 큼 (30,000 토큰) | 전체 캐릭터 통합 | 설계 시만 |
| `timeline-master.md` | 큼 (20,000 토큰) | 전체 타임라인 | 설계 시만 |
| `plot-master.md` | 큼 (10,000 토큰) | 전체 줄거리 | 설계 시만 |
| `writing-guide.md` | 중간 (3,000 토큰) | 작성 규칙 | 매 세션 |
**v3.0 추가 파일:**
| 파일 | 용도 | 읽기 시점 |
|------|------|----------|
| `chapter-format-standard.md` | 챕터 형식 표준 | 설정 시, 수정 시 |
| `writing-mode.md` | 작성 모드 절차 | 작성 시 |
| `modification-mode.md` | 수정 모드 절차 | 수정 시 |
| `verification-mode.md` | 점검 모드 절차 | 점검 시 |
| `renaming-protocol.md` | 안전한 리네임 | 리네임 시 |
---
### volumes/vol-XX/ (권별 폴더)
**용도:** 각 권의 작업 파일 (작고 가벼움)
| 파일 | 크기 | 용도 | 읽기 시점 |
|------|------|------|----------|
| `CHANGELOG.md` | 작음 | 권별 변경 이력 (v3.0) | 필요 시 |
| `WORK-MODE.txt` | 극소 | 현재 작업 모드 (v3.0, 임시) | 매 세션 시작 |
| `plot-master.md` | 큼 | 해당 권 전체 플롯 | 플롯 작성 시만 |
| `characters.md` | 작음 (2,000 토큰) | 해당 권 캐릭터만 | 매 세션 |
| `timeline.md` | 작음 (2,000 토큰) | 해당 권 타임라인만 | 매 세션 |
---
### volumes/vol-XX/plots/ (5화별 플롯)
**용도:** 5화씩 분할된 플롯 (작업용)
| 파일 | 생성 시점 | 읽기 시점 |
|------|----------|----------|
| `plot-001-005.md` | Phase 3 (실행 준비) | 1-5화 작성 시 |
| `plot-006-010.md` | Phase 3 | 6-10화 작성 시 |
| `plot-011-015.md` | Phase 3 | 11-15화 작성 시 |
| ... | ... | ... |
---
### volumes/vol-XX/summaries/ (누적 서머리)
**용도:** 각 화 작성 후 누적 서머리
| 파일 | 크기 | 생성 시점 | 읽기 시점 |
|------|------|----------|----------|
| `summary-001-005.md` | 작음 (2,000 토큰) | 5화 완료 시 | 6화 이후 |
| `summary-001-010.md` | 작음 (3,000 토큰) | 10화 완료 시 | 11화 이후 |
| `summary-001-015.md` | 작음 (4,000 토큰) | 15화 완료 시 | 16화 이후 |
| ... | ... | ... | ... |
| `summary-001-050.md` | 큼 (30,000 토큰) | 50화 완료 시 | 압축 시만 |
| `summary-vol-01-final.md` | 작음 (3,000 토큰) ⭐ | 권 완료 시 | 다음 권 작성 시 |
---
### volumes/vol-XX/chapters/ (실제 원고)
**용도:** 실제 소설 원고 파일
| 파일 | 분량 | 생성 시점 |
|------|------|----------|
| `ch-001.md` | 8,000-12,000자 | 1화 작성 시 |
| `ch-002.md` | 8,000-12,000자 | 2화 작성 시 |
| ... | ... | ... |
---
## 📊 파일 크기 비교
### 토큰 효율성 (한글 1글자 ≈ 1.5 토큰)
**마스터 파일 (설계용, 작성 시 읽지 않음!):**
```
characters-master.md: 50,000자 → 30,000 토큰
timeline-master.md: 20,000자 → 20,000 토큰
plot-master.md: 10,000자 → 10,000 토큰
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
합계: 80,000자 → 60,000 토큰 ❌ 너무 큼!
```
**작업 파일 (작성 시 읽음):**
```
CLAUDE.md: 2,000자 → 2,000 토큰
characters.md (1권): 3,000자 → 2,000 토큰
timeline.md (1권): 3,000자 → 2,000 토큰
writing-guide.md: 6,000자 → 3,000 토큰
plot-001-005.md: 3,000자 → 2,000 토큰
summary-001-005.md: 3,000자 → 2,000 토큰
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
합계: 20,000자 → 13,000 토큰 ✅ 적절!
```
**여유 토큰:**
```
전체 토큰: 200,000
읽기 토큰: -13,000
━━━━━━━━━━━━━━━━━━
작성 여유: 187,000 토큰 (충분!)
```
---
## 🔄 v3.0 모드 시스템
### WORK-MODE.txt 예시
**작성 모드 (기본, 없음):**
```
(파일 없음 또는 MODE: WRITING)
```
**수정 모드:**
```
MODE: MODIFICATION
TASK: ch-029/030 타임라인 역전 수정
REPORT: 2권_완전_재검증_보고서.md
PLAN: modification-plan-20260117.md
SCOPE: ch-029, 030, summary-001-030~060
VOL: vol-02
CREATED: 2026-01-17 16:00
```
**점검 모드:**
```
MODE: VERIFICATION
TASK: 2권 전체 점검
CREATED: 2026-01-17 16:30
```
---
## 📋 파일 명명 규칙
### 권별 폴더:
```
vol-01 (1권)
vol-02 (2권)
...
vol-10 (10권)
```
### 챕터 파일:
```
ch-001.md (1화)
ch-002.md (2화)
...
ch-050.md (50화)
ch-051.md (2권 1화)
```
### 플롯 파일:
```
plot-001-005.md (1-5화)
plot-006-010.md (6-10화)
...
plot-046-050.md (46-50화)
```
### 서머리 파일:
```
summary-001-005.md (1-5화 누적)
summary-001-010.md (1-10화 누적)
...
summary-001-050.md (1-50화 누적)
summary-vol-01-final.md (압축 버전)
```
---
## 🚀 프로젝트 생성 순서
### Phase 1: 설계
```bash
mkdir settings
# characters-master.md, timeline-master.md, plot-master.md 작성
```
### Phase 2: 권별 플롯
```bash
mkdir -p volumes/vol-01
# vol-01/plot-master.md 작성
```
### Phase 3: 실행 준비 (자동화)
```bash
mkdir -p volumes/vol-01/{plots,summaries,chapters}
# 플롯 분할, 작업 파일 추출, Git 초기화
```
### Phase 4: 작성
```bash
# "1~5화 작성해" 명령
# chapters/ch-001~005.md 생성
# summaries/summary-001-005.md 생성
```
---
## 📌 참고
- **메인 가이드:** `Novel Writing Project Guide.md`
- **템플릿:**
- `templates/CLAUDE.md.template`
- `templates/chapter-template.md`
- `templates/project-structure.md` (이 파일)
---
**작성일:** YYYY-MM-DD
**버전:** 3.0
**작성자:** Alex