Create

에피소드 창작 오케스트레이터

설정문서(캐릭터시트·플롯가이드·부트스트랩)에 따라 에피소드를 순차 창작하는 4-에이전트 파이프라인.

아키텍처

Phase 1 (병렬)              Phase 2 (순차)          Phase 3 (순차)
┌──────────────────┐       ┌──────────────┐       ┌──────────────┐
│ episode-architect│──┐    │  episode-    │       │  quality-    │
│ (설계도 추출)      │  ├──▶│  creator     │──────▶│  verifier    │
└──────────────────┘  │    │  (본문 집필)   │       │  (7축 검증)   │
┌──────────────────┐  │    └──────────────┘       └──────┬───────┘
│ continuity-bridge│──┘          ◀── REWRITE (max 2) ───┘
│ (연속성 수집)      │                     │
└──────────────────┘             PASS ───▶ 다음 EP

실행 모드: 서브 에이전트 (파이프라인 패턴, lint/revise와 동일)

• 이유: 각 Phase가 이전 Phase 출력에 순차 의존, 에이전트 간 실시간 통신 불필요

전제 조건

1. novel-config.md 존재 (프로젝트 디렉토리 내)
2. 설정문서 존재: 부트스트랩, 캐릭터시트(core+detail+dialogue DNA), 플롯가이드
3. 에피소드 디렉토리 존재 (episode_dir in novel-config.md)

novel-config.md가 없으면 에러를 출력하고 종료한다.

인자 파싱

실행 흐름

Step 0: 초기화

0. novel-config.md 필수 필드 검증 게이트: novel-config.md를 로드한 직후, 아래 필수 필드가 모두 존재하고 비어있지 않은지 검증한다. 하나라도 누락되면 에러를 출력하고 즉시 종료한다.

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

   검증 실패 시 출력:

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

0.5 target_platform 허용 집합 검증 게이트:

• novel-config.md의 project.target_platform은 아래 canonical name 중 하나여야 한다:
  • 문피아, 네이버시리즈, 카카오페이지, 리디, 조아라, 노벨피아
• create 스킬은 novel-config.md에 저장된 canonical 값만 사용한다. 별칭 정규화나 자동 치환은 수행하지 않는다.
• 비지원 값이면 에러를 출력하고 즉시 종료한다.

❌ 허용되지 않는 target_platform: {현재값}

허용 플랫폼:
- 문피아
- 네이버시리즈
- 카카오페이지
- 리디
- 조아라
- 노벨피아

novel-config.md의 project.target_platform을 허용 플랫폼명으로 수정한 뒤 다시 실행해주세요.

1. novel-config.md를 파싱한다:

   {CONFIG}       ← novel-config.md 전체
   {TARGET_PLATFORM} ← config.target_platform
   {DESIGN_DIR}   ← config.design_dir
   {EPISODE_DIR}  ← config.episode_dir
   {WORK_DIR}     ← config.work_dir
   {GUARD_RAILS}  ← config.guard_rails + config.create_guard_rails (있으면)
   {CUSTOM_AXES}  ← config.custom_axes (있으면)
   {CREATE_CFG}   ← config.create 설정 (있으면, 없으면 기본값)

2. 기본값 ([create] 섹션 없을 때):

   draft_chars: 6000-10000           # Phase 2 초안 목표 (넉넉하게 작성)
   final_chars: 5000-8000            # Step 2.5 트리밍 후 최종 목표
   dialogue_ratio: 40-60%
   max_scenes: 4
   hook_targets:
     opening_intensity: 4
     ending_intensity: 5
   continuity_lookback: 2

   분량 전략: "넘치게 쓰고 줄이기" episode-creator는 draft_chars(6000-10000자) 목표로 초안을 작성한다. Step 2.5에서 오케스트레이터가 final_chars(5000-8000자)로 트리밍한다. 이유: 부족해서 살을 붙이면 품질이 낮아진다. 충분히 쓰고 불필요한 부분을 삭제해야 밀도가 높아진다.

3. EP 범위 결정:

   • 지정 EP가 있으면 해당 범위 사용
   • 없으면 {EPISODE_DIR}에서 마지막 EP 번호를 찾고, 다음 번호부터 시작
   • 종료 EP를 지정하지 않으면 1화만 창작 (무한 루프 방지)

4. EP 범위에 따른 설정문서 매핑:

   • novel-config.md의 ep_range_table에서 해당 EP가 속하는 act 확인
   • EP 범위 중첩 검출: ep_range_table의 모든 행을 순회하여 범위가 겹치는 행이 있는지 확인. 중첩 발견 시 경고를 출력하고 사용자에게 확인
   • 해당 act의 플롯가이드 결정:
     • 세부 플롯 가이드 열에 경로가 있고 파일이 존재하면 → {PLOT_DOC} = 세부 플롯 가이드
     • 없으면 → {PLOT_DOC} = 큰 설계 플롯 가이드
   • 해당 act의 캐릭터시트(detail) 결정:
     • 세부 캐릭터 시트 열에 경로가 있고 파일이 존재하면 → {CHAR_DETAIL_EP} = 세부 캐릭터 시트
     • 없으면 → {CHAR_DETAIL_EP} = 공통 character_detail
   • 세부 설계 문서 유무 확인: 해당 EP 범위에 세부 플롯 가이드(작은 설계 산출물)가 없으면 경고 출력:

     ⚠️ EP{NNN}이 속하는 범위에 세부 플롯 가이드가 없습니다.
     큰 설계 플롯 가이드만으로 EP별 비트를 추출하므로 설계도 품질이 저하될 수 있습니다.
     작은 설계(design-small)를 먼저 실행하는 것을 권장합니다.
     그래도 진행하시겠습니까?

5. {WORK_DIR}/_workspace/ 디렉토리 확인 (없으면 생성)

6. {WORK_DIR}/create-plan.md 생성/갱신:

   # 에피소드 창작 계획
   ## 대상: EP{start}-EP{end}
   - [ ] EP{NNN} — 미착수
   ...

Step 1: Phase 1 — 에피소드 설계 (병렬)

두 에이전트를 병렬로 (한 메시지에 Agent 2회 호출) 실행한다. run_in_background: true로 배경 실행한다.

⚠️ Phase 1 대기 방법 — 절대 금지/필수 준수:

• 금지: TaskOutput 사용 (팀 네임스페이스 충돌으로 "No task found" 오류 발생)
• 금지: Bash sleep 폴링 (sleep N && ls 반복 금지 — 불필요한 대기 + 승인 요청 유발)
• 필수: 배경 에이전트는 완료 시 시스템이 자동으로 알려준다. 두 에이전트 모두 완료 알림을 받은 후 Phase 2로 진행한다.

⚠️ 에이전트 공통 경로 제한 지시 (episode-architect, continuity-bridge 프롬프트에 반드시 포함): "아래 명시된 파일 경로만 읽어라. design/ 디렉토리를 Glob으로 탐색하거나, 명시되지 않은 파일을 스스로 찾아 읽으려 시도하지 마라. 필요한 모든 파일 경로는 이 프롬프트에 포함되어 있다."

Agent 1: episode-architect

• subagent_type: general-purpose
• run_in_background: true
• 프롬프트에 포함할 정보:
  • 에이전트 정의 파일 경로 → 읽으라고 지시
  • EP 번호
  • 읽을 설정문서 경로 (novel-config.md에 정의된 경로를 사용):
    • 부트스트랩: {CONFIG.bootstrap} (novel-config.md의 bootstrap 경로)
    • 플롯가이드: {PLOT_DOC} (Step 0.4에서 ep_range_table로 결정된 경로)
    • 캐릭터시트 core: {CONFIG.character_core} (novel-config.md의 character_core 경로)
    • 캐릭터시트 detail: {CHAR_DETAIL_EP} (ep_range_table 세부 캐릭터 시트 우선, 없으면 공통 character_detail)
  • novel-config.md의 가드레일, 커스텀 축
  • 목표 분량 명시 (반드시 포함):

    blueprint 헤더의 '목표 분량' 항목은 반드시 아래 값을 사용한다:
    - 초안 목표(draft_chars): {CREATE_CFG.draft_chars}자
    플랫폼 상식(문피아 3,000~4,000자 등) 기반의 자체 추론을 절대 사용하지 말 것.
    novel-config.md의 [create] 섹션 값이 없을 경우 기본값 8,000~10,000자 사용.

  • 경로 제한 지시 (위 공통 지시 포함)
  • 허용 경로 화이트리스트 (프롬프트에 반드시 포함):

    이 작업에서 Read할 수 있는 파일은 아래 목록이 전부다.
    목록에 없는 파일은 어떤 이유로든 Read하지 마라:
    0. ${CLAUDE_PLUGIN_ROOT}/agents/episode-architect.md (자신의 에이전트 정의)
    1. {CONFIG.bootstrap}
    2. {PLOT_DOC}
    3. {CONFIG.character_core}
    4. {CHAR_DETAIL_EP}
    5. novel-config.md
    위 6개 파일 외의 Read 시도는 경로 제한 위반이다.

  • 출력 경로: {WORK_DIR}/_workspace/01_episode-architect_blueprint_EP{NNN}.md

Agent 2: continuity-bridge

• subagent_type: general-purpose
• run_in_background: true
• 프롬프트에 포함할 정보:
  • 에이전트 정의 파일 경로 → 읽으라고 지시
  • EP 번호
  • 읽을 문서 경로:
    • 이전 N화: {EPISODE_DIR}/ep{N-2}.md, {EPISODE_DIR}/ep{N-1}.md
    • alive-tracker: {WORK_DIR}/alive-tracker.md (존재 시)
    • delta-tracker: {DESIGN_DIR}/delta_tracker_*.md (존재 시)
    • verification: {DESIGN_DIR}/verification_*.md (존재 시)
  • EP001 창작 시: 이전 에피소드 대신 부트스트랩 초기 상태를 요약하라고 지시
  • 경로 제한 지시 (위 공통 지시 포함)
  • 출력 경로: {WORK_DIR}/_workspace/02_continuity-bridge_report_EP{NNN}.md

Step 2: Phase 2 — 에피소드 집필 (순차)

Phase 1 완료 후 episode-creator를 실행한다.

Agent 3: episode-creator

• subagent_type: general-purpose
• 프롬프트에 포함할 정보:
  • 에이전트 정의 파일 경로 → 읽으라고 지시
  • 읽을 문서:
    • {WORK_DIR}/_workspace/01_episode-architect_blueprint_EP{NNN}.md
    • {WORK_DIR}/_workspace/02_continuity-bridge_report_EP{NNN}.md
    • 캐릭터시트 core + detail + dialogue DNA
    • novel-config.md의 가드레일
  • {CREATE_CFG} 설정 (목표 글자수, 대화 비율 등)
  • 출력 경로: {EPISODE_DIR}/ep{NNN}.md
  • 상세 집필 원칙이 필요하면 references/creation-principles.md를 읽으라고 지시
  • Bash 금지 지시: "집필 완료 후 Bash/python3 스크립트를 실행하지 마라. 글자수·대화비율·장면수 집계는 quality-verifier가 수행한다. 파일 저장 후 셀프체크(있었다/고 있었다/것이었다 Grep 카운트)를 수행한 뒤 종료하라."
  • 경로 제한 지시 (Step 1의 공통 지시 포함)

재작성 모드 (REWRITE 후 재실행 시):

• 추가 프롬프트:
  • {WORK_DIR}/_workspace/04_quality-verifier_verdict_EP{NNN}.md를 읽으라고 지시
  • 기존 초안 {EPISODE_DIR}/ep{NNN}.md를 읽으라고 지시
  • "수정 지시에 따라 해당 부분만 수정하라. 전체 재작성 금지."

Step 2.5: 트리밍 게이트 (오케스트레이터 직접 수행)

Phase 2 완료 후, Phase 3 진입 전에 오케스트레이터가 초안을 트리밍한다.

전략: "넘치게 쓰고 줄이기" episode-creator는 6000-10000자 초안을 작성한다. 오케스트레이터가 5000-8000자로 트리밍한다. 부족해서 살을 붙이는 것보다 충분히 쓰고 줄이는 것이 품질이 높다.

측정 기준: wc -m으로 파일 전체 글자수를 측정한다 (마크다운 헤더·메타데이터 포함).

1. 측정: Bash wc -m {EPISODE_DIR}/ep{NNN}.md → 글자수 확인

2. 판정: 최종 목표 범위(기본 final_chars: 5000-8000) 대비 확인

   • 상한 초과 (8000자 초과 — 일반적 케이스):

     • episode-creator를 트리밍 모드로 재호출한다
     • 프롬프트에 다음을 포함:

       트리밍 모드:
       - 현재 글자수: {N}자 (wc -m 기준, 헤더 포함)
       - 목표 범위: {FINAL_MIN}~{FINAL_MAX}자
       - 초과분: {N - FINAL_MAX}자
       - 지시: 아래 삭제 우선순위에 따라 불필요한 부분을 제거하여 {FINAL_MAX}자 이내로 만들어라.
         삭제 우선순위:
         1순위: 서술자의 상황 정리/요약 문장 (메타서술)
         2순위: 같은 감정을 다른 비유로 반복 표현한 문장
         3순위: 플롯 비트에 기여하지 않는 배경 묘사
         4순위: 이미 행동으로 보여준 감정을 내면 독백으로 재확인하는 문장
         5순위: 과도한 감각 묘사 (핵심 장면이 아닌 전환 구간)
         주의: 플롯 비트, 대사, 클리프행어, 핵심 감각 묘사는 보존. 엔딩은 대사/행동으로 유지.

     • 트리밍 후 다시 글자수를 측정한다. 1회까지 재시도, 이후 Phase 3으로 진행

   • 범위 내 (5000-8000자): Phase 3으로 진행

   • 하한 미달 (5000자 미만 — 초안이 부족한 비정상 케이스):

     • episode-creator를 즉시 재호출한다 (Phase 3 진입 전 보정)
     • 프롬프트에 다음을 포함:

       글자수 부족 보정 모드:
       - 현재 글자수: {N}자
       - 목표 하한: {FINAL_MIN}자
       - 지시: 기존 장면을 확장하거나 부족한 묘사/대화를 보강하여 {FINAL_MIN}자 이상으로 만들어라.
               새로운 플롯 비트를 추가하지 말고, 기존 장면의 밀도를 높여라.

     • 보정 후 다시 글자수를 측정한다. 2회까지 시도, 이후 Phase 3으로 진행