book-writer: Skill for Claude Code

Book Planning

좋은 계획은 "독자가 어떤 여정을 거쳐 무엇을 얻는가"를 먼저 정하고, 거기서 역산해 챕터를 배치한다. 오케스트레이터가 확정한 genre(기본 tech-book)의 profiles/{genre}/scaffolds.md를 읽고 그 장르의 단위로 짠다.

독자 여정

진입 상태(이 독자는 왜 이 책을 집었나, 무엇을 알고 무엇이 고민인가)에서 출구 상태(다 읽고 나면 무엇을 할 수 있고 무엇이 바뀌었나)를 정한다. 출구는 장르마다 다르다 — tech-book과 practical은 "할 수 있다", narrative는 "느낀다", essay는 "바뀐다". 그 사이에 각성(놓친 것을 깨닫는 지점), 배움, 적용, 종합이 어디서 일어나는지 배치한다.

챕터 배치

• 5~10장을 기본으로 하고 주제 폭에 맞춰 조정한다.
• 첫 장은 왜 이 주제·이 책인지, 중반은 무엇과 어떻게를 교차하고, 종반은 부분 지식을 묶고, 마지막 장은 덮은 뒤의 다음 걸음을 남긴다 (narrative는 서사 아크가 우선).
• 레퍼런스의 주요 자료가 어딘가에 배치되고, 인접 챕터가 겹치지 않고, 난이도가 갑자기 뛰지 않고, 챕터 예상 분량의 합이 목표 분량에 맞아야 한다.

통권 변주 배정

각 챕터에 셋을 배정한다 (scaffolds의 메뉴에서):

• 오프닝 기법 — 인접 챕터와 다르게. tech-book에서 '상황 가정'은 전체의 1/3 이하.
• 클로징 기법 — 전 챕터가 서로 다르게. 마지막 장은 여정을 회수하는 닫는 매듭.
• 스캐폴드 유형 — tech-book: 개념 도입형·문제-해결형·사례 분석형·비교 대조형·종합 정리형. 다른 장르는 해당 프로필의 유형.

출력: {slug}/02_plan.md

# {주제} 저술 계획

## 제목 후보
1. **{후보1}** — 톤: {...}, 포지셔닝: {...}
2. **{후보2}** — ...
3. **{후보3}** — ...
**추천:** {후보N} (이유)

## 책 특성
- 장르: {...}
- 분량: {전체 글자 수}
- 난이도: {초급 / 중급 / 고급}
- 독자 여정: {진입 상태} → {출구 상태}

## 내러티브 아크
{챕터 흐름과 이 순서인 이유를 문단으로}

## 설계 근거
- **채택한 구조:** {핵심 이유 2~3개}
- **기각한 대안 1:** {한 줄 요약} — 기각 사유: {...}
- **기각한 대안 2:** {한 줄 요약} — 기각 사유: {...}

## 용어 표기
- {핵심 용어}: {이 책에서 쓸 표기}

## 챕터 목록

### 1장. {제목}
- **핵심 질문:** {...}
- **주요 내용:** {3~5개 불릿}
- **독자가 얻는 것:** {...}
- **오프닝 기법:** {...}
- **클로징 기법:** {...}
- **스캐폴드 유형:** {...}
- **예상 분량:** {글자 수}

### 2장. ...

"용어 표기"는 병렬로 쓰는 저술가들이 같은 표기를 쓰게 하는 기준이다. 핵심 용어 5~15개면 충분하다.

리뷰 피드백 반영

03_review_log.md나 사용자 피드백이 오면 Critical은 반영하고, Should는 반영하거나 근거를 적어 기각하고, Nice는 선택한다. 변경 요약은 02_plan.md 끝의 "개정 이력"에 남긴다.