novel-writing-guide/Novel Writing Project Guide.md

# 소설 작성 프로젝트 표준 가이드 (v2.0)

> **작성일:** 2026-01-15
> **버전:** 2.0
> **목적:** AI와 협업하여 장편 소설(10권 이상)을 체계적으로 작성하기 위한 표준 가이드

---

## ⚠️ 이 문서의 역할

### 📖 이 가이드는 "매뉴얼"입니다

**용도:**
- ✅ 프로젝트 **설정 시 1회만** 참고
- ✅ 워크플로우 이해
- ✅ 파일 구조 학습
- ❌ **작업 중에는 읽지 않음!**

**비유:**
```
이 가이드 = 자동차 운전 교본 (처음 배울 때만)
CLAUDE.md = 내비게이션 (매번 운전할 때마다)
```

### 🤖 AI가 실제 작업 시 읽는 파일

**매 세션마다 읽음:**
```
✅ CLAUDE.md (각 프로젝트 고유!)
✅ volumes/vol-XX/characters.md
✅ volumes/vol-XX/timeline.md
✅ settings/writing-guide.md
✅ plots/plot-XXX-YYY.md
✅ summaries/summary-XXX-YYY.md

❌ Novel Writing Project Guide.md (이 파일!)
```

### 📋 실제 워크플로우

#### 첫 프로젝트 시작:
```
1. 사용자: 이 가이드 읽기 (워크플로우 이해)
2. 사용자: "큰 틀 정하자"
3. AI: 이 가이드 참조하며 프로젝트 설정
4. AI: CLAUDE.md 생성 (프로젝트 고유 작업 지시서!)
5. AI: "실행 준비" → 폴더/파일/Git 자동 생성

→ 이후 이 가이드는 안 읽음!
```

#### 이후 모든 작업 세션:
```
세션 시작:
→ CLAUDE.md 읽기 (프로젝트 규칙)
→ 작업 파일들 읽기
→ 작성 시작!

→ 이 가이드는 안 읽음! ✅
```

**핵심:**
- 이 가이드 = 설정 방법 설명서
- CLAUDE.md = 실제 작업 지시서

---

## 📌 목차

**⚠️ [이 문서의 역할](#%EF%B8%8F-이-문서의-역할)** ← 먼저 읽기!

1. [핵심 컨셉](#1-핵심-컨셉)
2. [전체 워크플로우](#2-전체-워크플로우)
3. [프로젝트 위치 선택](#3-프로젝트-위치-선택)
4. [파일 구조](#4-파일-구조)
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. [Phase 6: 다음 권](#10-phase-6-다음-권)
11. [CLAUDE.md 템플릿](#11-claudemd-템플릿)
12. [Git 자동화](#12-git-자동화)
13. [토큰 효율 관리](#13-토큰-효율-관리)
14. [파일 명명 규칙](#14-파일-명명-규칙)
15. [부록](#15-부록)

---

## 1. 핵심 컨셉

### 1.1 설계와 실행의 완전 분리

```
설계 단계 (마스터 파일):
→ 전체 10권 통합 설계
→ 일관성 검토 및 확정
→ 크고 무거움 (50,000 토큰)
→ 작성 시 읽지 않음!

실행 단계 (작업 파일):
→ 마스터에서 필요한 부분만 추출
→ 작고 가벼움 (2,000 토큰)
→ 매 세션마다 읽음
```

### 1.2 토큰 효율성 최우선

**문제:**
```
기존 방식:
- 전체 캐릭터 파일 (50,000 토큰)
- 전체 타임라인 (20,000 토큰)
- 전체 플롯 (10,000 토큰)
━━━━━━━━━━━━━━━━━━━━━
총: 80,000 토큰 읽기
→ 작성 여유: 120,000 토큰 (부족!)
```

**해결:**
```
새 방식:
- 1권 캐릭터 (2,000 토큰)
- 1권 타임라인 (2,000 토큰)
- 5화 플롯 (2,000 토큰)
- 누적 서머리 (3,000 토큰)
━━━━━━━━━━━━━━━━━━━━━
총: 13,000 토큰 읽기
→ 작성 여유: 187,000 토큰 (충분!)
```

### 1.3 5화 = 1작업 단위

```
사용자 관점:
- 5화 플롯 1개 작성
- "1~5화 작성해" 1번 명령
- 5화 서머리 1개 결과

AI 관점:
- 5화 = 최소 작업 단위
- plot-001-005.md (5화 플롯)
- summary-001-005.md (5화 결과)
```

### 1.4 누적 서머리로 일관성 유지

```
문제:
- 7권 쓸 때 1권 내용 잊어버림
- Claude 컨텍스트 한계 (6-8만자)

해결:
- 매 5화마다 서머리 누적
- summary-001-005.md
- summary-001-010.md (1-10화 전체!)
- summary-001-050.md (1권 전체!)
- summary-vol-01-final.md (압축 버전)
```

---

## 2. 전체 워크플로우

### Phase 1: 설계 (큰 틀)
```
사용자: "큰 틀 정하자"
AI: 질문 시작 → 함께 작성

생성 파일:
✅ settings/characters-master.md
✅ settings/timeline-master.md
✅ settings/plot-master.md
✅ settings/writing-guide.md

→ 일관성 검토 → 확정
```

### Phase 2: 권별 플롯
```
사용자: "1권 플롯 작성"
AI: plot-master 기반 상세화

생성 파일:
✅ volumes/vol-01/plot-master.md

→ 검토 → 확정
```

### Phase 3: 실행 준비 (자동화)
```
사용자: "실행 준비"
AI: 자동 실행

생성:
✅ 폴더 구조
✅ 5화별 플롯 분할
✅ 권별 작업 파일 추출
✅ Git 저장소 초기화
```

### Phase 4: 작성
```
사용자: "1~5화 작성해"
AI: 5화 연속 작성 + 서머리

생성:
✅ ch-001~005.md
✅ summary-001-005.md
```

### Phase 5: 권 완료
```
50화 완료 시
AI: 자동 압축 서머리 생성

생성:
✅ summary-vol-01-final.md
```

### Phase 6: 다음 권
```
사용자: "2권 실행 준비"
AI: vol-02 자동 설정

→ Phase 4로 반복
```

---

## 3. 프로젝트 위치 선택

### 3.1 권장 위치: Google Drive

**경로:**
```
L:\내 드라이브\Writing\[프로젝트명]\
```

**예시:**
```
L:\내 드라이브\Writing\1945-novel\
L:\내 드라이브\Writing\my-fantasy-story\
```

### 3.2 이중 백업 전략

**로컬 (Google Drive):**
```
L:\내 드라이브\Writing\1945-novel\
├── .git\          ← Git 저장소
├── settings\
├── volumes\
└── ...

→ Google Drive 자동 클라우드 백업
→ 여러 기기 자동 동기화
```

**원격 (Gitea):**
```
git.digien25.co.kr/Alex/1945-novel.git

→ 버전 관리
→ 변경 이력 추적
→ 독립적인 백업
```

### 3.3 장점

1. **Google Drive:**
   - 실시간 클라우드 백업
   - 여러 PC에서 자동 동기화
   - 파일 복구 가능 (30일)
   - 대용량 무료 (15GB)

2. **Git + Gitea:**
   - 버전 관리 (변경 이력)
   - 커밋 메시지로 작업 추적
   - 브랜치로 실험 가능
   - 독립적인 원격 백업

3. **이중 백업:**
   - Google Drive 장애 시 Git에서 복구
   - Git 서버 장애 시 Google Drive에서 복구
   - 최대 안정성

### 3.4 Git 작동 방식

**자동 커밋/푸시:**
```
1. 파일 수정 (L:\내 드라이브\Writing\1945-novel\)
2. AI가 자동 Git 커밋
3. AI가 자동 Gitea 푸시
4. Google Drive가 자동 클라우드 동기화

→ 이중 백업 완성!
```

**충돌 방지:**
```
✅ 한 PC에서만 작업
✅ 작업 전 git pull
✅ 작업 후 git push

❌ 여러 PC 동시 작업 금지
```

### 3.5 프로젝트명 규칙

**권장:**
```
✅ 영문 소문자 + 하이픈
✅ 1945-novel
✅ my-fantasy-story
✅ sci-fi-adventure
```

**비권장:**
```
❌ 한글: 1945-다시-시작된-역사
❌ 공백: my fantasy story
❌ 대문자: MyNovel
❌ 특수문자: my_novel!
```

---

## 4. 파일 구조

### 4.1 전체 구조

```
novel-project/
│
├── CLAUDE.md                    # AI 협업 프로토콜
├── README.md                    # 프로젝트 소개
├── CHANGELOG.md                 # 변경 이력
├── .gitignore
├── .gitattributes
│
├── settings/                    # 🎨 마스터 파일 (설계용)
│   ├── characters-master.md     # 전체 10권 통합 캐릭터
│   ├── timeline-master.md       # 1945-2024 전체 타임라인
│   ├── plot-master.md           # 전체 10권 줄거리
│   └── writing-guide.md         # 전체 공통 작성 규칙
│
├── volumes/                     # 📚 권별 폴더
│   ├── vol-01/
│   │   ├── 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
│   │       └── ...
│   │
│   ├── vol-02/
│   │   └── (동일 구조)
│   │
│   └── ...
│
├── docs/                        # 📁 문서
│   ├── todo.md
│   └── notes/
│
└── .git/                        # Git 저장소
```

### 4.2 파일 역할

| 파일 | 용도 | 크기 | 읽기 시점 | 업데이트 |
|------|------|------|----------|----------|
| **마스터 파일** | | | | |
| `characters-master.md` | 전체 설계 | 큼 | 설계 시만 | 작성 중 필요 시 |
| `timeline-master.md` | 전체 설계 | 큼 | 설계 시만 | 작성 중 필요 시 |
| `plot-master.md` | 전체 설계 | 큼 | 설계 시만 | 거의 없음 |
| `writing-guide.md` | 작성 규칙 | 중간 | 매 세션 | 거의 없음 |
| **작업 파일** | | | | |
| `vol-XX/characters.md` | 작성 | 작음 | 매 세션 | 작성 중 필요 시 |
| `vol-XX/timeline.md` | 작성 | 작음 | 매 세션 | 작성 중 필요 시 |
| `plots/plot-XXX-YYY.md` | 작성 | 작음 | 매 세션 | 없음 |
| `summaries/summary-XXX-YYY.md` | 작성 | 작음-중간 | 매 세션 | 매 화마다 |

---

## 5. Phase 1: 설계 (큰 틀)

### 5.1 시작 명령

```
사용자: "큰 틀 정하자"
또는: "새 소설 기획"
또는: "/design start"
```

### 5.2 AI 질문 프로세스

AI가 순차적으로 질문:

```
1. 장르:
   - "어떤 장르인가요?" (판타지, SF, 현대물, 대체역사, 로맨스 등)

2. 전체 구조:
   - "총 몇 권인가요?"
   - "각 권은 몇 화인가요?" (기본: 50화)

3. 시간 배경:
   - "시작 시점은?"
   - "종료 시점은?"
   - "전체 기간은?"

4. 주인공:
   - "주인공은 누구인가요?"
   - "나이, 직업, 성격은?"

5. 핵심 줄거리:
   - "전체 줄거리를 3-5문장으로?"
   - "1권 줄거리는?"
   - "최종 결말은?"

6. 주요 캐릭터:
   - "주요 조연은?"
   - "악역은?"

7. 세계관 (장르별):
   - 판타지: "마법 체계는?"
   - SF: "기술 수준은?"
   - 대체역사: "어떤 분기점인가요?"

8. 작성 스타일:
   - "어떤 톤으로 쓸까요?" (진지함, 유머, 로맨틱 등)
   - "시점은?" (1인칭, 3인칭)
   - "금지 사항은?"
```

### 5.3 생성 파일

#### 5.3.1 characters-master.md

```markdown
# 등장인물 통합 사전

> 전체 10권 통합
> 최종 수정: YYYY-MM-DD

## 주인공

### 강민준 (1925생, 회귀자)

**기본 정보:**
- 회귀: 2024년 42세 → 1945년 20세 설정
- 출신: 서울대 → 안보실 차장
- 1945년 신분: 광복군 출신

**성격:**
- 냉철하고 이성적
- 강한 책임감
- 목표 지향적

**말투:**
- 짧고 명확
- 존댓말 기본
- 화날 때: 반말

**권별 변화:**
| 권 | 나이 | 역할 | 주요 사건 | 내적 변화 |
|----|------|------|----------|----------|
| 1권 | 20세 | 회귀자 | 회귀, 건준 합류 | 혼란 → 결단 |
| 2권 | 22세 | 정치가 | 결혼, 통일정부 | 성장 → 성숙 |
| 3권 | 30세 | 고문 | 은퇴 | 원로화 |

**주요 관계:**
- 서윤희: 아내 (1947년 결혼)
- 박현우, 최태준: 동료 회귀자

**등장 권:**
- 1-5권 (주인공)
- 6권 (타계)

---

### (다른 캐릭터들...)
```

#### 5.3.2 timeline-master.md

```markdown
# 전체 타임라인 (1945-2024)

> 전체 10권
> 최종 수정: YYYY-MM-DD

## 📌 핵심 설정 (불변 규칙)

```
✅ 1948.8.15: 통일 대한민국 정부 수립
✅ 이후 계속 통일 상태
❌ "북한" 존재하지 않음
✅ 한반도 전체가 대한민국
```

## 1권: 광복의 선택 (1945.8-1946.12)

### 시간 정보:
```
시작: 1945.8.16
종료: 1946.12.31
경과: 16개월
```

### 주요 사건:

#### 1945.8.16: 회귀
- **장소:** 어딘가 → 경성
- **등장인물:** 강민준, 박현우, 최태준
- **내용:** 2024년에서 1945년으로 회귀
- **영향:** 역사 변경 시작
- **복선:** "만주" 첫 언급

#### 1945.9.1: 건준 합류
- **장소:** 경성 건국준비위원회
- **등장인물:** 강민준, 여운형
- **내용:** 건준 정치국 합류
- **영향:** 정치적 기반 확보

...

### 권말 상황:
```
- 강민준 상태: 정치 기반 확보, 서윤희 약혼
- 주요 갈등: 이승만 대립 (해결: 미국 망명)
- 다음 권 연결: 1947년 결혼, 통일정부 준비
```

## 2권: ...

## 복선 추적표 (전체)

| 복선 내용 | 설치 | 회수 | 상태 |
|----------|------|------|------|
| 만주 언급 | 1권 ch-003 | 2권 ch-010 | ✅ 완료 |
| ... | ... | ... | ... |

## 캐릭터 아크 (전체)

### 강민준:
| 권 | 나이 | 역할 | 내적 변화 |
|----|------|------|----------|
| 1권 | 20세 | 회귀자 | 혼란 → 결단 |
| 2권 | 22세 | 정치가 | 성장 → 성숙 |
...
```

#### 5.3.3 plot-master.md

```markdown
# 전체 줄거리 (10권)

> 최종 수정: YYYY-MM-DD

## 전체 개요

{전체 3-5문단 요약}

## 권별 줄거리

### 1권: 광복의 선택

**기간:** 1945.8 - 1946.12 (16개월)
**주제:** 회귀, 선택, 새로운 시작

**줄거리:**
{5-10문단}

**주요 사건:**
1. 회귀 (1945.8.16)
2. 건준 합류 (1945.9)
3. 트랜지스터 개발 (1946.6)
4. 만주 진출 (1946.9)
5. 약혼 (1946.12)

**권말:**
- 강민준: 정치 기반 확보
- 다음: 1947년 결혼

### 2권: ...
```

#### 5.3.4 writing-guide.md

```markdown
# 작성 가이드 (전체 공통)

> 최종 수정: YYYY-MM-DD

## 핵심 원칙

1. **Show, Don't Tell**
   - ❌ "강민준은 화가 났다"
   - ✅ "강민준의 주먹이 떨렸다"

2. **5감 묘사 필수**
   - 시각, 청각, 촉각, 후각, 미각

3. **대화와 묘사 비율**
   - 대화: 40%
   - 묘사: 40%
   - 서술: 20%

## 장르 특화 규칙

### 대체역사:
- 실제 역사와 차이점 명확히
- 연도/날짜 정확히
- 나이 계산 철저히

### 로맨스:
- 비율: 30% 이하
- 천천히 진행
- 감정 변화 단계적

## 속도 조절

- 1화 = 하루 ~ 3일
- 중요 장면: 느리게 (1일 = 2화도 OK)
- 일상: 빠르게 (1주일 = 1화도 OK)

## 금지 사항

❌ 갑작스러운 시간 점프 (설명 없이)
❌ 캐릭터 OOC (Out Of Character)
❌ 설정 모순
❌ Deus Ex Machina (신의 개입)

## 1화 적정 분량

**권장: 8,000 ~ 12,000자**

| 분량 | 평가 |
|------|------|
| 3,000-5,000자 | ❌ 너무 짧음 |
| 8,000-12,000자 | ✅ 적절 |
| 15,000-20,000자 | ⚠️ 너무 김 |
```

### 5.4 검토 및 확정

```
AI: "마스터 파일 생성 완료. 검토를 시작합니다."

검토 항목:
✅ 캐릭터 나이 일관성
✅ 타임라인 날짜 오류
✅ 복선 설치/회수 계획
✅ 권별 분량 균형
✅ 설정 모순 체크

사용자: "확정"
AI: "마스터 파일 확정. 권별 플롯 작성 가능합니다."
```

---

## 6. Phase 2: 권별 플롯

### 6.1 시작 명령

```
사용자: "1권 플롯 작성"
또는: "/plot vol-01"
```

### 6.2 플롯 작성

AI가 plot-master.md 기반으로 1권 50화 플롯 작성:

```markdown
# 1권 플롯 (50화)

> 기간: 1945.8.16 - 1946.12.31
> 최종 수정: YYYY-MM-DD

## 1-5화: 회귀와 시작

### ch-001: 빛 속으로
**날짜:** 1945.8.16
**장소:** 어딘가 → 경성
**등장인물:** 강민준, 박현우, 최태준
**핵심:**
- 회귀 순간
- 세 사람 만남
- 기억 확인
**분량:** 10,000자
**복선:** "만주" 첫 언급

### ch-002: 경성에서
**날짜:** 1945.8.17
**장소:** 경성 거리
**등장인물:** 강민준, 서윤희(첫 등장)
**핵심:**
- 경성 도착
- 여운형 찾기
- 서윤희 첫 만남
**분량:** 10,000자

...

### ch-005: 건준 합류
**날짜:** 1945.9.1
**장소:** 건국준비위원회
**등장인물:** 강민준, 여운형
**핵심:**
- 건준 정치국 합류
- 여운형과 신뢰 구축
- 계획 시작
**분량:** 10,000자
**복선:** 이승만 경계

---

## 6-10화: ...

## 플롯 요약

| 챕터 | 날짜 | 핵심 사건 | 복선 |
|------|------|----------|------|
| 001 | 1945.8.16 | 회귀 | 만주 |
| 002 | 1945.8.17 | 서윤희 만남 | - |
...
```

### 6.3 검토 및 확정

```
AI: "1권 플롯 완성. 50화 구조 검토해주세요."

확인 사항:
✅ 각 화 분량 균형 (8,000-12,000자)
✅ 날짜 연속성
✅ 캐릭터 등장 타이밍
✅ 복선 배치

사용자: "확정"
AI: "1권 플롯 확정. 실행 준비 가능합니다."
```

---

## 7. Phase 3: 실행 준비

### 7.1 시작 명령

```
사용자: "실행 준비"
또는: "1권 실행 준비"
또는: "/setup vol-01"
```

### 7.2 자동 실행 프로세스

AI가 자동으로:

#### Step 1: 폴더 구조 생성
```bash
mkdir -p volumes/vol-01/plots
mkdir -p volumes/vol-01/summaries
mkdir -p volumes/vol-01/chapters
mkdir -p docs/notes
```

#### Step 2: 플롯 분할 (5화씩)

`volumes/vol-01/plot-master.md`를 읽어서:

```
plots/plot-001-005.md 생성 (ch-001~005 내용만)
plots/plot-006-010.md 생성 (ch-006~010 내용만)
plots/plot-011-015.md 생성 (ch-011~015 내용만)
...
plots/plot-046-050.md 생성 (ch-046~050 내용만)
```

각 파일 예시:

```markdown
# 1-5화 플롯

> 날짜: 1945.8.16 - 1945.9.1
> 작성일: YYYY-MM-DD

## ch-001: 빛 속으로

**날짜:** 1945.8.16
**장소:** 어딘가 → 경성
**등장인물:** 강민준, 박현우, 최태준

**핵심 내용:**
- 회귀 순간 묘사
- 세 사람 만남
- 기억 확인 과정

**주요 장면:**
1. 눈부신 빛 (1,000자)
2. 낯선 경성 거리 (2,000자)
3. 세 사람 만남 (3,000자)
4. 기억 확인 (2,000자)
5. 결의 (2,000자)

**복선:**
- "만주... 만주가 핵심이다" (강민준 독백)

**분량:** 10,000자

---

## ch-002: ...
```

#### Step 3: 권별 작업 파일 추출

**characters.md 생성:**

`settings/characters-master.md`에서 1권 등장 캐릭터만 추출:

```bash
volumes/vol-01/characters.md 생성
```

내용 예시:
```markdown
# 1권 등장인물

> 출처: characters-master.md
> 추출일: YYYY-MM-DD

## 주인공

### 강민준 (20세, 1945년 기준)

**기본 정보:**
- 회귀자 (2024 → 1945)
- 신분: 광복군 출신(위장)

**성격:**
- 냉철, 이성적
- 강한 책임감

**말투:**
- 짧고 명확
- 존댓말 기본

**1권 주요 사건:**
- ch-001: 회귀
- ch-005: 건준 합류
- ch-030: 서윤희 고백

**1권 말 상태:**
- 서윤희와 약혼
- 정치적 기반 확보

---

### (1권 등장 캐릭터만)
```

**timeline.md 생성:**

`settings/timeline-master.md`에서 1권 기간만 추출:

```bash
volumes/vol-01/timeline.md 생성
```

내용 예시:
```markdown
# 1권 타임라인 (1945.8-1946.12)

> 출처: timeline-master.md
> 추출일: YYYY-MM-DD

## 핵심 설정

✅ 통일 대한민국 목표
❌ 분단 방지

## 주요 사건

### 1945.8.16: 회귀
- 강민준, 박현우, 최태준 회귀
- 경성 도착

### 1945.9.1: 건준 합류
- 여운형 만남
- 정치 활동 시작

...

## 1권 복선

| 복선 | 설치 | 회수 예정 |
|------|------|----------|
| 만주 언급 | ch-003 | 2권 |
| ... | ... | ... |
```

#### Step 4: Git 저장소 초기화

```bash
cd project-root
git init
git config user.name "Alex"
git config user.email "alex@digien25.co.kr"

# .gitignore 생성
cat > .gitignore << 'EOF'
# OS
.DS_Store
Thumbs.db

# Editor
.vscode/
.idea/
*.swp
*.swo

# Temp
*.tmp
~*

# Output
*.pdf
*.docx
EOF

# 초기 커밋
git add .
git commit -m "Initial commit: 1권 실행 준비 완료

- 폴더 구조 생성
- 플롯 5화별 분할 (10개 파일)
- 권별 작업 파일 추출
- Git 저장소 초기화

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

# Gitea 원격 저장소 연결
git remote add origin https://Alex:d2ae36cb862375aaab2575fcad5268d276798b2b@git.digien25.co.kr/Alex/[프로젝트명].git
git branch -M main
git push -u origin main
```

### 7.3 완료 메시지

```
AI: "✅ 실행 준비 완료!

생성된 파일:
- 플롯 파일: 10개 (5화씩)
- characters.md (1권 캐릭터 13명)
- timeline.md (1945.8-1946.12)
- Git 저장소 초기화 완료
- Gitea 푸시 완료

다음 단계:
'1~5화 작성해' 명령으로 작성 시작 가능합니다."
```

---

## 8. Phase 4: 작성

### 8.1 시작 명령

```
사용자: "1~5화 작성해"
또는: "ch-001~005 써줘"
또는: "/write 1-5"
```

### 8.2 세션 시작 (자동)

AI가 자동으로 파일 읽기:

```
🔄 세션 초기화...

읽기 (총 ~13,000 토큰):
✅ CLAUDE.md (2,000)
✅ volumes/vol-01/characters.md (2,000)
✅ volumes/vol-01/timeline.md (2,000)
✅ settings/writing-guide.md (3,000)
✅ plots/plot-001-005.md (2,000)
✅ summaries/summary-이전.md (없음 - 첫 시작)
✅ docs/todo.md (1,000)

준비 완료. ch-001부터 시작합니다.
```

### 8.3 작성 프로세스

#### ch-001 작성:
```
AI: ch-001 작성 시작...

plot-001-005.md 참조:
- 날짜: 1945.8.16
- 장소: 어딘가 → 경성
- 핵심: 회귀 순간
- 분량: 10,000자

writing-guide.md 준수:
- Show, Don't Tell
- 5감 묘사
- 대화:묘사:서술 = 40:40:20

characters.md 참조:
- 강민준 성격: 냉철, 이성적
- 강민준 말투: 짧고 명확

작성 완료: ch-001.md (10,234자)

summaries/summary-001-005.md 업데이트:
━━━━━━━━━━━━━━━━━━━━━
# 1-5화 누적 서머리

> 최종 업데이트: 2026-01-15 10:30
> 현재: ch-001 (1화)

## 📌 전체 줄거리

1945년 8월 16일, 강민준, 박현우, 최태준이 2024년에서 1945년으로 회귀했다. 눈부신 빛 속에서 깨어난 세 사람은 경성 거리에서 만나 서로의 기억이 유지되었음을 확인한다.

## 📖 챕터별 핵심

### ch-001: 빛 속으로
**날짜:** 1945.8.16
**장소:** 어딘가 → 경성
**등장인물:** 강민준, 박현우, 최태준
**핵심 사건:**
- 회귀 순간
- 세 사람 만남
- 기억 확인
**다음 화:** 경성 도착 후 여운형 찾기

## 🎭 캐릭터 상태

### 강민준:
- ch-001: 회귀 직후, 냉철함 유지

## ⚠️ 복선

- [ ] 만주 언급 (ch-001 독백) → 회수: 2권

## 📊 통계

- 총 챕터: 1화
- 총 분량: 10,234자
━━━━━━━━━━━━━━━━━━━━━
```

#### ch-002 작성:
```
AI: ch-002 작성 시작...

(동일 프로세스)

summaries/summary-001-005.md 업데이트:
- ch-002 내용 추가 (누적!)
```

#### ch-003~005 작성:
```
(반복)
```

### 8.4 5화 완료

```
AI: "✅ 1-5화 작성 완료!

생성 파일:
- chapters/ch-001.md (10,234자)
- chapters/ch-002.md (9,876자)
- chapters/ch-003.md (11,023자)
- chapters/ch-004.md (10,456자)
- chapters/ch-005.md (9,987자)

총 분량: 51,576자

서머리:
- summaries/summary-001-005.md 생성

Git 커밋:
━━━━━━━━━━━━━━━━━━━━━
1-5화 작성 완료

- ch-001: 빛 속으로 (10,234자)
- ch-002: 경성에서 (9,876자)
- ch-003: 건준 (11,023자)
- ch-004: 여운형 (10,456자)
- ch-005: 합류 (9,987자)
- summary-001-005.md 생성

총 51,576자

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
━━━━━━━━━━━━━━━━━━━━━

Gitea 푸시 완료.

다음: '6~10화 작성해'"
```

### 8.5 작성 중 변경 사항

#### 예: 새 캐릭터 추가
```
ch-007 작성 중:
→ 새 캐릭터 "김세우" 등장

AI 자동 업데이트:
1. volumes/vol-01/characters.md 업데이트
   → "김세우" 항목 추가

2. settings/characters-master.md 업데이트 ⭐
   → "김세우" 항목 추가 (전체 파일도!)

메시지:
"새 캐릭터 '김세우' 추가
- vol-01/characters.md 업데이트
- characters-master.md 업데이트"
```

#### 예: 복선 추가
```
ch-009 작성 중:
→ "검은 반지" 복선 설치

AI 자동 업데이트:
1. volumes/vol-01/timeline.md 복선 추적표
   "검은 반지 언급: ch-009 → 회수: 2권"

2. settings/timeline-master.md 복선 추적표
   동일하게 추가

3. summaries/summary-001-010.md
   복선 섹션에 추가
```

---

## 9. Phase 5: 권 완료

### 9.1 50화 완료 시

```
사용자: "46~50화 작성해"

AI: (작성 완료 후)

"✅ 46-50화 완료!
✅ 1권 전체 50화 완료!

총 분량: 503,456자

자동 압축 시작..."
```

### 9.2 압축 서머리 생성

AI가 `summary-001-050.md`를 읽고 압축:

`summaries/summary-vol-01-final.md` 생성:

```markdown
# 1권 최종 요약 (2권 작성용)

> 원본: summary-001-050.md (50화 전체)
> 압축일: YYYY-MM-DD
> 용도: 2권 작성 시 참조

## 📌 핵심 줄거리 (10문단)

1945년 8월 16일, 강민준, 박현우, 최태준이 2024년에서 1945년으로 회귀했다. 세 사람은 경성에 도착해 건국준비위원회에 합류하고 여운형과 연대한다.

이승만의 단독정부 야심을 저지하기 위해 강민준은 정치 활동을 시작한다. 박현우는 페니실린 생산을 시작하고, 최태준은 만주 진출을 준비한다.

강민준은 건준에서 서윤희를 처음 만나 그녀의 능력을 인정한다. 여운형과의 신뢰를 쌓으며 통일정부의 기반을 다진다.

1946년 2월, 최태준이 만주로 떠나 조선족 네트워크 구축을 시작한다. "쓸모없는 땅"을 매입하며 희토류 지역을 선점한다.

박현우는 트랜지스터 개발에 성공하여 세계를 앞서가기 시작한다. 반도체 산업의 기초를 놓는다.

이승만과의 대립이 심화되지만, 미군정의 지지를 얻는 데 성공한다. 이승만은 결국 미국으로 망명한다.

강민준과 서윤희의 관계가 발전한다. 덕수궁 돌담길에서 강민준이 고백하고 서윤희가 수락한다.

1946년 12월 25일, 두 사람은 명동성당에서 약혼식을 올린다. 가족과 동료들이 축복한다.

1권이 끝날 무렵, 강민준은 정치적 기반을 확보하고 통일정부 수립을 위한 계획을 구체화한다. 만주는 미래의 핵심 자원으로 준비 중이다.

1권은 회귀와 선택, 새로운 시작의 이야기로, 희망적인 분위기로 마무리된다.

## 🎭 주요 캐릭터 최종 상태

### 강민준:
- **나이:** 20세 → 21세
- **역할:** 회귀자 → 정치가
- **관계:** 서윤희와 약혼
- **성취:** 건준 핵심, 이승만 제거, 정치 기반 확보
- **성격 변화:** 혼란 → 결단 → 실행
- **2권 시작:** 1947년 결혼 예정

### 서윤희:
- **나이:** 27세 → 28세
- **역할:** 독립운동가 → 강민준의 파트너
- **관계:** 강민준과 약혼
- **성취:** 건준 활동, 여성 인권 운동
- **2권 시작:** 결혼, 통일정부 참여

### 박현우:
- **나이:** 회귀자 (외관 30대)
- **역할:** 과학자
- **성취:** 페니실린, 트랜지스터
- **2권 시작:** 반도체 연구 지속

### 최태준:
- **나이:** 회귀자 (외관 30대)
- **역할:** 실행 담당
- **위치:** 만주
- **성취:** 조선족 네트워크, 희토류 지역 선점
- **2권 시작:** 만주 공작 지속

## ⚠️ 미회수 복선 (2권에서 회수!)

| 복선 | 설치 화 | 내용 |
|------|---------|------|
| 만주 언급 | ch-003 | "만주가 핵심이다" |
| 희토류 | ch-030 | "쓸모없는 땅에 보물" |
| 트랜지스터 원리 | ch-025 | "이걸로 세계를 바꾼다" |

## 🔗 2권 연결점

**시간:**
- 1권 종료: 1946.12.31
- 2권 시작: 1947.1.1

**상황:**
- 강민준-서윤희 약혼 상태
- 1947.11 결혼 예정
- 1948.8.15 통일정부 수립 목표
- 만주 공작 진행 중

**주요 과제:**
- 통일정부 수립
- 만주 조차 협정 (1950 목표)
- 반도체 산업 기반
- 한국전쟁 방지

## 📊 1권 통계

- 총 화수: 50화
- 총 분량: 503,456자
- 평균 분량: 10,069자/화
- 기간: 1945.8.16 - 1946.12.31 (16개월)
- 등장 캐릭터: 23명
- 주요 사건: 47개
```

### 9.3 Git 커밋

```bash
git add .
git commit -m "1권 완료

- 50화 전체 완성 (503,456자)
- summary-vol-01-final.md 생성 (2권용 압축)
- 미회수 복선 3개 (2권에서 회수)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

git push origin main
```

### 9.4 완료 메시지

```
AI: "🎉 1권 완료!

━━━━━━━━━━━━━━━━━━━━━
📚 1권: 광복의 선택

총 화수: 50화
총 분량: 503,456자
기간: 1945.8.16 - 1946.12.31

압축 서머리 생성:
✅ summary-vol-01-final.md (2권용)

미회수 복선: 3개
→ 2권에서 회수 예정

Git 푸시 완료.
━━━━━━━━━━━━━━━━━━━━━

다음 단계:
'2권 플롯 작성' 또는
'2권 실행 준비'"
```

---

## 10. Phase 6: 다음 권

### 10.1 2권 플롯 작성

```
사용자: "2권 플롯 작성"

AI: plot-master.md 참조
    summary-vol-01-final.md 참조 (1권 마무리 확인)

생성:
✅ volumes/vol-02/plot-master.md (50화)

검토 → 확정
```

### 10.2 2권 실행 준비

```
사용자: "2권 실행 준비"

AI 자동:
1. 폴더 생성
2. 플롯 분할 (10개)
3. characters.md 추출 (2권 캐릭터)
4. timeline.md 추출 (1947-1952)

완료!
```

### 10.3 2권 1-5화 작성

```
사용자: "1~5화 작성해"

AI 읽기:
✅ CLAUDE.md
✅ vol-02/characters.md
✅ vol-02/timeline.md
✅ settings/writing-guide.md
✅ plots/plot-001-005.md
✅ summaries/summary-vol-01-final.md ⭐ (1권 압축!)

작성:
ch-001~005

생성:
✅ summary-001-005.md (2권)
```

### 10.4 반복

Phase 4 반복...

---

## 11. CLAUDE.md 템플릿

```markdown
# CLAUDE.md - AI 협업 프로토콜

> 프로젝트: [소설 제목]
> 장르: [장르]
> 권수: [N]권
> 작성일: YYYY-MM-DD

---

## 🔴 절대 규칙 (최우선)

1. **세션 시작 시 자동 실행** - 아래 "세션 시작 프로토콜" 무조건 실행
2. **5화 단위 작성** - 항상 5화씩 연속 작성
3. **서머리 자동 업데이트** - 각 화 완료 시 즉시 summary 업데이트
4. **설정 파일 우선** - settings/ 및 vol-XX/ 내용이 최우선
5. **일관성 검증** - 매 화마다 캐릭터/타임라인 체크
6. **마스터 파일 동기화** - 작업 파일 변경 시 마스터도 업데이트

---

## 📋 세션 시작 프로토콜

**세션 시작 시 (사용자 명령 없이) 자동 실행:**

```
1. 이 파일 (CLAUDE.md) 읽기 ✅ (자동)
2. volumes/vol-XX/characters.md 읽기
3. volumes/vol-XX/timeline.md 읽기
4. settings/writing-guide.md 읽기
5. plots/plot-XXX-YYY.md 읽기 (이번 5화)
6. summaries/summary-이전.md 읽기 ⭐
7. summaries/summary-vol-이전-final.md 읽기 (다른 권이면)
8. 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
❌ 복선 누락

---

## 💡 명령어

### 설계:
- "큰 틀 정하자" → Phase 1
- "X권 플롯 작성" → Phase 2

### 실행:
- "실행 준비" → Phase 3
- "1~5화 작성해" → Phase 4

### 유틸:
- "타임라인 검증" → 날짜 체크
- "복선 현황" → 미회수 떡밥
- "캐릭터 상태" → 현재 상태

---

*AI는 이 파일을 항상 우선 읽고 규칙을 준수한다.*
```

---

## 12. Git 자동화

### 12.1 Gitea 설정 정보

```
주소: git.digien25.co.kr
사용자: Alex
토큰: d2ae36cb862375aaab2575fcad5268d276798b2b
```

### 12.2 자동 초기화 (Phase 3)

```bash
# 저장소 초기화
git init
git config user.name "Alex"
git config user.email "alex@digien25.co.kr"

# .gitignore
cat > .gitignore << 'EOF'
# OS
.DS_Store
Thumbs.db

# Editor
.vscode/
.idea/
*.swp

# Temp
*.tmp
~*

# Output
*.pdf
*.docx
EOF

# .gitattributes
cat > .gitattributes << 'EOF'
*.md text eol=lf
*.txt text eol=lf
EOF

# 초기 커밋
git add .
git commit -m "Initial commit: 프로젝트 설정 완료

- 폴더 구조 생성
- 마스터 파일 작성
- 1권 플롯 완성
- 실행 준비 완료

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

# Gitea 연결
git remote add origin https://Alex:d2ae36cb862375aaab2575fcad5268d276798b2b@git.digien25.co.kr/Alex/[프로젝트명].git
git branch -M main
git push -u origin main
```

### 12.3 자동 커밋 규칙

#### 5화 완료 시:
```
git add .
git commit -m "1-5화 작성 완료

- ch-001: 빛 속으로 (10,234자)
- ch-002: 경성에서 (9,876자)
- ch-003: 건준 (11,023자)
- ch-004: 여운형 (10,456자)
- ch-005: 합류 (9,987자)
- summary-001-005.md 생성

총 51,576자

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

git push origin main
```

#### 권 완료 시:
```
git add .
git commit -m "1권 완료

- 50화 전체 완성 (503,456자)
- summary-vol-01-final.md 생성
- 미회수 복선 3개

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

git push origin main
```

### 12.4 브랜치 전략

**단순 전략 (권장):**
```
main (모든 작업)
```

**복잡한 실험 시:**
```
main
├── vol-01 (1권 작업, 완료 후 병합)
└── vol-02 (2권 작업)
```

---

## 13. 토큰 효율 관리

### 13.1 토큰 계산

#### 한글 토큰 비효율:
```
영어: 1단어 = ~1 토큰
한글: 1글자 = ~1.5 토큰

예시:
- "Hello World" (11자) = ~3 토큰
- "안녕하세요" (5자) = ~7.5 토큰
```

#### 파일별 예상 토큰:

| 파일 | 크기 | 토큰 |
|------|------|------|
| CLAUDE.md | ~4,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 |
| summary-vol-01-final.md | ~5,000자 | ~3,000 |

### 13.2 세션별 토큰

#### 1권 첫 세션 (1-5화):
```
읽기:
- CLAUDE.md: 2,000
- characters.md: 2,000
- timeline.md: 2,000
- writing-guide.md: 3,000
- plot-001-005.md: 2,000
━━━━━━━━━━━━━━━━━━━━━
소계: 11,000 토큰

작성:
- 5화 × 10,000자 = 50,000자
- 50,000자 × 1.5 = 75,000 토큰

총: 86,000 토큰 (여유 충분!)
```

#### 1권 중간 세션 (26-30화):
```
읽기:
- CLAUDE.md: 2,000
- characters.md: 2,500 (캐릭터 추가됨)
- timeline.md: 2,500
- writing-guide.md: 3,000
- plot-026-030.md: 2,000
- summary-001-025.md: 10,000 (누적!)
━━━━━━━━━━━━━━━━━━━━━
소계: 22,000 토큰

작성: 75,000 토큰

총: 97,000 토큰 (여전히 OK!)
```

#### 2권 첫 세션 (1-5화):
```
읽기:
- CLAUDE.md: 2,000
- characters.md: 2,000
- timeline.md: 2,000
- writing-guide.md: 3,000
- plot-001-005.md: 2,000
- summary-vol-01-final.md: 3,000 ⭐
━━━━━━━━━━━━━━━━━━━━━
소계: 14,000 토큰

작성: 75,000 토큰

총: 89,000 토큰 (OK!)
```

### 13.3 최적화 전략

#### 서머리 압축:
```
summary-001-050.md (50화 전체):
- 크기: ~50,000자
- 토큰: ~30,000

→ 너무 큼!

summary-vol-01-final.md (압축):
- 크기: ~5,000자
- 토큰: ~3,000

→ 10배 감소! ✅
```

#### 캐릭터 파일 분리:
```
characters-master.md (전체 10권):
- 100명 × 500자 = 50,000자
- 토큰: ~30,000

→ 작성 시 읽지 않음!

characters.md (1권만):
- 20명 × 150자 = 3,000자
- 토큰: ~2,000

→ 15배 감소! ✅
```

---

## 14. 파일 명명 규칙

### 14.1 기본 원칙

**모든 파일/폴더명은 영문 소문자 + 하이픈**

| 대상 | 규칙 | 예시 |
|------|------|------|
| **폴더명** | `kebab-case` | `vol-01`, `character-arcs` |
| **설정 파일** | `kebab-case` | `characters.md`, `writing-guide.md` |
| **챕터 파일** | `ch-NNN.md` | `ch-001.md`, `ch-050.md` |
| **플롯 파일** | `plot-NNN-MMM.md` | `plot-001-005.md` |
| **서머리 파일** | `summary-NNN-MMM.md` | `summary-001-005.md` |

### 14.2 권별 폴더명

```
vol-01  (1권)
vol-02  (2권)
vol-03  (3권)
...
vol-10  (10권)
```

### 14.3 챕터 파일명

```
ch-001.md   (1화)
ch-002.md   (2화)
...
ch-050.md   (50화)
ch-100.md   (100화, 2권 50화)
```

### 14.4 주의사항

```
❌ 한글 파일명: 1권_16화_새로운_가능성.md
✅ 영문 파일명: ch-016.md

❌ 공백: ch 001.md
✅ 하이픈: ch-001.md

❌ 대문자: CH-001.md
✅ 소문자: ch-001.md

❌ CamelCase: plotChapter001.md
✅ kebab-case: plot-001-005.md
```

---

## 15. 부록

### 15.1 전체 명령어 목록

#### 설계:
```
"큰 틀 정하자"
"새 소설 기획"
"/design start"
```

#### 플롯:
```
"1권 플롯 작성"
"/plot vol-01"
```

#### 실행 준비:
```
"실행 준비"
"1권 실행 준비"
"/setup vol-01"
```

#### 작성:
```
"1~5화 작성해"
"ch-001~005 써줘"
"/write 1-5"
```

#### 유틸:
```
"타임라인 검증"
"복선 현황"
"캐릭터 상태"
"/check timeline"
"/check foreshadowing"
"/check characters"
```

### 15.2 FAQ

**Q: 5화 작성 중 컴팩팅 발생하면?**
A: 세션 종료 후 재시작. summary 덕분에 일관성 유지.

**Q: 플롯과 다르게 쓰고 싶으면?**
A: 사용자가 명시적으로 변경 요청. AI가 plot 파일 업데이트.

**Q: 캐릭터 추가는?**
A: AI가 자동으로 vol-XX/characters.md + master 양쪽 업데이트.

**Q: 권 완료 후 수정하려면?**
A: 해당 챕터만 수정 → summary 재생성 → final 재생성.

**Q: Git 충돌 발생하면?**
A: 수동 해결 후 AI에게 "/git status" 보고.

### 15.3 트러블슈팅

**문제: 토큰 초과**
해결:
1. summary 압축 확인
2. 작업 파일 크기 확인
3. 5화 → 3화로 축소

**문제: 일관성 오류**
해결:
1. "타임라인 검증" 실행
2. "캐릭터 상태" 확인
3. summary 재생성

**문제: Git 푸시 실패**
해결:
1. 토큰 만료 확인
2. 네트워크 확인
3. 수동 푸시

---

## 변경 이력

### v3.0 (2026-01-17)
- ✅ **모드 시스템 구축** (핵심!)
  - WRITING: 신규 작성
  - MODIFICATION: 기존 수정
  - VERIFICATION: 전체 점검
  - DISCUSSION: 협의/논의
- ✅ **수정 프로토콜 체계화**
  - Summary 재생성 강제화
  - 타임라인 검증 자동화
  - CHANGELOG 의무화
- ✅ **챕터 형식 표준 문서화**
  - chapter-format-standard.md
  - 헤더 형식 규칙
  - 타임라인 연속성 검증
- ✅ **안전한 리네임 절차**
  - renaming-protocol.md
  - 2단계 리네임
  - 자동화 스크립트
- ✅ **WORK-MODE.txt 시스템**
  - 모드 전환 메커니즘
  - 맥락 손실 방지
  - 컴팩팅 대응

### v2.0 (2026-01-15)
- ✅ 완전 재작성
- ✅ 문서 역할 명확화 (매뉴얼 vs 작업 지시서)
- ✅ 설계/실행 분리
- ✅ 토큰 효율 최우선
- ✅ 5화 작업 단위
- ✅ 누적 서머리
- ✅ Git 자동화
- ✅ Gitea 통합

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

---

## 📌 v3.0 주요 개선 사항

### 문제 해결

**이전 문제:**
```
컴팩팅 → 맥락 손실 → 수정이 이상한 방향으로
→ Summary 누락 → 플롯/본문/서머리 따로 놀음
→ 리네임 시 파일 손실 위험
→ 무엇이 변경되었는지 모름
```

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

### 새로운 파일 구조

```
settings/
├── writing-guide.md              # 작성 규칙 (기존)
├── chapter-format-standard.md    # 챕터 형식 표준 (신규)
├── writing-mode.md               # 작성 모드 절차 (신규)
├── modification-mode.md          # 수정 모드 절차 (신규)
├── verification-mode.md          # 점검 모드 절차 (신규)
└── renaming-protocol.md          # 안전한 리네임 (신규)

volumes/vol-XX/
├── CHANGELOG.md                  # 권별 변경 이력 (신규)
└── WORK-MODE.txt                 # 현재 작업 모드 (임시)
```

### 워크플로우 변화

**작성 모드 (변경 없음):**
```
"1~5화 작성해" → 작성 → summary 누적 → Git
```

**수정 모드 (완전히 새로운 절차):**
```
"수정 준비해" → 계획서 작성 → WORK-MODE.txt 생성
→ [컴팩팅]
→ "수정 실행" → 수정 → summary 재생성 → 타임라인 검증 → CHANGELOG 업데이트 → Git
```

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

---

**작성자:** Alex
**최종 수정:** 2026-01-17
**버전:** 3.0
**라이선스:** 개인 프로젝트