From novel-studio
Orchestrates 25-episode web novel detailed designs, generating character sheets and plot hook guides after automatic domain research. Use after big design for episode-specific plotting.
npx claudepluginhub mjbae/awesome-novel-studio --plugin novel-studioThis skill uses the workspace's default tool permissions.
웹소설의 25화 단위 세부 설계를 수행한다. 큰 설계 산출물을 토대로, domain-researcher 서브에이전트가 에피소드 수준의 구체적 전문 지식과 실제 사건 디테일을 자동 리서치한다.
Orchestrates complete web novel design: generates bootstrap docs, character sheets, and plot hook guides with automated domain research sub-agent. For full novel outlines.
Generates 14 planning documents (7 categories) for epic fantasy novels using Crucible Structure via interactive multi-choice questions from a premise.
Generates volume beat sheets, timelines, skeletons, and chapter outlines from total outline in webnovel projects. Enriches settings and updates state.
Share bugs, ideas, or general feedback.
웹소설의 25화 단위 세부 설계를 수행한다. 큰 설계 산출물을 토대로, domain-researcher 서브에이전트가 에피소드 수준의 구체적 전문 지식과 실제 사건 디테일을 자동 리서치한다.
| 팀원 | 에이전트 파일 | 역할 | 스킬 | 출력 |
|---|---|---|---|---|
| character-architect | ${CLAUDE_PLUGIN_ROOT}/agents/character-architect.md | 세부 캐릭터 설계 | character (모드 B) | 세부 캐릭터 시트 |
| plot-hook-engineer | ${CLAUDE_PLUGIN_ROOT}/agents/plot-hook-engineer.md | 세부 플롯/훅 설계 | plot-hook (모드 B) | 세부 플롯 훅 가이드 |
domain-researcher는 팀원이 아닌 서브에이전트로, 팀 구성(TeamCreate) 전에 실행된다.
큰 설계 문서 3종이 존재해야 한다:
{작품가제}_부트스트랩.md{작품가제}_캐릭터시트.md{작품가제}_플롯훅가이드.md${CLAUDE_PLUGIN_ROOT}/skills/design/references/genre-dna-framework.md (라우터 하위 — big/small 공용)이 스킬은 팀원(서브에이전트)이 .claude/, design/, _workspace/ 하위 파일을 Read합니다.
최초 실행 시 Read(//**) 권한을 허용하면 반복 승인 없이 진행됩니다.
design_dir에서, 없으면 프로젝트 루트와 _workspace/에서 탐색):
{DESIGN_DIR}/{작품가제}_부트스트랩.md (또는 _workspace/01_*){DESIGN_DIR}/{작품가제}_캐릭터시트.md (또는 _workspace/02_*){DESIGN_DIR}/{작품가제}_플롯훅가이드.md (또는 _workspace/03_*)design/ 및 프로젝트 루트를 순차 탐색domain-researcher 서브에이전트를 호출하여 해당 아크의 세부 리서치를 자동 수행한다. 사용자 대기 없이 즉시 진행한다.
서브에이전트: domain-researcher
subagent_type: general-purpose
리서치 항목:
프롬프트:
당신은 domain-researcher 서브에이전트입니다.
다음 리서치를 수행하세요:
1. R7 전문 기술/지식 디테일:
- 전문 분야: {전문 분야}
- 아크 범위: {N}~{M}화
- 분석 항목: 구체적 기술명, 절차, 용어, 리액션 묘사에 활용할 디테일
2. R8 사건 상세 타임라인:
- 시대: {해당 아크의 시간대}
- 분석 항목: 정확한 날짜, 전조 신호, 파급 효과, 핵심 인물, 사회적 반응
큰 설계 문서를 참조하세요:
- {작품가제}_부트스트랩.md (핵심 역량 모듈, 전문 분야)
- {작품가제}_플롯훅가이드.md (해당 아크 개요)
출력:
- _workspace/00_research/R7_전문지식_{N}~{M}화.md
- _workspace/00_research/R8_사건상세_{N}~{M}화.md
_workspace/00_research/에 저장⚠️ TeamCreate 전 안전 점검: 기존 팀("design-big-team" 등)이 남아있으면 TeamCreate가 실패한다. "Already leading team" 오류 발생 시:
TeamDelete("{기존 팀 이름}")을 먼저 실행한다- TeamDelete 성공 후 아래 TeamCreate를 진행한다
리더는 TeamCreate 전에 팀원에게 전달할 컨텍스트를 사전 로드한다.
Step 2-0a: 리서치 파일 로드
Step 2-0b: 큰 설계 문서 아크 섹션 추출
리더는 TeamCreate 전에 _workspace/00_research/ 내 리서치 결과 파일 존재 여부를 Glob으로 확인. 존재하는 파일만 프롬프트에 포함.
TeamCreate(
team_name: "design-small-team",
members: [
{
name: "character-architect",
agent_type: "general-purpose",
prompt: "당신은 character-architect 에이전트입니다.
${CLAUDE_PLUGIN_ROOT}/agents/character-architect.md를 읽고 역할을 숙지하세요.
${CLAUDE_PLUGIN_ROOT}/skills/character/SKILL.md를 읽고 모드 B(작은 설계) 절차와 출력 템플릿을 따르세요.
${CLAUDE_PLUGIN_ROOT}/skills/design/references/genre-dna-framework.md를 읽고 장르 DNA 프레임워크를 숙지하세요.
★ 큰 설계 요약 (Read 불필요 — 리더가 사전 로드):
--- 부트스트랩 요약 ---
{BOOTSTRAP_EXCERPT}
--- 캐릭터시트 요약 ---
{CHARACTER_EXCERPT}
--- 플롯훅가이드 요약 ---
{PLOT_EXCERPT}
★ 자동 리서치 결과 (Read 불필요 — 리더가 사전 로드):
--- R7 전문지식 ---
{R7_CONTENT}
--- R8 사건상세 ---
{R8_CONTENT}
(요약이 불충분하면 큰 설계 문서 원본을 Read할 수 있으나, 권한 승인이 필요할 수 있음)
대상 화수 구간: {N}~{M}화
세부 캐릭터 시트를 작성하세요.
★ 집단 캐릭터 이름 부여 규칙:
- R1/R2/R3/R4, 인턴, 수간호사 등 직급 캐릭터 중
해당 화수 구간에서 대사가 2회 이상인 인물은 반드시 한국어 이름을 부여하라.
- '이름' 열에는 실제 이름을, '관계' 열에는 직급(R3 레지던트 등)을 기입하라.
- plot-hook-engineer가 에피소드별 비트에서 직급 코드 대신 이름을 사용할 수 있게 한다.
출력: _workspace/04_character-architect_detail.md
완료 후 리더에게 SendMessage로 완료를 보고하세요:
'세부 캐릭터 시트 작성 완료. _workspace/04_character-architect_detail.md에 저장.'
(리더가 plot-hook-engineer에게 핸드오프합니다. PHE에게 직접 SendMessage하지 마세요.)"
},
{
name: "plot-hook-engineer",
agent_type: "general-purpose",
prompt: "당신은 plot-hook-engineer 에이전트입니다.
${CLAUDE_PLUGIN_ROOT}/agents/plot-hook-engineer.md를 읽고 역할을 숙지하세요.
${CLAUDE_PLUGIN_ROOT}/skills/plot-hook/SKILL.md를 읽고 모드 B(작은 설계) 절차와 출력 템플릿을 따르세요.
${CLAUDE_PLUGIN_ROOT}/skills/design/references/genre-dna-framework.md를 읽고 장르 DNA 프레임워크를 숙지하세요.
★ 큰 설계 요약 (Read 불필요 — 리더가 사전 로드):
--- 부트스트랩 요약 ---
{BOOTSTRAP_EXCERPT}
--- 캐릭터시트 요약 ---
{CHARACTER_EXCERPT}
--- 플롯훅가이드 요약 ---
{PLOT_EXCERPT}
리더로부터 SendMessage를 수신하는 즉시 작업을 시작하세요. 별도 확인이나 대기 없이 즉시 시작합니다.
_workspace/04_character-architect_detail.md를 Read하여 세부 캐릭터 시트를 숙지한 뒤
세부 플롯/훅 가이드를 작성하세요.
★ 자동 리서치 결과 (Read 불필요 — 리더가 사전 로드):
--- R7 전문지식 ---
{R7_CONTENT}
--- R8 사건상세 ---
{R8_CONTENT}
(요약이 불충분하면 큰 설계 문서 원본을 Read할 수 있으나, 권한 승인이 필요할 수 있음)
대상 화수 구간: {N}~{M}화
★ 이름 사용 규칙:
에피소드별 비트·클리프행어에 등장하는 인물은 직급 코드(R1, R3 등)가 아닌
세부 캐릭터 시트에 정의된 실제 이름으로 표기하라.
출력: _workspace/05_plot-hook-engineer_detail.md"
}
]
)
작업 등록:
TaskCreate(tasks: [
{ title: "세부 캐릭터 시트 작성 ({N}~{M}화)", assignee: "character-architect" },
{ title: "세부 플롯/훅 가이드 작성 ({N}~{M}화)", assignee: "plot-hook-engineer",
depends_on: ["세부 캐릭터 시트 작성 ({N}~{M}화)"] }
])
실행 방식: 리더 중재 파이프라인
Step 3-1: character-architect 완료 대기
_workspace/04_character-architect_detail.md 존재 여부를 Bash로 확인Step 3-2: 리더 핸드오프 character-architect 완료 확인 즉시:
_workspace/04_character-architect_detail.md를 ReadStep 3-3: plot-hook-engineer 완료 대기
_workspace/05_plot-hook-engineer_detail.md 존재 여부를 Bash로 확인 (최대 5회, 60초 간격)작은 설계 중 모순 발견 시:
{작품가제}_부트스트랩.md를 수정_workspace/06_bootstrap_amendments.md에 기록산출물 저장:
| 팀원 | 출력 경로 |
|---|---|
| character-architect | _workspace/04_character-architect_detail.md |
| plot-hook-engineer | _workspace/05_plot-hook-engineer_detail.md |
각 팀원의 산출물을 Read로 수집
일관성 검증 체크리스트:
최종 산출물을 {DESIGN_DIR}에 복사 (novel-config.md의 경로와 일치시킴):
| 중간 산출물 | 최종 경로 |
|---|---|
_workspace/04_*_detail.md | {DESIGN_DIR}/{작품가제}_세부캐릭터시트_{N}~{M}화.md |
_workspace/05_*_detail.md | {DESIGN_DIR}/{작품가제}_세부플롯훅가이드_{N}~{M}화.md |
경로 일관성 원칙: novel-config.md의
design_dir과 실제 파일 위치를 반드시 일치시킨다.
novel-config.md 자동 업데이트 (작은 설계 산출물을 다운스트림 스킬에 연결):
novel-config.md를 Read한 후, 아래 필드를 자동으로 추가/갱신한다:
업데이트 항목:
a) EP 범위별 설정문서 테이블의 해당 행에 세부 문서 경로 추가:
- 세부 플롯 가이드 열: {DESIGN_DIR}/{작품가제}_세부플롯훅가이드_{N}~{M}화.md
- 세부 캐릭터 시트 열: {DESIGN_DIR}/{작품가제}_세부캐릭터시트_{N}~{M}화.md
(기존 행의 EP 범위가 일치하면 해당 열만 갱신, 범위가 없으면 새 행 추가)
b) 공통 문서의 character_detail은 변경하지 않는다 (큰 설계 캐릭터시트를 유지).
EP 범위별 세부 캐릭터 시트가 있으면 create/polish가 ep_range_table에서 우선 참조한다.
c) R7/R8 리서치 결과 참조 경로 (보조 참조 섹션 — EP 범위별 배열):
기존 research_r7/r8 항목이 있으면 **배열에 추가** (덮어쓰지 않음):
- research_r7:
- { range: "EP{N}~EP{M}", path: "_workspace/00_research/R7_전문지식_{N}~{M}화.md" }
- research_r8:
- { range: "EP{N}~EP{M}", path: "_workspace/00_research/R8_사건상세_{N}~{M}화.md" }
동일 EP 범위의 기존 항목이 있으면 해당 항목만 덮어쓴다.
novel-config.md를 Read한 후 즉시 업데이트를 적용한다 (비대화형). 업데이트 완료 후 변경 내역을 사용자에게 출력한다 (사전 확인 요청 없음).
팀원 종료 요청
TeamDelete("design-small-team") — 팀 즉시 해산 ⚠️ 팀원 종료 SendMessage 후 즉시 실행. 사용자 응답 대기 없음. TeamDelete 실패 시:
_workspace/ 디렉토리 보존 (사후 검증용)
사용자에게 결과 요약 + 다음 25화 구간 작은 설계 안내:
## 작은 설계 완료 ({N}~{M}화)
산출물:
- {DESIGN_DIR}/{작품가제}_세부캐릭터시트_{N}~{M}화.md
- {DESIGN_DIR}/{작품가제}_세부플롯훅가이드_{N}~{M}화.md
다음 구간 작은 설계를 진행하시겠습니까?
→ 다음 범위: {M+1}~{M+25}화
'작은 설계 {M+1}~{M+25}화' 라고 말씀하시면 바로 시작합니다.
domain-researcher가 생성하는 R7(전문지식)/R8(사건상세) 리서치 결과는 세부 설계 문서에 녹아드는 방식으로 활용된다. 다운스트림 스킬(create/polish/rewrite)에서 직접 참조하지 않는다.
활용 흐름:
R7 → character-architect의 세부 캐릭터 시트에 반영 (전문 지식 활용 장면 디테일)
R7 → plot-hook-engineer의 세부 플롯에 반영 (기술적 디테일의 에피소드 배치)
R8 → character-architect의 적대자 활동에 반영 (실제 사건 기반 타임라인)
R8 → plot-hook-engineer의 에피소드별 사건에 반영 (정확한 날짜/전조 신호)
최종 산출물 (세부캐릭터시트, 세부플롯훅가이드)에 리서치가 내재화되므로,
create/polish/rewrite는 산출물만 읽으면 리서치 내용이 자동으로 반영된다.
참고 경로 (novel-config.md 보조 참조):
- research_r7: _workspace/00_research/R7_전문지식_{N}~{M}화.md
- research_r8: _workspace/00_research/R8_사건상세_{N}~{M}화.md
→ 필요 시 수동 조회 가능
| 상황 | 전략 |
|---|---|
| 큰 설계 문서 3종 중 일부 누락 | Phase 1에서 감지. 누락 문서 없이는 작은 설계 불가 → 사용자에게 큰 설계 먼저 완료하도록 안내 |
| 큰 설계 문서의 포맷이 다름 | Phase 1에서 핵심 섹션(아크 구조, 핵심 역량 모듈, 적대자 계층) 존재 여부 확인. 핵심 섹션 부재 시 보완 요청 |
| 요청 화수 구간이 아크 구조와 불일치 | 아크 경계를 사용자에게 안내하고 구간 조정 제안 |
| domain-researcher 실패 | 1회 재시도. 재실패 시 큰 설계 문서 + genre-dna 기반으로 진행, 보고서에 "자동 리서치 미반영" 명시 |
| character-architect 실패 | 1회 재시도. 재실패 시 리더가 큰 설계 캐릭터 시트 기반 기본 세부 시트 생성 |
| plot-hook-engineer 실패 | 1회 재시도. 재실패 시 큰 설계 플롯 가이드 + 세부 캐릭터 시트로 기본 세부 플롯 생성 |
| 팀원 간 통신 지연 | 리더가 중간에서 파일을 Read하여 수동으로 정보 전달 |
| 리서치 파일 Read 실패 | 리더가 "(리서치 미완료)" 텍스트를 프롬프트에 임베드. 팀원은 큰 설계 요약 기반으로 진행 |
[사용자] → 작은 설계 요청 (화수 구간)
↓
Phase 1: 범위 확인 + 큰 설계 문서 점검
↓
Phase 1.5: domain-researcher 서브에이전트 → _workspace/00_research/ (R7, R8)
↓ (사용자 대기 없음)
Phase 2: TeamCreate("design-small-team") — 리서치 결과 포함
↓
Phase 3: character-architect → plot-hook-engineer
↓
Phase 4: 통합 검증 → 산출물 2종
↓
다음 아크 안내
{작품가제}_플롯훅가이드.md 누락 감지