# 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 확인이 최우선이다!*