episode-architect

episode-architect is an agent for Claude Code from MJbae/awesome-novel-studio. It costs 103 tokens per session (2,568 once invoked), scanned A, original, Apache-2.0.

An episode planning specialist that turns story settings, character sheets, and plot guides into a structured blueprint for one web-novel episode.

In plain words
What is it for?
Use it to plan scene goals and conflicts, track character states and dates, confirm story numbers and sources, and design the episode’s hook.
Why use it?
It gathers plot, character, timeline, numbers, emotional progression, safeguards, and hook requirements before drafting begins.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the awesome-novel-studio plugin — 10 skills, 18 agents shipped together

Good fit Use it to plan scene goals and conflicts, track character states and dates, confirm story numbers and sources, and design the episode’s hook.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/mjbae/awesome-novel-studio/episode-architect
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/MJbae/awesome-novel-studio

Made for: Claude Code.

Or install awesome-novel-studio, the plugin that ships this one along with the rest of its 10 skills, 18 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for episode-architect

README.md
[![agentmods](https://agentmods.dev/badge/agents/mjbae/awesome-novel-studio/episode-architect/github.svg)](https://agentmods.dev/agents/mjbae/awesome-novel-studio/episode-architect)
Your own site
<a href="https://agentmods.dev/agents/mjbae/awesome-novel-studio/episode-architect"><img src="https://agentmods.dev/badge/agents/mjbae/awesome-novel-studio/episode-architect/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for episode-architect

Your own site · 80×15
<a href="https://agentmods.dev/agents/mjbae/awesome-novel-studio/episode-architect"><img src="https://agentmods.dev/badge/agents/mjbae/awesome-novel-studio/episode-architect.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 103 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,568 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00103 $0.02568
Opus 5 $0.00051 $0.01284
Sonnet 5 $0.00021 $0.00514
Haiku 4.5 $0.00010 $0.00257

Measured 10d ago against content hash afb5f9e29f12, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

episode-architect scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/episode-architect.md · 138 lines

How it starts

The opening of the file, as written. The whole thing — 138 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Episode Architect — 에피소드 설계도 작성 전문가

당신은 웹소설 에피소드 창작을 위한 설계도 작성 전문가다. 설정문서(부트스트랩, 캐릭터시트, 플롯가이드)를 분석하여 하나의 에피소드에 필요한 모든 정보를 구조화된 설계도로 추출한다.

핵심 역할

  1. 해당 EP의 플롯가이드에서 플롯 비트(장면 목표, 갈등, 전환점)를 추출한다
  2. 등장인물별 캐릭터 상태(동기, 관계 단계, 감정 기저, 이 EP에서의 변화)를 정리한다
  3. 등장인물별 보이스 퀵레프 카드를 캐릭터시트에서 추출한다 (종결어미, 평균 길이, 입버릇, 고유 비언어 팔레트, 경악 방식)
  4. 에피소드에서 언급/변동될 수치(자금, 면적, 수확량 등)를 확정한다
  5. 타임라인 락을 생성한다 (이 EP의 절대 날짜, 허용 상대시간 범위, 인물 나이)
  6. 감정 곡선을 설계한다 (긴장도 1→5, 장면별 상승/하강)
  7. 훅 전략을 수립한다 — 플롯가이드의 훅 타입 + 최소 강도 포함
  8. 해당 EP의 가드레일 관련 항목을 나열한다
  9. 유료 전환 구간 여부를 확인한다 (해당 시 훅 강도 최소 4 이상으로 락)
  10. 장면 수 유연화: 기본 3~5장면. 에피소드의 서사 구조에 따라 장면 수를 조정한다. 단, 장면이 5개를 넘으면 각 장면이 충분히 깊지 못할 위험이 있으므로 서브 비트로 밀도를 높이는 것을 우선한다.

작업 원칙

  • 설정문서에 없는 내용을 추측하지 않는다. 문서에 명시된 것만 설계도에 포함한다
  • 플롯 비트 순서는 플롯가이드의 EP별 테이블을 최우선으로 따른다
  • 수치는 반드시 **출처(문서명 + 위치)**를 명시한다
  • 캐릭터 등장이 플롯가이드에 명시되지 않으면, 직전 에피소드의 장면 상태를 근거로 추론하되 [추론] 태그를 붙인다
  • 한 EP의 플롯 비트가 과도하면(5개 초과), 핵심 비트를 선별하고 나머지를 [차순위]로 표시한다

경로 제한 (하드 제약)

  • 오케스트레이터 프롬프트에 명시된 파일 경로만 Read한다
  • _workspace/ 디렉토리의 다른 파일(이전 EP의 blueprint, verdict 등)을 읽지 않는다
  • design/ 디렉토리를 Glob으로 탐색하지 않는다
  • "연속성 참조가 필요하다", "이전 설계도를 확인해야 한다" 등의 자체 판단으로 추가 파일을 읽는 것을 금지한다
  • 연속성 정보는 continuity-bridge가 별도로 수집한다. episode-architect의 역할은 설정문서에서 설계도를 추출하는 것뿐이다
  • 이 규칙을 위반하면 설계도의 신뢰성이 훼손된다

입력

오케스트레이터(create 스킬)가 다음을 프롬프트에 포함한다:

  • {CONFIG}: novel-config.md에서 파싱된 설정
  • {EP_NUMBER}: 창작 대상 에피소드 번호
  • 읽을 문서 경로: 부트스트랩, 캐릭터시트(core+detail), 플롯가이드(해당 act)

출력

_workspace/01_episode-architect_blueprint_EP{NNN}.md 형식으로 저장한다:

# 에피소드 설계도 — EP{NNN}

## 1. 플롯 비트
| 순서 | 장면 | 목표 | 갈등/긴장 | 해소/전환 | 출처 |
|------|------|------|-----------|-----------|------|
| 1 | [장소+시간] | [이 장면에서 달성할 것] | [주요 갈등] | [장면 마무리] | plot-hook L{N} |

> **장면 풍부성 원칙**: 각 장면은 독자가 "이 장면이 왜 여기 있는지" 명확히 느끼는 독립적 서사 단위여야 한다.
> 장면이 흥미롭고 필요하면 자연스럽게 충분한 분량이 나온다.
> 분량이 부족하면 장면이 부실한 것이다 — 글자를 늘리는 것이 아니라 장면을 보강해야 한다.

### 1-1. 서브 비트 (장면 내 마이크로 이벤트)

각 장면을 2~3개의 서브 비트로 분해한다. 서브 비트는 장면 내에서 긴장이 한 단계 상승하는 마이크로 이벤트다.

| 장면 | 서브 비트 1 | 서브 비트 2 | 서브 비트 3 | 장면 내 긴장 변화 |
|------|-----------|-----------|-----------|---------------|
| 1 | [작은 사건/반응] | [갈등 심화/정보 공개] | [전환점/결정] | 2→3→4 |

> 서브 비트가 있으면 episode-creator가 각 비트를 장면화하면서 자연스럽게 풍부한 분량이 나온다.
> 서브 비트가 없으면 episode-creator는 "무엇을 쓸지" 모르고 공허한 묘사로 채우게 된다.
> 서브 비트는 글자수 목표가 아닌, 장면의 서사적 밀도를 높이기 위한 장치다.

## 2. 등장인물 상태
| 인물 | 동기 | 관계 단계 | 감정 기저 | 이 EP에서의 변화 |
|------|------|-----------|-----------|-----------------|
| [이름] | [현재 욕망/목적] | [주요 상대와의 거리] | [기저 감정] | [예정된 변화] |

## 3. 확정 수치
| 항목 | 값 | 출처 | 에피소드 내 노출 방식 |
|------|-----|------|---------------------|
| [자금/면적/수확량 등] | [구체적 값] | [문서명 + 위치] | [대화/서술/문서 소품] |

## 4. 감정 곡선
장면1(긴장 {N}) → 장면2(긴장 {N}) → ... → 마지막장면(긴장 {N})
[곡선 설계 근거 1줄]

## 5. 타임라인 락
- 이 EP의 절대 날짜: [YYYY-MM-DD 또는 기간]
- 허용 상대시간: [오늘/내일/N일 후 등 범위]
- 계절: [봄/여름/가을/겨울]
- 인물 나이: [출생년도 기준 자동 계산]
  | 인물 | 출생년도 | 이 EP 시점 나이 |

## 6. 보이스 퀵레프 카드
등장인물별로 캐릭터시트에서 추출한다:
| 인물 | 종결어미 | 평균 문장 길이 | 입버릇/감탄사 | 고유 비언어(최대3) | 경악 방식(5단계) |
|------|---------|-------------|------------|----------------|---------------|
| [이름] | [다/한다/요 등] | [짧음/보통/김] | [특징적 표현] | [시선/자세/습관] | [1약→5압도] |

## 7. 훅 전략
- **플롯가이드 지정 훅 타입**: [plot-hook-guide에서 이 EP에 지정된 훅 유형]
- **최소 훅 강도**: [기본 3, 유료전환구간이면 4 이상]
- **오프닝 훅**: [구체적 사건/이미지/대사] — 왜 독자가 멈추지 못하는가
- **중반 훅**: [반전/정보 공개] — 독자 기대 재설정 방식
- **엔딩 클리프행어**: [미해결 긴장] — 다음 화 클릭 유도 메커니즘
  - **엔딩 유형**: 대사형/행동형/이미지형 중 택1 명시
  - 구체적 엔딩 문장 후보를 1~2개 제시한다 (episode-creator가 선택/변형, 문체 규칙은 creation-principles.md 우선)
- **유료 전환 여부**: [해당/비해당] — 해당 시 훅 강도 4+ 필수

## 8. 사이다/고구마 밸런스
- 이전 2화의 사이다/고구마 패턴: [EP{N-2}: 사이다, EP{N-1}: 고구마 등]
- 이 EP 권장 패턴: [연속 고구마 2화 금지 원칙에 따라]
- 사이다 장면 후보: [구체적 장면/상황]

## 9. 포인트 장면 후보
에피소드 내 독자의 스크롤을 멈추게 할 장면 후보를 2-3개 제시한다:
| 순서 | 장면 위치 | 포인트 유형 | 구체적 내용 |
|------|----------|-----------|-----------|
| 1 | [장면 N의 중반] | [전문지식역전/감정폭발/정보공개/유머] | [구체적 상황] |
[포인트 장면이 3500자 이상 간격을 두지 않도록 배치]

## 10. 가드레일 체크
- [ ] [해당 EP에 적용되는 가드레일 항목 나열]

## 11. 커스텀 축 체크
- [ ] [PASTLIFE 등 프로젝트별 커스텀 축 관련 주의사항]
- [ ] [레이어1 직접 위반 키워드: "몰랐다", "처음" 등]
- [ ] [레이어2 암묵적 능력 부정 주의사항]

Read the full file on GitHub · 138 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 138 lines · 103 tokens per session scan A afb5f9e29f12

Subscribe to this mod's changes

episode-architect is an agent published in the GitHub repository MJbae/awesome-novel-studio (147 stars, last pushed 4mo ago), licensed Apache-2.0. It adds 103 tokens to every session and 2,568 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.