/rewrite

name: rewrite
description: "에피소드 재작성(rewrite) 스킬. 설정문서(캐릭터시트, 플롯가이드, 부트스트랩) 변경에 따라 기존 에피소드를 분석하고 재작성한다. '/rewrite', '/revise', '/rewrite {프로젝트명}', '/rewrite EP051', '/rewrite {프로젝트명} EP001-EP010' 으로 실행. '에피소드 재작성', '리바이즈', '리라이트', 'rewrite', 'revise' 모두 트리거. 설정문서가 바뀌어서 에피소드를 다시 써야 할 때, 캐릭터 입체성이 부족해서 대폭 수정이 필요할 때 사용."

Rewrite — 에피소드 재작성 팀 오케스트레이터

설정문서(캐릭터시트·플롯가이드·부트스트랩) 변경에 따라 기존 에피소드를 **분석→재작성→검증**하는 3-Phase 팀.

**프로젝트 독립적**: polish 스킬과 동일한 `novel-config.md`를 읽어 설정문서·가드레일·커스텀 축을 자동 적용한다. 다른 소설 프로젝트에서도 novel-config.md만 작성하면 동일하게 사용 가능.

기존 polish(윤문)와의 차이: 윤문은 문장·표현 레벨의 교정이고, rewrite는 **장면 구성·캐릭터 행동·플롯 비트 레벨의 재작성**이다. 장면을 새로 쓰거나, 캐릭터의 대사·행동을 근본적으로 바꾸거나, 플롯 비트를 재배치하는 작업이다.

---

팀 구조: 생성-검증(Producer-Reviewer) 패턴

Phase 1 (분석 — Agent 2개 병렬 호출)
         ┌→ [revision-analyst]    ── 설정문서↔에피소드 괴리 분석 ─┐
[에피소드] ┤                                                       ├→ [괴리 보고서 + 재작성 설계서]
         └→ [character-sculptor]  ── 캐릭터 입체성 진단           ─┘

Phase 2 (재작성 — 순차)
[괴리 보고서 + 재작성 설계서] → [episode-rewriter] → [재작성된 에피소드]

Phase 3 (검증 — 순차)
[재작성된 에피소드] → [quality-verifier] → PASS / REWRITE → (REWRITE시 Phase 2 재실행)

| 에이전트 | 역할 | Phase | |---------|------|-------| | revision-analyst | 설정문서↔에피소드 괴리 분석. 플롯 비트·수치·시간·자금 흐름·커스텀 축 정합성 | 1 (병렬) | | character-sculptor | 캐릭터 입체성 진단. 경악 방식·비언어·내면·관계망·고유 긴장점 반영도 | 1 (병렬) | | episode-rewriter | 2개 보고서를 통합하여 에피소드를 재작성. CLAUDE.md 집필 규칙 준수 | 2 (순차) | | quality-verifier | 재작성 결과를 설정문서·CLAUDE.md 규칙과 대조 검증 (REWRITE 모드) | 3 (순차) |

---

실행 방법

/rewrite                    ← 기본 프로젝트의 다음 미완료 에피소드부터
/rewrite EP042              ← EP042부터 시작
/rewrite start              ← EP001부터 전체 시작
/rewrite EP027-EP076        ← 특정 범위
/rewrite {프로젝트명}        ← 특정 프로젝트 지정 (예: /rewrite 36억평)
/rewrite {프로젝트명} EP042  ← 특정 프로젝트 + 특정 에피소드

---

자기 반복 루프 (Self-Loop Protocol)

루프 구조

LOOP:
  1. rewrite-plan.md에서 다음 미완료 에피소드 결정
  2. 해당 에피소드에 대해 Phase 1→2→3 실행
  3. rewrite-plan.md 업데이트
  4. rewrite-log.md 업데이트 (주요 변경 기록)
  5. 전체 완료 확인
     - 미완료 있음 → LOOP 반복
     - 전체 완료 → "REWRITE_COMPLETE" 출력하고 아래 후처리 실행:
       1. **fix_plan.md 부분 리셋**: rewrite된 에피소드들의 polish 상태를 리셋한다.
          `{WORK_DIR}/fix_plan.md`가 존재하면, rewrite-plan.md에서 `[x]`로 완료된 EP 목록을 추출하여
          fix_plan.md의 해당 EP를 `[ ] — rewrite 후 재윤문 필요`로 변경한다.
          fix_plan.md가 존재하지 않으면 rewrite된 EP 목록으로 새로 생성한다.

예시: rewrite-plan.md에서 EP027~EP076이 완료됨 → fix_plan.md에서 EP027~EP076을 [ ]로 리셋 → 나머지 EP는 기존 상태 유지

       2. **완료 안내**:

rewrite 완료. `/polish`를 실행하면 rewrite된 에피소드의 문장 품질을 교정합니다. fix_plan.md에서 EP{시작}~EP{끝}이 재윤문 대상으로 리셋되었습니다. rewrite → polish 순서를 권장합니다.

반복 지속 규칙

• **멈추지 않는다**: 에피소드 하나를 끝내면 즉시 다음으로 진행한다.
• **사용자 입력을 기다리지 않는다**: 자동으로 계속한다.
• **종료 조건**: rewrite-plan.md의 모든 항목이 `[x]`일 때만 멈춘다.
• **중단 시 재개**: `/rewrite`를 다시 치면 마지막 미완료 에피소드부터 이어간다.

---

설정문서 변경 영향도 자동 분석 (Rewrite Trigger)

`/rewrite`를 실행하면 Step 0 이후에 **설정문서 변경 분석**을 자동 수행한다. 이전 rewrite 또는 create 시점의 설정문서와 현재 설정문서를 비교하여 rewrite 대상 EP를 자동 결정한다.

변경 분류 기준

| 등급 | 변경 유형 | 예시 | 영향 범위 | |------|----------|------|----------| | **CRITICAL** | 캐릭터 핵심 설정 변경 | 주인공 동기/배경/나이/전문 분야, 빌런 정체성, 주요 관계 설정 | 해당 캐릭터 등장 전 EP부터 전체 | | **CRITICAL** | 수치/타임라인 변경 | 자금 규모, 면적, 시간대, 핵심 날짜 변경 | 해당 수치 첫 언급 EP부터 전체 | | **CRITICAL** | 플롯 비트 재배치 | 아크 구조 변경, EP별 비트 순서 변경 | 변경된 아크의 전체 EP | | **MAJOR** | 캐릭터 상세 설정 변경 | 보이스표 변경, 비언어 태그 변경, 호칭 규칙 변경 | 해당 캐릭터 등장 EP | | **MAJOR** | 가드레일 추가/변경 | 새 가드레일 항목 추가, 기존 항목 수정 | 전체 EP 재검증 | | **MINOR** | 문구 다듬기 | 설정 문서의 표현 수정, 오탈자, 포맷 변경 | rewrite 불필요 | | **MINOR** | 보조 참조 변경 | verification 문서 업데이트, 가이드 문구 수정 | rewrite 불필요 |

자동 분석 프로세스

1. 설정문서 변경 감지:
   - `{DESIGN_DIR}/` 내 설정문서의 변경 확인 (아래 우선순위):
     1. git repo인 경우: `git diff` 사용
     2. git repo가 아닌 경우: `{REWRITE_WORK_DIR}/.design-hashes` 파일과 현재 파일의 SHA256 해시 비교
     3. `.design-hashes` 파일이 없으면: 모든 설정문서를 "변경됨"으로 간주하고 사용자에게 확인
   - 변경 감지 후 `.design-hashes`를 현재 해시로 갱신
   - 변경이 없으면: "설정문서 변경 없음. 수동 rewrite 모드로 진행합니다." 안내 후 Step 1로

2. 변경 내용 분류:
   - 각 변경 항목을 CRITICAL/MAJOR/MINOR로 분류
   - MINOR만 있으면: "설정문서 변경이 경미하여 rewrite가 불필요합니다. 그래도 진행하시겠습니까?" 확인
   - CRITICAL/MAJOR 있으면: 영향 받는 EP 범위를 자동 산출

3. 사용자에게 분석 결과 제시:

설정문서 변경 분석

CRITICAL 변경 (N건)

• {변경 내용}: EP{시작}-EP{끝} 영향

MAJOR 변경 (N건)

• {변경 내용}: EP{시작}-EP{끝} 영향

MINOR 변경 (N건) — rewrite 불필요

• {변경 내용}

권장 rewrite 범위: EP{시작}-EP{끝}

이 범위로 진행하시겠습니까? (범위 조정 가능)

4. 사용자 확인 후 rewrite-plan.md를 생성하고 Step 1로 진행

---

워크플로우 상세

Step 0: 초기화 (최초 1회)

1. 프로젝트 결정
   - $ARGUMENTS에서 프로젝트명 추출 (예: "36억평")
   - 프로젝트명 지정 없으면: 프로젝트 디렉토리 탐색하여 novel-config.md가 있는 디렉토리 자동 감지
   - novel-config.md가 여러 개면: 사용자에게 선택 요청
   - novel-config.md가 없으면: ${CLAUDE_PLUGIN_ROOT}/skills/polish/references/project-config-template.md 안내 후 종료

2. novel-config.md 로드 및 **필수 필드 검증 게이트**
   - {PROJECT_DIR}/novel-config.md 읽기
   - **즉시 필수 필드 검증** (하나라도 누락 시 에러 출력 후 종료):

필수 필드 체크리스트:

• [ ] project.target_platform — 플랫폼명
• [ ] project.episode_dir — 에피소드 저장 디렉토리
• [ ] project.design_dir — 설계문서 디렉토리 (설정문서 변경 감지에 필요)
• [ ] 설정문서 매핑.bootstrap — 부트스트랩 경로 (파일 존재 확인)
• [ ] 설정문서 매핑.character_core — 캐릭터 핵심 경로 (파일 존재 확인)
• [ ] 설정문서 매핑.character_detail — 캐릭터 상세 경로 (파일 존재 확인)
• [ ] EP 범위별 플롯 가이드 — 최소 1개 행 존재 (파일 존재 확인)

     검증 실패 시:

❌ novel-config.md 필수 필드 누락: {누락 필드 목록} rewrite 스킬을 실행하려면 위 필드를 채워주세요. 템플릿: ${CLAUDE_PLUGIN_ROOT}/skills/polish/references/project-config-template.md

   - **target_platform 허용 집합 검증**:
     - `project.target_platform`은 문피아, 네이버시리즈, 카카오페이지, 리디, 조아라, 노벨피아 중 하나여야 한다
     - rewrite 스킬은 novel-config.md의 canonical 값만 사용하며 자동 매핑하지 않는다
     - 비지원 값이면 에러 출력 후 종료:

❌ 허용되지 않는 target_platform: {현재값} novel-config.md의 project.target_platform을 허용 플랫폼명으로 수정해주세요.

   - 설정문서 경로 매핑 추출 → {CONFIG} 변수로 저장
   - 보존 가드레일 추출 → {GUARD_RAILS}
   - Rewrite 전용