# 챕터 작성 표준 형식

> **작성일:** 2026-01-17
> **버전:** 1.0
> **용도:** 챕터 파일 헤더 및 구조 표준

---

## 📐 필수 헤더 형식

### 기본 형식

```markdown
# [권수]권 [화수]화: [제목]

> **타임라인:** YYYY.M.D-M.D
> **장소:** 장소1, 장소2
> **등장인물:** A, B, C (선택)

---

## Part 1: [소제목]
...
```

### 예시 (올바른 형식)

```markdown
# 2권 29화: 만주 특별구 출범

> **타임라인:** 1950.3.11-4.1
> **장소:** 만주 연길
> **등장인물:** 최태준, 강민준, 조선족 주민들

---

## Part 1: 출범 준비
...

## Part 2: 4월 1일 출범식
...
```

---

## ✅ 검증 규칙

### 1. 제목 라인

**형식:** `# [권수]권 [화수]화: [제목]`

**규칙:**
- ✅ 권 번호 필수 (예: "2권")
- ✅ 화수 숫자만 (예: "29화", not "이십구화")
- ✅ 콜론(`:`) 뒤 공백 1칸
- ✅ 제목은 간결하고 명확하게

**올바른 예:**
```
✅ # 2권 29화: 만주 특별구 출범
✅ # 1권 1화: 빛 속으로
✅ # 3권 45화: 반도체 혁명
```

**잘못된 예:**
```
❌ # ch-029: 만주 개발 시작
   → "ch-" 형식 금지, 권 번호 누락

❌ # 29화: 만주 개발 시작
   → 권 번호 누락

❌ # 2권 29화 : 제목
   → 콜론 앞 공백 금지

❌ # 2권 이십구화: 제목
   → 화수는 숫자만
```

### 2. 타임라인

**형식:** `> **타임라인:** YYYY.M.D-M.D`

**규칙:**
- ✅ 연도 4자리, 월/일 1-2자리
- ✅ 구분자: 점(`.`)
- ✅ 기간: 하이픈(`-`)
- ✅ 단일 날짜: `YYYY.M.D`만

**올바른 예:**
```
✅ > **타임라인:** 1950.3.11-4.1
✅ > **타임라인:** 1947.1.1
✅ > **타임라인:** 1950.5.1-12.31
```

**잘못된 예:**
```
❌ > **타임라인:** 1950-3-11~4-1
   → 구분자 잘못됨

❌ > **타임라인:** 1950/3/11-4/1
   → 슬래시 금지

❌ > **타임라인:** 1950.03.11-04.01
   → 0 패딩 불필요
```

### 3. 타임라인 연속성 (매우 중요!)

**규칙:**
- ✅ 이전 화 종료일 ≤ 현재 화 시작일
- ✅ 시간 역행 금지
- ✅ 날짜 겹침 최소화

**체크 절차:**
```
ch-028: 1950.3.11-4.1 (종료: 4.1)
ch-029: 1950.4.2-4.30 (시작: 4.2) ← 4.1 이후 ✅

ch-028: 1950.3.11-4.1 (종료: 4.1)
ch-029: 1950.5.1-12.31 (시작: 5.1) ← 4.1 이후 ✅

ch-029: 1950.5.1-12.31 (종료: 12.31)
ch-030: 1950.4.1-4.30 (시작: 4.1) ← 과거로! ❌❌❌
```

**예외: 플래시백/회상**
```
✅ > **타임라인:** 1950.5.1 (회상: 1947.6.1)
✅ > **타임라인:** 1955.1.1 (회고: 1945-1950)
```

### 4. 제목 유니크성

**규칙:**
- ✅ 동일 권 내 제목 중복 금지
- ✅ 유사 제목 주의

**잘못된 예:**
```
ch-029: "만주 개발 시작"
ch-030: "만주 개발 시작" ← 완전 중복! ❌

해결:
ch-029: "만주 개발 준비"
ch-030: "만주 개발 시작" ✅
```

### 5. 장소

**형식:** `> **장소:** 장소1, 장소2`

**규칙:**
- ✅ 주요 장소만 (1-3개)
- ✅ 쉼표(`,`) 구분
- ✅ 구체적으로

**올바른 예:**
```
✅ > **장소:** 만주 연길
✅ > **장소:** 서울, 청와대
✅ > **장소:** 도쿄 긴자 거리
```

### 6. 등장인물 (선택)

**형식:** `> **등장인물:** A, B, C`

**규칙:**
- ✅ 주요 인물만 (1-5명)
- ✅ 쉼표 구분
- ✅ 생략 가능

---

## 📝 본문 구조

### Part 구성

```markdown
## Part 1: 새해 아침

(2-4문단)

---

## Part 2: 가족 대화

(3-5문단)

---

## Part 3: 회상

(2-3문단)

---
```

**권장:**
- Part 4-6개 (1화당)
- Part당 2-5문단
- Part 사이 `---` 구분선

---

## 🔍 작성 전 체크리스트

### 새 챕터 작성 시

- [ ] 이전 화 종료 날짜 확인
- [ ] 타임라인 연속성 확인
- [ ] 제목 중복 없는지 확인
- [ ] 헤더 형식 올바른지 확인
- [ ] plot-XXX-YYY.md와 일치하는지 확인

### 기존 챕터 수정 시

- [ ] 타임라인 변경했다면 전후 챕터 확인
- [ ] 제목 변경했다면 중복 없는지 확인
- [ ] summary 재생성 필요한지 확인

---

## 🚨 자주 발생하는 오류

### 1. 형식 오류 (헤더)

```
❌ # ch-029: 제목
❌ # 29화: 제목
❌ # 2권 29화 :제목
❌ # 2권 이십구화: 제목

✅ # 2권 29화: 제목
```

### 2. 타임라인 역순

```
ch-029: 1950.5.1-12.31
ch-030: 1950.4.1-4.30 ← 과거로! ❌

해결: 순서 바꾸기 또는 날짜 조정
```

### 3. 제목 중복

```
ch-029: "만주 개발 시작"
ch-030: "만주 개발 시작" ← 중복! ❌

해결: 제목 차별화
ch-029: "만주 개발 준비"
ch-030: "만주 개발 시작"
```

### 4. 타임라인 형식 오류

```
❌ 1950-3-11
❌ 1950/3/11
❌ 1950.03.11 (0 패딩 불필요)

✅ 1950.3.11
```

---

## 📊 검증 명령어

### 자동 검증 (AI)

```
"헤더 형식 검증해"
"타임라인 연속성 검증해"
"제목 중복 검증해"
```

### 수동 검증 (Bash)

```bash
# 헤더 형식 확인
grep "^# " chapters/*.md

# 타임라인 추출
grep "타임라인:" chapters/*.md | sort

# 제목 중복 확인
grep "^# " chapters/*.md | cut -d: -f2 | sort | uniq -d
```

---

## 📌 참고 파일

- **작성 규칙:** `settings/writing-guide.md`
- **수정 절차:** `settings/modification-mode.md`
- **타임라인 검증:** `volumes/vol-XX/timeline.md`

---

**버전:** 1.0
**최종 수정:** 2026-01-17
**작성자:** Alex + Claude Sonnet 4.5