6c41abc581
## Added - polish-mode.md v2.2.0: 플랫폼 가독성 최적화 - 7번 항목 "플랫폼 가독성" 신규 추가 - 문단 사이 빈 줄 일관성 체크 - 대화 구분 명확성 (대화 블록 전후 빈 줄) - 모바일 화면 최적화 (짧은 문단 + 여백) - Part/Scene 구분 규칙 ## Changed - 문단 길이 기준 수정: - 기존: 10줄 이상 → 분리 권장 - 변경: 3-5줄 권장, 7줄 이상 검토, 10줄 이상 필수 분리 - 웹소설 플랫폼 특성 반영 (문피아/카카오페이지/네이버 시리즈) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
484 lines
10 KiB
Markdown
484 lines
10 KiB
Markdown
# POLISH 모드 프로토콜
|
|
|
|
> **버전:** 2.2.0
|
|
> **최종 수정:** 2026-01-20
|
|
> **호환:** CWS Writing Guide v3.3.0+
|
|
> **용도:** 문장 품질 다듬기 (내용 수정 없음)
|
|
> **주요 변경:** 웹소설 플랫폼 가독성 최적화 (문피아/카카오페이지 기준)
|
|
|
|
---
|
|
|
|
## 🔄 컴팩팅 대응 시스템 (v2.0.0 신규)
|
|
|
|
### 배치 작업 시 WORK-MODE.txt 사용
|
|
|
|
**배치 시작 시:**
|
|
```
|
|
1. WORK-MODE.txt 파일 생성
|
|
---
|
|
CURRENT_MODE: POLISH
|
|
READ_FILE: standards/polish-mode.md
|
|
---
|
|
BATCH: 01
|
|
RANGE: ch-001 ~ ch-010
|
|
STATUS: IN_PROGRESS
|
|
LAST_COMPLETED: none
|
|
NEXT: ch-001
|
|
REPORT_FILE: polish-batch-01.md
|
|
STARTED: 2026-01-20 15:30
|
|
---
|
|
|
|
2. polish-batch-01.md 파일 생성 (진행 상황 체크리스트)
|
|
```
|
|
|
|
**각 챕터 완료 후:**
|
|
```
|
|
1. polish-batch-01.md에 [x] 표시
|
|
2. 챕터별 상세 내용 추가
|
|
3. WORK-MODE.txt의 LAST_COMPLETED, NEXT 업데이트
|
|
4. 파일 저장
|
|
5. 다음 챕터
|
|
```
|
|
|
|
**컴팩팅 후 재개 시:**
|
|
```
|
|
1. WORK-MODE.txt 읽기
|
|
2. CURRENT_MODE 확인 → POLISH
|
|
3. READ_FILE 확인 → polish-mode.md (이 파일)
|
|
4. REPORT_FILE 읽기 → polish-batch-01.md
|
|
5. 진행 상황 체크리스트 확인
|
|
6. NEXT 챕터부터 재개
|
|
```
|
|
|
|
**배치 완료 시:**
|
|
```
|
|
1. 전체 [x] 확인
|
|
2. WORK-MODE.txt 삭제
|
|
3. 사용자에게 완료 보고
|
|
```
|
|
|
|
**핵심 원칙:**
|
|
```
|
|
❌ 10개 전부 메모리에 저장 후 한 번에 파일 작성
|
|
✅ 1개 완료 → 즉시 파일 업데이트 → WORK-MODE.txt 업데이트 → 다음
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 POLISH 모드 개요
|
|
|
|
**POLISH 모드는:**
|
|
- **문장 품질만** 개선 (내용/플롯 수정 없음!)
|
|
- 가독성, 리듬감, 문체 일관성 체크
|
|
- VERIFICATION → FIX 완료 후 최종 다듬기
|
|
|
|
**핵심 원칙:**
|
|
```
|
|
VERIFICATION = 모든 문제 발견 (플롯 포함)
|
|
FIX = 발견된 문제 수정
|
|
POLISH = 문장 품질만 다듬기 (오타, 가독성, 문체)
|
|
(엄격 분리!)
|
|
```
|
|
|
|
**금지:**
|
|
```
|
|
❌ 장면 추가/삭제
|
|
❌ 인과관계 수정
|
|
❌ 캐릭터 관계 변경
|
|
❌ 설정 변경
|
|
→ 이런 건 VERIFICATION → FIX에서!
|
|
```
|
|
|
|
**진입 조건:**
|
|
- VERIFICATION → FIX 완료 후 (권장)
|
|
- 또는 독립적으로 실행 가능
|
|
|
|
**진입 명령:**
|
|
- "POLISH 모드"
|
|
- "다듬기"
|
|
- "가독성 검토해"
|
|
- "문체 검토해"
|
|
|
|
---
|
|
|
|
## 📚 모드 진입 시 읽을 파일
|
|
|
|
### 필수
|
|
1. `standards/writing-guide.md` - 문체 기준
|
|
2. `settings/characters-master.md` - 캐릭터 말투
|
|
|
|
### 검토 대상
|
|
3. `volumes/vol-XX/chapters/ch-*.md` - 해당 챕터들
|
|
|
|
---
|
|
|
|
## 🎯 POLISH 체크 항목
|
|
|
|
### 1. 문장 가독성
|
|
|
|
```
|
|
✅ 문장 길이
|
|
- 한 문장 50자 이상 → 분리 권장
|
|
- 3줄 이상 문장 → 🔴 분리 필요
|
|
|
|
✅ 문단 길이 (웹소설 기준)
|
|
- 권장: 3-5줄 (모바일 화면 최적)
|
|
- 7줄 이상 → 🟡 분리 검토
|
|
- 10줄 이상 → 🔴 필수 분리
|
|
- 1-2줄 짧은 문단 OK (호흡 공간)
|
|
|
|
✅ 복문 구조
|
|
- ~하고, ~하며, ~해서 3개 이상 연결 → 분리
|
|
```
|
|
|
|
### 2. 반복 표현
|
|
|
|
```
|
|
✅ 문장 끝 반복
|
|
- "~했다" 3회 연속 → 🟡 변경 권장
|
|
- "~였다" 3회 연속 → 🟡 변경 권장
|
|
|
|
✅ 주어 반복
|
|
- "그는" / "그녀는" 연속 → 생략 또는 이름으로
|
|
|
|
✅ 단어 반복
|
|
- 같은 단어 한 문단에 3회 이상 → 유의어로 대체
|
|
|
|
✅ 접속사 반복
|
|
- "그리고" / "하지만" 연속 → 다양화
|
|
```
|
|
|
|
### 3. 대화/묘사 비율
|
|
|
|
```
|
|
✅ 권장 비율
|
|
대화 : 묘사 : 서술 = 40 : 40 : 20
|
|
|
|
✅ 불균형 체크
|
|
- 대화만 1페이지 이상 → 🟡 묘사/서술 추가
|
|
- 묘사만 1페이지 이상 → 🟡 대화 추가
|
|
- 서술만 1페이지 이상 → 🟡 장면화 고려
|
|
```
|
|
|
|
### 4. 문체 일관성
|
|
|
|
```
|
|
✅ 시제 일관성
|
|
- 과거형 기조 유지
|
|
- 갑자기 현재형 전환 → 🟡 수정
|
|
|
|
✅ 문어체/구어체
|
|
- 지문: 문어체 유지
|
|
- 대화: 캐릭터별 구어체
|
|
|
|
✅ 어미 다양성
|
|
- ~다, ~였다, ~했다 균형
|
|
```
|
|
|
|
### 5. 리듬감
|
|
|
|
```
|
|
✅ 문장 길이 변화
|
|
- 짧은 문장 → 긴 문장 → 짧은 문장
|
|
- 같은 길이 5문장 연속 → 🟢 변화 권장
|
|
|
|
✅ 긴장/이완
|
|
- 액션 장면: 짧은 문장
|
|
- 여유 장면: 긴 문장
|
|
```
|
|
|
|
### 6. 어색한 표현
|
|
|
|
```
|
|
✅ 조사 오류
|
|
- 을/를, 이/가, 은/는 체크
|
|
|
|
✅ 어색한 어순
|
|
- 자연스러운 한국어 어순
|
|
|
|
✅ 번역체
|
|
- "~라는 것을" → "~라는 걸"
|
|
- "그것은" → "그건"
|
|
```
|
|
|
|
### 7. 플랫폼 가독성 (v2.2.0 신규)
|
|
|
|
```
|
|
⭐ 웹소설 플랫폼 최적화 (문피아/카카오페이지/네이버 시리즈)
|
|
|
|
✅ 문단 사이 빈 줄 일관성
|
|
- 기본 원칙: 모든 문단 사이 빈 줄 1개
|
|
- Part 구분: 빈 줄 2개
|
|
- 현재 문제: 파일마다 다름 → 🔴 통일 필수
|
|
|
|
예시:
|
|
```
|
|
민준은 창밖을 바라보았다. 해방된 서울이 보였다.
|
|
|
|
"이제 시작이야."
|
|
|
|
그가 중얼거렸다.
|
|
```
|
|
|
|
✅ 대화 구분 명확성
|
|
- 대화 블록 전: 빈 줄 1개
|
|
- 대화 블록 후: 빈 줄 1개
|
|
- 연속 대화: 빈 줄 없이 연결
|
|
|
|
예시:
|
|
```
|
|
민준은 눈을 감았다.
|
|
|
|
"뭐라고?"
|
|
"네가 들은 대로야."
|
|
"믿을 수 없어."
|
|
|
|
침묵이 흘렀다.
|
|
```
|
|
|
|
✅ 모바일 화면 최적화
|
|
- 세로 스크롤 중심 (좁은 화면)
|
|
- 긴 문단 → 피로감 증가
|
|
- 짧은 문단 + 빈 줄 → 숨 쉬는 공간
|
|
- 빠른 스크롤 → 명확한 구분 필요
|
|
|
|
✅ 여백 활용
|
|
- 긴 장면 후: 빈 줄로 호흡
|
|
- 시점 전환: 빈 줄 2개
|
|
- 시간 경과: 빈 줄 + "---" + 빈 줄 (선택)
|
|
- 액션 → 대화: 명확한 빈 줄
|
|
|
|
✅ Part/Scene 구분
|
|
- Part 전환: 빈 줄 3개 (또는 "---" 구분선)
|
|
- Scene 전환: 빈 줄 2개
|
|
- 일반 문단: 빈 줄 1개
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 POLISH 보고서 형식
|
|
|
|
```markdown
|
|
# POLISH 보고서
|
|
|
|
> **검토일:** YYYY-MM-DD
|
|
> **검토 범위:** ch-001 ~ ch-050
|
|
|
|
---
|
|
|
|
## 📊 요약
|
|
|
|
| 항목 | 발견 건수 | 수정 |
|
|
|------|----------|------|
|
|
| 1. 문장 가독성 | X건 | ✅/⏳ |
|
|
| 2. 반복 표현 | X건 | ✅/⏳ |
|
|
| 3. 대화/묘사 비율 | X건 | ✅/⏳ |
|
|
| 4. 문체 일관성 | X건 | ✅/⏳ |
|
|
| 5. 리듬감 | X건 | ✅/⏳ |
|
|
| 6. 어색한 표현 | X건 | ✅/⏳ |
|
|
| 7. 플랫폼 가독성 ⭐ | X건 | ✅/⏳ |
|
|
| **총계** | **X건** | |
|
|
|
|
---
|
|
|
|
## 🔴 필수 수정
|
|
|
|
| # | 위치 | 유형 | 내용 | 수정 |
|
|
|---|------|------|------|------|
|
|
| 1 | ch-005:34-36 | 문장 길이 | 3줄 문장 | → 2문장으로 분리 |
|
|
| 2 | ch-012:45-50 | 반복 | "했다" 5회 연속 | → 어미 다양화 |
|
|
|
|
---
|
|
|
|
## 🟡 권장 수정
|
|
|
|
| # | 위치 | 유형 | 내용 | 수정 제안 |
|
|
|---|------|------|------|----------|
|
|
| 1 | ch-008:22-35 | 대화 과다 | 대화만 15줄 | 중간에 묘사 추가 |
|
|
| 2 | ch-015:67 | 번역체 | "그것은" | → "그건" |
|
|
|
|
---
|
|
|
|
## 🟢 선택 수정
|
|
|
|
| # | 위치 | 유형 | 내용 |
|
|
|---|------|------|------|
|
|
| 1 | ch-003:12-16 | 리듬 | 비슷한 길이 5문장 |
|
|
|
|
---
|
|
|
|
## 📈 통계
|
|
|
|
### 문장 길이 분포
|
|
- 20자 이하: XX%
|
|
- 21-40자: XX%
|
|
- 41-60자: XX%
|
|
- 60자 이상: XX% (→ 분리 권장)
|
|
|
|
### 문장 끝 어미 분포
|
|
- ~했다: XX%
|
|
- ~였다: XX%
|
|
- ~이다: XX%
|
|
- 기타: XX%
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 POLISH 수정 예시
|
|
|
|
### 긴 문장 분리
|
|
|
|
```
|
|
Before:
|
|
"민준은 창밖을 바라보며 지난 몇 년간 자신이 걸어온 길을
|
|
되돌아보았는데, 그 과정에서 수많은 사람들을 만났고,
|
|
때로는 그들과 갈등을 빚기도 했지만, 결국에는 모두가
|
|
같은 목표를 향해 나아가고 있다는 것을 깨달았다."
|
|
|
|
After:
|
|
"민준은 창밖을 바라보았다. 지난 몇 년간 걸어온 길이
|
|
떠올랐다. 수많은 사람들을 만났다. 때로는 갈등을 빚기도
|
|
했다. 하지만 결국 모두가 같은 목표를 향하고 있었다."
|
|
```
|
|
|
|
### 반복 표현 수정
|
|
|
|
```
|
|
Before:
|
|
"민준이 말했다. 윤희가 대답했다. 태준이 끼어들었다.
|
|
민준이 다시 말했다."
|
|
|
|
After:
|
|
"민준이 입을 열었다. 윤희가 고개를 끄덕였다. 태준이
|
|
끼어들었다. 민준은 잠시 생각하다 다시 말했다."
|
|
```
|
|
|
|
### 대화/묘사 균형
|
|
|
|
```
|
|
Before:
|
|
"뭐라고?"
|
|
"네가 들은 대로야."
|
|
"믿을 수 없어."
|
|
"믿든 말든."
|
|
"하지만..."
|
|
"더 이상 말해도 소용없어."
|
|
|
|
After:
|
|
"뭐라고?"
|
|
민준의 눈이 커졌다. 믿기 어려웠다.
|
|
"네가 들은 대로야."
|
|
윤희는 담담했다. 창밖을 바라보는 눈빛이 차가웠다.
|
|
"믿을 수 없어."
|
|
"믿든 말든." 윤희가 어깨를 으쓱했다.
|
|
"더 이상 말해도 소용없어."
|
|
```
|
|
|
|
---
|
|
|
|
## 🔄 POLISH 워크플로우
|
|
|
|
```
|
|
1. 범위 설정 (1권 전체 또는 특정 챕터)
|
|
↓
|
|
2. 체크 항목별 검토
|
|
↓
|
|
3. 🔴 필수 수정 처리
|
|
↓
|
|
4. 🟡 권장 수정 처리
|
|
↓
|
|
5. 🟢 선택 수정 (시간 여유 시)
|
|
↓
|
|
6. 보고서 작성
|
|
↓
|
|
7. Git 커밋
|
|
```
|
|
|
|
---
|
|
|
|
## ✅ POLISH 체크리스트
|
|
|
|
### 문장 가독성
|
|
- [ ] 50자 이상 문장 분리
|
|
- [ ] 7줄 이상 문단 검토, 10줄 이상 필수 분리
|
|
- [ ] 복문 구조 단순화
|
|
|
|
### 반복 표현
|
|
- [ ] 문장 끝 어미 다양화
|
|
- [ ] 주어 반복 해소
|
|
- [ ] 단어 반복 해소
|
|
|
|
### 대화/묘사 비율
|
|
- [ ] 40:40:20 근접
|
|
- [ ] 대화만 구간 없음
|
|
- [ ] 묘사만 구간 없음
|
|
|
|
### 문체 일관성
|
|
- [ ] 시제 일관
|
|
- [ ] 문어체/구어체 구분
|
|
- [ ] 어미 다양
|
|
|
|
### 리듬감
|
|
- [ ] 문장 길이 변화
|
|
- [ ] 장면에 맞는 템포
|
|
|
|
### 어색한 표현
|
|
- [ ] 조사 정확
|
|
- [ ] 어순 자연스러움
|
|
- [ ] 번역체 제거
|
|
|
|
### 플랫폼 가독성 ⭐
|
|
- [ ] 문단 사이 빈 줄 일관성 (기본 1개, Part 2개)
|
|
- [ ] 대화 구분 명확성 (대화 블록 전후 빈 줄)
|
|
- [ ] 모바일 화면 최적 (짧은 문단 + 여백)
|
|
- [ ] Part/Scene 구분 명확 (빈 줄 개수 통일)
|
|
|
|
---
|
|
|
|
## 🚫 POLISH 모드 금지사항
|
|
|
|
```
|
|
❌ 스토리 변경 (→ MODIFICATION 모드)
|
|
❌ 설정 수정 (→ FIX 모드)
|
|
❌ 캐릭터 성격 변경
|
|
❌ 플롯 추가/삭제
|
|
❌ 과도한 수정 (원문의 맛 유지)
|
|
```
|
|
|
|
---
|
|
|
|
## 🔗 연계 모드
|
|
|
|
```
|
|
VERIFICATION (검증, 기록)
|
|
↓
|
|
FIX (일괄 수정)
|
|
↓
|
|
POLISH (가독성/문체) ← 현재
|
|
↓
|
|
완료!
|
|
```
|
|
|
|
---
|
|
|
|
## 💡 POLISH 팁
|
|
|
|
```
|
|
1. 소리 내어 읽어보기
|
|
- 막히는 부분 = 수정 필요
|
|
|
|
2. 한 번에 한 유형씩
|
|
- 반복 표현만 → 문장 길이만 → 리듬만
|
|
|
|
3. 과도한 수정 주의
|
|
- 작가의 문체 유지
|
|
- 모든 문장을 완벽하게 할 필요 없음
|
|
|
|
4. 핵심 장면 우선
|
|
- 클라이맥스, 감정 장면 먼저 다듬기
|
|
```
|
|
|
|
---
|
|
|
|
*POLISH는 문장 품질! 스토리는 건드리지 않음!*
|