novel-writing-guide/templates/standards/fix-mode.md

# FIX 모드 프로토콜

> **버전:** 1.1.0
> **최종 수정:** 2026-01-20
> **호환:** CWS Writing Guide v3.3.0+
> **용도:** 검증 보고서 기반 일괄 수정
> **주요 변경:** WORK-MODE.txt 시스템 추가 (컴팩팅 대응)

---

## 🔄 컴팩팅 대응 시스템 (v1.1.0 신규)

### 일괄 수정 시 WORK-MODE.txt 사용

**FIX 모드 시작 시:**
```
1. WORK-MODE.txt 파일 생성
---
CURRENT_MODE: FIX
READ_FILE: standards/fix-mode.md
---
SOURCE_REPORT: validation-report-vol-01.md
TOTAL_ISSUES: 45
COMPLETED: 0
NEXT_ISSUE: 1
STATUS: IN_PROGRESS
STARTED: 2026-01-20 16:00
---

2. fix-progress.md 파일 생성 (진행 상황 체크리스트)
```

**각 문제 수정 후:**
```
1. fix-progress.md에 [x] 표시
2. 수정 내용 기록
3. WORK-MODE.txt의 COMPLETED, NEXT_ISSUE 업데이트
4. 파일 저장
5. 다음 문제
```

**컴팩팅 후 재개 시:**
```
1. WORK-MODE.txt 읽기
2. CURRENT_MODE 확인 → FIX
3. READ_FILE 확인 → fix-mode.md (이 파일)
4. SOURCE_REPORT 읽기 → 원본 검증 보고서
5. fix-progress.md 읽기 → 진행 상황 확인
6. NEXT_ISSUE부터 재개
```

**FIX 완료 시:**
```
1. 전체 [x] 확인
2. WORK-MODE.txt 삭제
3. 사용자에게 완료 보고
```

**핵심 원칙:**
```
❌ 전체 문제를 메모리에서 처리 후 한 번에 기록
✅ 1개 수정 → 즉시 파일 업데이트 → WORK-MODE.txt 업데이트 → 다음
```

---

## 📋 FIX 모드 개요

**FIX 모드는:**
- VERIFICATION 모드의 검증 보고서를 기반으로
- 발견된 문제를 **일괄 수정**
- 심각도 순서대로 처리 (🔴 → 🟡 → 🟢)

**핵심 원칙:**
```
VERIFICATION = 발견 + 기록
FIX = 일괄 수정
(분리!)
```

**진입 조건:**
- VERIFICATION 모드 완료 후
- 검증 보고서 존재

**진입 명령:**
- "FIX 모드"
- "수정 진행해"
- "검증 결과 수정해"

---

## 📚 모드 진입 시 읽을 파일

### 필수
1. 검증 보고서 (VERIFICATION 결과)
2. `settings/characters-master.md` - 호칭 수정 시
3. `volumes/vol-XX/timeline.md` - 타임라인 수정 시

### 수정 대상
4. `volumes/vol-XX/chapters/ch-*.md` - 해당 챕터들

---

## 🎯 FIX 모드 워크플로우

```
검증 보고서 읽기
    ↓
심각도별 분류 확인
    ↓
🔴 심각 항목 먼저 처리
    ↓
🟡 중요 항목 처리
    ↓
🟢 경미 항목 처리 (선택)
    ↓
수정 완료 보고
    ↓
Git 커밋
    ↓
POLISH 모드로 전환 (선택)
```

---

## 📝 수정 유형별 처리

### 1. 설정 충돌 수정

```markdown
## 발견 내용
| 위치 | 내용 |
|------|------|
| ch-012:34 | 민준 나이 32→34 불일치 |

## 수정 방법
1. characters-master.md 확인 (정답: 32세)
2. ch-012 열기
3. 34줄 수정: "34세" → "32세"
4. 체크: ✅

## 수정 후
| # | 상태 |
|---|------|
| 1 | ✅ 완료 |
```

### 2. 타임라인 오류 수정

```markdown
## 발견 내용
| 위치 | 내용 |
|------|------|
| ch-025:102 | 5월인데 단풍 묘사 |

## 수정 방법
1. timeline.md 확인 (ch-025 = 1945년 5월)
2. ch-025 열기
3. 102줄 수정: "단풍이 물든" → "신록이 우거진"
4. 체크: ✅
```

### 3. 호칭 오류 수정

```markdown
## 발견 내용
| 위치 | 내용 |
|------|------|
| ch-018:45 | "윤희 씨" → "서 선생님" (시점 이전) |

## 수정 방법
1. characters-master.md 호칭 규칙 확인
2. ch-018 시점 확인 (첫 만남 직후)
3. 45줄 수정: "윤희 씨" → "서 선생님"
4. 체크: ✅
```

### 4. 바텀 제거

```markdown
## 발견 내용
| 챕터 | 바텀 내용 |
|------|----------|
| ch-033 | "[33화 끝]" |
| ch-041 | "[41화 끝]\n다음 42화:" |

## 수정 방법
1. 해당 챕터 열기
2. "[X화 끝]" 패턴 삭제
3. "다음 X화:" 패턴 삭제
4. 체크: ✅
```

### 5. 앞뒤 연결 오류 수정

```markdown
## 발견 내용
| 위치 | 내용 |
|------|------|
| ch-015→ch-016 | 끝: 집에서 / 시작: 사무실에서 (장소 점프) |

## 수정 방법
옵션 A: ch-015 끝에 이동 암시 추가
옵션 B: ch-016 시작에 이동 설명 추가

→ 사용자 선택 또는 자연스러운 쪽으로
```

---

## 📊 수정 진행 보고 형식

```markdown
# FIX 모드 진행 보고

> **수정일:** YYYY-MM-DD
> **검증 보고서 기준:** YYYY-MM-DD

---

## 📊 진행 현황

| 심각도 | 총 건수 | 완료 | 남음 |
|--------|--------|------|------|
| 🔴 심각 | 5 | 5 | 0 |
| 🟡 중요 | 8 | 6 | 2 |
| 🟢 경미 | 3 | 0 | 3 (보류) |
| **합계** | **16** | **11** | **5** |

---

## ✅ 완료된 수정

| # | 위치 | 유형 | 수정 내용 |
|---|------|------|----------|
| 1 | ch-012:34 | 설정 | 나이 34→32 |
| 2 | ch-025:102 | 타임라인 | 단풍→신록 |
| 3 | ch-018:45 | 호칭 | 윤희 씨→서 선생님 |
| ... | | | |

---

## ⏳ 보류/미완료

| # | 위치 | 유형 | 사유 |
|---|------|------|------|
| 1 | ch-005:12 | 날짜 겹침 | 🟢 경미, 추후 처리 |
| ... | | | |

---

## ➡️ 다음 단계

- [x] VERIFICATION 완료
- [x] FIX 완료 (11/16건)
- [ ] POLISH 진행
```

---

## 🔄 일괄 처리 명령

### 바텀 일괄 제거
```
"바텀 일괄 제거해"
→ 검증 보고서의 바텀 목록 기준
→ 모든 해당 챕터에서 바텀 패턴 제거
→ 완료 보고
```

### 호칭 일괄 수정
```
"호칭 일괄 수정해"
→ 검증 보고서의 호칭 오류 목록 기준
→ 각 항목 순차 수정
→ 완료 보고
```

### 심각도별 처리
```
"🔴 항목만 수정해" → 심각 항목만 처리
"🟡까지 수정해" → 심각 + 중요 처리
"전체 수정해" → 모든 항목 처리
```

---

## ✅ FIX 모드 체크리스트

### 수정 전
- [ ] 검증 보고서 확인
- [ ] 총 수정 건수 파악
- [ ] 심각도별 분류 확인
- [ ] Git 현재 상태 확인

### 수정 중
- [ ] 🔴 심각 항목 완료
- [ ] 🟡 중요 항목 완료
- [ ] 🟢 경미 항목 처리 (선택)
- [ ] 각 수정 후 체크 (✅)

### 수정 후
- [ ] 수정 완료 보고 작성
- [ ] 미완료 항목 사유 기록
- [ ] Git 커밋
- [ ] POLISH 모드 전환 여부 결정

---

## 🚫 FIX 모드 금지사항

```
❌ 검증 보고서 없이 수정 시작
❌ 수정하면서 새 문제 발견해도 범위 확장 (→ 다시 VERIFICATION)
❌ 플롯/내용 변경 (→ MODIFICATION 모드에서)
❌ 수정 기록 누락
```

---

## 🔗 연계 모드

```
VERIFICATION (검증, 기록)
    ↓
FIX (일괄 수정) ← 현재
    ↓
POLISH (가독성/문체)
```

---

## 💡 효율적인 FIX 팁

```
1. 같은 유형끼리 묶어서 처리
   - 바텀 제거 → 한번에
   - 호칭 수정 → 한번에

2. 같은 챕터 수정은 한번에
   - ch-012에 3건 있으면 한번에 처리

3. 심각도 순서 지키기
   - 🔴 먼저, 시간 부족하면 🟢은 보류

4. 수정 후 바로 체크
   - 놓치면 다시 찾기 어려움
```

---

*FIX는 검증 결과 기반! 새 문제 발견 시 다시 VERIFICATION!*