book-writer: Skill for Claude Code

Book Writing Orchestrator

주제·주요 내용·대상 독자를 받아 Toby 스타일의 완성된 EPUB을 산출하는 전 과정을 조율한다. 각 Phase에서 전문 에이전트를 호출하고, 중간 산출물을 {slug}/ 하위에 축적한 뒤 최종 EPUB을 프로젝트 루트에 만든다.

실행 모드

Phase	모드	왜 이렇게
1. 리서치	서브 에이전트(팬아웃)	소스별 독립 수집 → 병렬화가 이득
2. 저술 계획	단일 서브	통합적 사고가 필요, 분할 이점 없음
3. 계획 리뷰	에이전트 팀(생성-검증 왕복)	저자와 리뷰어의 토론이 품질을 높임
4. 챕터 저술	에이전트 팀	챕터 저술가 ↔ 스타일 가디언 ↔ 편집자 실시간 조율
4.5. 통권 수락 검수	단일 서브(신선 컨텍스트)	editor와 분리된 새 눈이 통권을 게이트 — 자기 승인 방지
5. 표지 + EPUB	서브(부분 병렬)	cover-designer를 background로 띄우고 epub-builder의 cover-독립 준비를 병행, cover.png 소비 지점에서 join

Phase 0: 컨텍스트 확인

워크플로우를 시작하기 전에 기존 산출물 존재 여부를 확인한다.

1. 사용자 입력에서 주제, 주요 내용, 대상 독자를 추출한다. 셋 중 하나라도 불명확하면 사용자에게 짧게 질문한다 (AskUserQuestion 사용). 추가로 저자: {이름} 형태의 저자 지정이 있는지 확인한다 — 없으면 기본값 Toby-AI를 사용하고, 있으면 해당 값을 매니페스트·표지 메타까지 전파한다. 라이선스: {값} 형태가 있는지도 확인한다 — 없으면 하네스 기본값 CC BY-NC-SA 4.0을 매니페스트에 그대로 두고(또는 license 필드를 비워두면 빌드 스크립트가 채움), 있으면 해당 값을 매니페스트의 license 필드로 전달한다.
2. 장르 감지 + 확인. profiles/_registry.md의 자동 감지 규칙으로 주제·주요 내용·대상 독자에서 장르를 추정한다 (tech-book / narrative / practical / essay, 기본 tech-book). 사용자가 장르: {값}을 명시했으면 그대로 채택. 아니면 AskUserQuestion으로 추정값을 첫 옵션·추천으로 제시해 확인받는다 (단, 신호가 강하고 명백하면 추정값을 알리고 진행해도 된다). 확정된 genre는 이후 모든 Phase로 전파되고, Phase 4의 editor가 book_manifest.json의 genre 필드에 기록한다. 활성 프로필 경로는 profiles/{genre}/.
3. 책 제목 후보(슬러그 포함)를 만든다. 예: AI 시대의 개발자 철학 → 슬러그 ai-developer-philosophy.
4. {slug}/의 존재 여부를 확인한다.
   • 미존재 → 초기 실행, Phase 1부터 순차 실행
   • 존재 + 사용자가 부분 수정 요청 (예: "챕터 3만 다시", "계획만 수정") → 부분 재실행, 해당 Phase만 재호출. 이때 장르는 기존 book_manifest.json의 genre를 재사용한다 (사용자가 장르 변경을 명시하지 않는 한)
   • 존재 + 새 입력 제공 → 기존 {slug}/를 {slug}_prev-{timestamp}/로 이동 후 새 실행

Phase 1: 리서치 (팬아웃)

실행 모드: 서브 에이전트 병렬 호출

research-lead 에이전트를 호출하고, 내부에서 web-researcher, paper-researcher, community-researcher를 run_in_background: true로 병렬 스폰한 뒤 결과를 종합하도록 지시한다.

입력: 주제, 주요 내용, 대상 독자 출력: {slug}/01_reference.md — 리서치 종합 문서 (섹션: 개념·정의, 주요 관점, 사례, 논쟁점, 참고문헌)