책 제작 파이프라인은(는) 무엇을 하나요?

구상부터 아마존 리스팅까지 그림책(단권 또는 여러 권)을 생산하는 완전한 워크플로우입니다. illustrated-book 스킬(단일 책 레이아웃 세부 사항)의 보완 스킬입니다. 사용자가 단일 페이퍼백 그림책부터 10권 시리즈까지 무엇이든 구축할 때 이 스킬을 사용하세요.

사용 시기

"책 / 책 시리즈를 쓰는 것을 도와주세요"
"N권의 책에 걸쳐 동일한 표지 형식, 동일한 음성, 동일한 일러스트레이션 스타일"
"표지와 내부 스케치가 포함된 전체 원고 생성"
"내 아이디어를 아마존 페이퍼백 + Kindle + 오디오북으로 출판 가능한 형태로 번역"

사용하지 말아야 할 경우

타인의 저작권이 있는 작품의 충실한 번역 — 번역 권리 관련 대화 참조
어린이 그림책 — 다른 레이아웃/일러스트레이션 파이프라인 사용
순수 논픽션 참고서(교과서, 매뉴얼) — 다른 구조 사용
사진적 비주얼 시그니처가 있는 문학 소설 — 패턴 A 또는 B와 함께 illustrated-book 스킬 직접 사용

파이프라인 (모든 책 수에 적용)

아래는 검증된 워크플로우입니다. 단일 책은 0~10단계를 순차적으로 실행합니다. N권 시리즈는 5단계에서 병렬 에이전트 디스패치를 추가하고 1단계에서 SERIES_GUIDE.md를 추가합니다. 하위 단계(컴파일, 오디오북, 출판)는 책마다 동일합니다.

0단계 — 개념 고정 (사용자 정렬, 필수)

무엇이든 쓰기 전에 사용자와 다음을 확정합니다:

책 수, 제목 및 연결 고리. 각 책이 다루는 불안/영역/호기심은 무엇인가요? 단일 책의 경우 제목 + 훅만. N권의 경우 시리즈 아크.
음성 레지스터. 하나를 선택하고 샘플 음성 한 문단으로 확인:
- Manson-스파이시 (욕설, 직설적)
- Burkeman-지적 (욕설 없음, 사색적)
- Manson × Burkeman × Gor (느긋한 자기계발, 가벼운 동양 지혜, 욕설 없음)
- Pelevin-전통 문학 (철학적, 초현실적, 밀도 높음)
- Sebald-스타일 명상적 (사진과 산문 혼합)
저자 페르소나 — 가장 중요한 결정.
- 자전적 (사용자 자신) — 매력적이지만 사용자가 틈새 시장이면 위험
- 의사-자전적 일반적 ("30대 중반 엔지니어", "40대 교사") — 더 넓은 매력
- 3인칭 허구적 내레이터
- 중요 테스트: "냉담한 구매자의 훅은 무엇인가?" 페르소나가 독자가 참여하기 전에 교육을 요구한다면 (틈새 하위문화, 외국 이민자 프레임, 특정 종교 전통), 냉담한 아마존 구매자는 물지 않습니다. 일반적이지만 공감 가는 것이 거의 항상 승리합니다.
- 대규모 병렬 초안 작성 전에 1장 샘플을 실행하세요. 10만 단어 후에 발견된 페르소나 드리프트는 수정하기 어렵습니다.
캐던스 (다중 책 전용). 2-4주 내 빠른 릴리스 (최대 KDP 알고리즘 부스트) 대 한 번에 하나씩.
언어. 영어 전용, 또는 영어 + 러시아어 / 기타 — 오디오북 엔진 선택에 영향 (project_audiobook_engine.md 참조).
권리. 사용자가 "따라서" 기존 책을 참조하는 경우 번역 권리가 있는지 확인하세요. 유사 레지스터의 독창적 작업은 권리 문제가 없지만, 권리 없는 번역은 그렇지 않습니다.

1단계 — 폴더 구조

Books/<Project_Name>/
├── _series/                         # 다중 책 전용; 단일 책은 건너뛰기
│   ├── SERIES_GUIDE.md              # 음성 + 페르소나 + 반복 장치 + 아트 바이블
│   ├── _gen_covers.py               # 표지 생성기
│   ├── _gen_sketches.py             # 내부 스케치 생성기
│   └── test_sketches/               # 승인 게이트 샘플
├── 01_<Book_Slug>/                  # 단일 책의 경우 Books/ 아래 폴더 하나
│   ├── BOOK_PLAN.md                 # 장 개요 (모든 N장; 일반적으로 25장)
│   ├── chapters/                    # NN_slug.txt 파일
│   ├── images/00_cover.png          # 메인 표지
│   └── sketches/                    # 내부 일러스트레이션
├── 02_<Book_Slug>/...               # 추가 책
└── _publishing/                     # 책별 메타데이터 키트

SERIES_GUIDE.md (또는 단일 책의 경우 BOOK_GUIDE.md)에는 다음이 포함되어야 합니다:

음성 레지스터 (긍정 예제 + 금지된 레지스터)
내레이터 페르소나 (구체적 바이오, 질감, 참조할 것, 공개하지 말 것)
반복 장치 (예: "해봤어" 패턴, 현대적으로 재해석된 비유, 명상적 닻 — 책에 지혜의 순간이 있다면 하나의 보편적 실천 선택)
스케치 아트 바이블 (고정 프롬프트 접두사; 승인 샘플로 테스트)
표지 바이블 (구성 공식 — 시리즈의 모든 표지에서 동일한 X)
마커 규칙 (6단계)
생산 체크리스트

2단계 — 표지 생성

표지에 읽기 쉬운 텍스트를 위한 최고 모델: Google Gemini의 Nano Banana Pro 모델 (nano-banana-pro-preview). 더 깔끔한 타이포그래피로 일반 장면에 가장 좋은 것: Nano Banana Flash (gemini-2.5-flash-image). 로컬 대안: ComfyUI를 통한 Flux Krea Dev FP8.

API 키는 환경 변수를 통해 제공되어야 합니다 — 스크립트에 하드코딩 금지:

export GEMINI_API_KEYS="key1,key2,key3,key4"   # 쉼표로 구분, 순환됨

또는 호출 시:

import os
keys = os.environ["GEMINI_API_KEYS"].split(",")

표지 구성 공식 (느긋한 자기계발 시리즈에 검증됨; 장르별로 조정):

상단: 선택적 로고 구분자와 함께 간격을 둔 대문자로 된 저자 이름
제목: 위쪽 1/3을 채우는 굵은 손글씨 스타일 대문자 (클릭베이트 헤드라인)
부제: 악센트 색상 (설명적 약속)
주인공 주제는 프레임 안에 작게, 환경이 지배적
하단: 작은 대문자 인용문 (예: "___의 저자")
시리즈 통일성: 모든 표지에서 동일한 반복 시각적 모티프 (모자, 의자, 창문 — 일관된 모든 것)

프롬프트 규칙 (2026-04-25 학습):

"상단에 빈 흰색 하늘 공간"을 요청하지 마세요 → 평평하고 날아간 밴드 생성. 장면이 프레임을 채우게 하세요; 자연스러운 그림자에 제목을 오버레이.
정확한 텍스트를 따옴표 안에 넣으세요 ("텍스트가 정확히 읽힘: '…'") — Pro가 그대로 재현.
"전체 장면이 맨 위까지 프레임을 채우며, 날아간 부정적 공간 없음"이라고 말하세요.

3단계 — 스케치 아트 승인 게이트 (필수)

사용자 승인을 받기 전에 전체 스케치 배치를 생성하지 마세요. 항상:

고품질로 ~10개의 테스트 스케치 생성 (Flux Krea Dev FP8, 1024×1024, 25단계)
사용자에게 표시 → 승인 대기
승인 후, 더 빠른 생산 설정으로 전환 (768×768, 18단계) ~3-4배 속도 향상
1개 스케치로 속도 향상 설정을 연기 테스트 — 품질이 승인된 스타일과 일치하는지 확인
그런 다음 전체 배치 실행

만화 선화용 고정 생산 프롬프트 접두사 (Gor-미학 스타일, 2026-04-25 검증):

순수 흰색 배경에 검은 잉크 느슨한 손그림 펜 스케치,
미니멀리스트 만화 선화, 단일 주제, 음영 없음, 채움 없음, 회색조 톤 없음,
색상 없음, 그라데이션 없음, 배경 디테일 없음, 흰색 위에 검은 선만,
단순한 표현적 윤곽선, 약간의 흔들림, 많은 빈 흰색 공간,
평평한 2D 일러스트레이션, 전체 이미지는 순수 단색 흰색이며 그 위에 검은 잉크 선만 그려짐.
사진 아님, 노트북 페이지 아님, 종이 질감 없음, 프레임 없음, 제본 없음, 테두리 없음.

고정 네거티브 프롬프트:

포토리얼리스틱, 스케치 사진, 노트북 사진, 종이 질감,
노트북 제본, 페이지 가장자리, 스케치북, 저널, 그림 주변 프레임,
3D 렌더, 색상, 그라데이션, 음영, 수채화, 유화, 애니메이션, 만화,
복잡한 배경, 바쁜 구성, 상세한 환경, 회색 채움,
크로스해칭, 밀도 높은 선화, 장식적 테두리, 어두운 배경, 검은 배경

일반적인 함정: 스케치가 노트북 안의 펜 스케치 사진으로 나오면, 프롬프트에 "페이퍼백 책" / "노트북" / "문단 사이"가 언급되었을 수 있습니다 → 해당 구문 제거.

다른 스타일의 경우 (수채화, 포토콜라주, 벡터 플랫 등), 프롬프트 접두사를 대체하고 동일한 승인 게이트를 실행하세요.

후처리: R+G+B > 720인 픽셀 → (255,255,255)로 스냅. 거의 흰색 색조를 정리합니다.

4단계 — 책별 BOOK_PLAN.md

각 책은 장 개요를 받습니다. 각각 약 1/3씩 세 막. 필수 요소:

각 장의 파일명 슬러그 (snake_case)
한 문단 장 요약
스케치 힌트 목록 (반복 시각적 요소)
인용문 후보 은행 (에이전트는 일부 사용하고 다른 것을 발명)
반복 명상적 닻 배치 (~3장당 책, 해당되는 경우)
상호 참조 규칙 (다중 책 시리즈에만 관련)

장 수: 15-30장이 일반적입니다. 일부 선언문은 10장에서 작동합니다; 일부 문학 소설은 40장 이상.

5단계 — 초안 작성

단일 책: BOOK_GUIDE.md + BOOK_PLAN.md와 함께 ONE general-purpose 에이전트 디스패치.

다중 책 시리즈 (병렬): 책당 ONE general-purpose 에이전트 디스패치. 각 에이전트는 다음을 수신:

SERIES_GUIDE.md 경로 (먼저 읽음)
자체 BOOK_PLAN.md 경로
프롬프트 자체의 페르소나 사양 요약 (심층 방어)
출력 폴더 사양
마커 규칙 (6단계)
장당 및 총 단어 목표
진행하면서 저장 지시 (메모리에 배치 금지)
보고 형식

Anthropic API 제한: 4개의 병렬 general-purpose 에이전트가 안전한 상한선입니다. 5개 이상은 스로틀링될 수 있습니다.

페르소나 드리프트 감시. 가장 큰 실패 모드는 에이전트가 잘못된 페르소나 질감을 선택하는 것입니다. 중간에 주기적으로 Grep하여 금지된 토큰(GUIDE에서 제한으로 정의한 것)을 확인하세요. 감지되면 중지하고, 보관하고, GUIDE를 더 강조하여 다시 작성하고, 재디스패치하세요.

6단계 — 마커 규칙

소스 .txt 파일은 컴파일 스크립트가 대체하는 마커 토큰을 사용합니다.

마커	위치	렌더링 결과
`[SKETCH: scene description]`	인라인, 자체 줄	해당 위치에 삽입된 사전 생성 PNG 스케치
`[QUOTE: single-sentence pull-quote]`	인라인	EPUB: 스타일된 HTML 인용문 콜아웃. PDF: 스타일된 콜아웃 또는 그래픽으로 재생성
`[SEEDS]…[/SEEDS]`	장 끝, `-` 불릿과 함께	이탤릭 세리프 격언이 있는 스타일된 콜아웃 상자 (Gor의 "지혜의 씨앗" 장치)
첫 번째 및 마지막 `img_map` 항목	장당 이미지 맵	장 텍스트 전의 전면 페이지 마키 일러스트레이션. 중간 항목 → 텍스트 래핑 (`illustrated-book` 스킬의 패턴 B v2)

장르별로 각 마커를 채택하거나 생략하세요. 자기계발 및 대중 영성은 네 가지를 모두 사용합니다. 문학 소설은 종종 [SKETCH:]와 장 이미지 맵만 사용합니다.

7단계 — 스케치 생성 (생산 배치)

모든 장 초안이 작성된 후:

chapters/ 파일 전체에서 [SKETCH:] 마커 Grep
배치로 스케치 생성기 스크립트 실행 — 마커당 하나의 PNG를 <book>/sketches/에 생성
파일 명명 규칙: <chapter_slug>_s01.png, _s02.png 등
화이트워시 후처리
생산 설정 (선화용 고정): 768×768, 18단계, Flux Krea Dev FP8, euler/simple, cfg 1.0, guidance 3.0

처리량: RTX 5080에서 스케치당 ~15초. 400개 스케치 ~1.5시간.

8단계 — 컴파일 (`illustrated-book` 스킬 참조)

검증된 _compile_novel.py 스크립트 사용 (fpdf2 PDF + ebooklib EPUB 처리). 스크립트는 6단계의 전체 마커 세트와 하이브리드 레이아웃(패턴 B v2: 첫 번째 + 마지막 img_map 항목이 전면 페이지 마키가 됨; 중간 항목은 왼쪽/오른쪽 번갈아 텍스트 래핑)을 지원합니다.

책당:

python _compile_novel.py <Project_Name>/<Book_Slug>

출력: <Book>_EN.pdf, <Book>_EN.epub, <Book>_Cover_Amazon.jpg (1600×2560), 그리고 러시아어 장이 있으면 <Book>_RU.{pdf,epub}.

9단계 — 오디오북 (오디오북 엔진)

cd <Audiobook-Engine path>
tts.bat audiobook "<full path to book folder>" en

영어: Kokoro v1.0 af_heart (~25-49× RTF). 러시아어: 복제된 음성과 함께 F5-TTS Misha24-10 (~1× RTF). 출력: <Book>_AUDIOBOOK_<LANG>.mp3 (192 kbps).

10단계 — 출판

출판 메타데이터 키트 패턴 사용: KDP 카테고리, BISAC 코드, 키워드, 제안 가격, 광고 (HTML), 경쟁 도서, 저자 약력이 포함된 책별 메타데이터 팩. 하이브리드 드라이브: 메타데이터 준비, 사용자가 KDP/Kobo/Google Play 열기, 붙여넣기/업로드.

다중 책 시리즈의 경우: 2-4주에 걸친 빠른 릴리스, 1권에만 KDP Select.

중요한 교훈 (2026-04-25까지 여러 책 실행에서 검증됨)

1. 페르소나 반복이 가장 중요한 단계입니다

잘못된 페르소나로 대규모 초안 작성은 되돌리기 어렵습니다. 병렬 초안 작성 전에 항상 제안된 페르소나의 1장 샘플을 실행하세요. 명시적으로 물어보세요: "이것이 아마존 냉담한 구매자에게 훅이 있나요?"

2. 사용자의 자전적 음성은 거의 올바른 훅이 아닙니다

저자들은 독자들이 그들의 실제 삶에 매료될 것이라고 상상합니다. 냉담한 독자들은 투영하기를 원합니다. 의사-자전적 일반적을 기본값으로 사용자가 입증된 이름 인지도를 가지고 있지 않는 한.

3. 스케치 테스트 게이트는 협상 불가입니다

~10개 테스트 스케치 → 사용자 승인 → 생산 설정 → 연기 테스트 → 전체 배치. 게이트를 건너뛰면 수백 개의 잘못된 스케치가 생성됩니다.

4. 표지 프롬프트 규칙

"빈 흰색 하늘 공간" 피하기 → 평평하고 날아간 밴드
프롬프트에 정확한 텍스트 인용 — Pro가 그대로 재현
시리즈 통일성 = 프롬프트에 "이전 표지와 동일한 X"를 명시적으로 명시

5. 스케치 프롬프트 규칙

"페이퍼백 책 / 노트북 페이지" 피하기 → Flux가 스케치를 노트북 사진으로 프레임화
대신 "순수 흰색 위의 평평한 2D 그림" 사용

6. 표지-API 할당량 모델

무료 티어 Nano Banana Pro는 키별 시간 창당, 일별 총계가 아닙니다. 키를 순환하세요; 하나가 속도 제한되면 다음이 약 45초 쿨다운 후에 선택됩니다.

7. Kokoro 오디오북: 스타일 인덱스 고정

Kokoro-onnx는 MAX_PHONEME_LENGTH=510에서 1만큼 차이가 나는 버그가 있습니다. 헬퍼를 패치하세요:

style = voice_style[min(len(tokens), voice_style.shape[0] - 1)]

8. 리셋 전에 백업

초안 중간에 페르소나 전환이 필요할 때, 이전 장을 보관하세요 (_v1_old_persona_archive/로 이동). 삭제하지 마세요. v2로 채굴할 수 있는 재사용 가능한 구조, 비트 및 인용문이 포함되어 있습니다.

9. 컴파일 + 오디오북 + 출판 단계는 90% 재사용 가능합니다

GUIDE와 PLAN이 올바르면, 다운스트림 파이프라인은 수정 없이 실행됩니다. 투자: 파이프라인 설정 한 번에 약 2시간. 책당 다운스트림: 약 30분.

10. 동일한 러시아 스타일 표지 공식은 영어 책에 대해 Nano Banana Pro를 통해 깔끔하게 재현됩니다

모자 + 열대 설정 + 굵은 검은 대문자 제목 + 악센트 색상 부제 + ...

...

책 제작 파이프라인