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

> **프로젝트:** 천공의 심장 (Celestial Heart)
> **장르:** 회귀 + 산업 경영 + 하드SF
> **권수:** 10권
> **작성일:** 2026-01-17

---

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

1. **세션 시작 시 자동 실행** - 아래 "세션 시작 프로토콜" 무조건 실행
2. **모드 확인** - WORK-MODE.txt 확인 후 해당 모드 프로토콜 실행 (v3.0)
3. **5화 단위 작성** - 항상 5화씩 연속 작성
4. **서머리 자동 업데이트** - 각 화 완료 시 즉시 summary 업데이트
5. **설정 파일 우선** - settings/ 및 vol-XX/ 내용이 최우선
6. **일관성 검증** - 매 화마다 캐릭터/타임라인 체크
7. **마스터 파일 동기화** - 작업 파일 변경 시 마스터도 업데이트
8. **기술 묘사 정확성** - 공학적 개연성 유지

---

## 📋 세션 시작 프로토콜 (v3.0)

**Step 1: 이 파일 읽기** ✅ (자동)

**Step 2: 모드 확인 (최우선!)** ⭐⭐⭐

```bash
# WORK-MODE.txt 확인
LATEST_VOL=$(ls -d volumes/vol-* 2>/dev/null | sort -V | tail -1)
if [ -f "$LATEST_VOL/WORK-MODE.txt" ]; then
    MODE=$(grep "^MODE:" "$LATEST_VOL/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 푸시
✅ 다음 권 안내
```

---

## 📌 프로젝트 정보

**제목:** 천공의 심장 (Celestial Heart)
**장르:** 회귀 + 산업 경영 + 하드SF
**권수:** 10권
**화/권:** 50화
**분량/화:** 8,000-12,000자
**총 분량:** 약 5,000,000자

**시간 배경:** 1988 - 2026 (38년)

**주인공:** 한세진 (1968년생)
- 회귀 전: 2026년 58세, 항공엔진 엔지니어
- 회귀 후: 1988년 20세, 카이스트 입학

**핵심 줄거리:**
2026년 항공기 엔진 엔지니어 한세진은 사고로 사망 직전 1988년으로 회귀한다. 카이스트 입학을 앞둔 20세 청년으로 돌아간 그는 미래 지식과 엔지니어링 전문성을 바탕으로 금융에서 시작해 소프트웨어, 반도체, 항공엔진, 우주산업을 아우르는 제국을 건설한다. 과정은 논리적이고 개연성 있게, 결과는 머스크와 젠슨 황을 뛰어넘는 성취로.

---

## 🚫 금지 사항

❌ 설정 파일 읽지 않고 작성
❌ 서머리 업데이트 생략
❌ 마스터 파일 동기화 누락
❌ 날짜/나이 오류
❌ 캐릭터 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, 임시)

---

## 🔧 작품 특화 규칙

### 1. 기술 묘사
- **원칙:** "이해는 못해도 그럴듯해야 함"
- **깊이:** 전문 용어 적당히, 원리 설명 간결히
- **예시:**
  ```
  ❌ "터빈 블레이드의 냉각 채널 설계는..."
     (너무 전문적)

  ✅ "고온에서 견디려면 블레이드 안에
     냉각 구멍을 뚫어야 한다. 하지만
     구멍을 뚫으면 강도가 떨어진다."
     (개념 전달 + 갈등)
  ```

### 2. 투자 묘사
- **원칙:** 구체적 종목 X, 방향성만
- **예시:**
  ```
  ❌ "삼성전자를 5만원에 매수했다"
  ✅ "반도체 산업이 성장할 거라
     확신했다. 국내 대표 기업에
     자금을 집중했다."
  ```

### 3. 로맨스 (30%)
- **1권:** 15% (대학 로맨스)
- **2-3권:** 10% (결혼, 가정)
- **4-10권:** 5% (부부, 부모)
- **톤:** 달콤하되 과하지 않게
- **서연의 역할:** 조력자이자 정서적 지지

### 4. 나이 계산 철저
- **세진:** 1968년생
- **서연:** 1969년생
- **도준:** 1995년생
- 매 화마다 현재 연도 확인

---

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

*v3.0에서는 WORK-MODE.txt 확인이 최우선이다!*

*《천공의 심장》은 개연성 있는 기술 서사다!*