bertbertov/pipeline-de-criação-de-livros

Pipeline de Criação de Livros

Fluxo de trabalho ponta a ponta para produzir livros ilustrados — um ou vários — do conceito à listagem em lojas. Complementar à skill illustrated-book (detalhes de layout de livro único); use esta skill quando o usuário estiver construindo desde um único livro de bolso ilustrado até uma série de 10 livros.

Quando usar

• "Me ajude a escrever um livro / série de livros"
• "Mesmo formato de capa, mesma voz, mesmo estilo de ilustração em N livros"
• "Gere o manuscrito completo com capas e esboços internos"
• "Traduza minha ideia em um livro de bolso Amazon + Kindle + audiolivro publicável"

Quando NÃO usar

• Uma tradução fiel de obra protegida por direitos autorais de terceiros — consulte conversa sobre direitos de tradução
• Um livro infantil ilustrado — pipeline de layout/ilustração diferente
• Referência de não-ficção pura (livros didáticos, manuais) — estrutura diferente
• Um romance literário onde a assinatura visual é fotográfica — use a skill illustrated-book diretamente com Padrão A ou B

---

O pipeline (qualquer número de livros)

Abaixo está o fluxo de trabalho comprovado. Ele escala: um único livro usa as Fases 0-9 sequencialmente. Uma série de N livros adiciona despacho de agentes paralelos na Fase 5 e um SERIES_GUIDE.md na Fase 1. As fases posteriores (compilação, audiolivro, publicação) são idênticas por livro.

Fase 0 — Bloqueio de conceito (ALINHAMENTO com o usuário, obrigatório)

Antes de escrever qualquer coisa, alinhe com o usuário:

1. Número de livros, títulos e o fio condutor. Qual ansiedade / domínio / curiosidade cada livro aborda? Para um único livro, apenas o título + gancho. Para N livros, o arco da série.
2. Registro de voz. Escolha um e confirme com um parágrafo de amostra de voz:
   • Manson-picante (palavrões, direto)
   • Burkeman-cerebral (sem palavrões, contemplativo)
   • Manson × Burkeman × Gor (autoajuda descontraída, sabedoria oriental leve, sem palavrões)
   • Pelevin-tradição literária (filosófico, surreal, denso)
   • Sebald-meditativo (fotográfico intercalado com prosa)
3. Persona do autor — decisão mais importante.
   • Autobiográfica (o usuário) — cativante, mas arriscada se o usuário for de nicho
   • Pseudo-autobiográfica genérica ("um engenheiro de meados dos 30", "um professor nos seus 40 anos") — apelo mais amplo
   • Narrador ficcional em terceira pessoa
   • Teste crítico: pergunte "qual é o gancho para o comprador frio?" Se a persona exigir educação do leitor antes que ele possa se engajar (subcultura de nicho, enquadramento de imigrante estrangeiro, tradição religiosa específica), o comprador frio da Amazon não se interessará. Genérico, mas relacionável, vence quase sempre.
   • Execute uma amostra de 1 capítulo ANTES da redação paralela em escala. Deriva de persona descoberta após 100 mil palavras é brutal de corrigir.
4. Cadência (apenas para vários livros). Lançamento rápido em 2-4 semanas (máximo impulso algorítmico KDP) vs. um de cada vez.
5. Idiomas. Apenas EN, ou EN + RU / outro — afeta a escolha do motor de audiolivro (conforme project_audiobook_engine.md).
6. Direitos. Se o usuário referenciar livros existentes para "seguir", confirme se ele tem direitos de tradução. Trabalho original em registro similar é limpo de direitos; tradução sem direitos não é.

Fase 1 — Estrutura de pastas

Books/<Project_Name>/
├── _series/                         # apenas para vários livros; pule para livro único
│   ├── SERIES_GUIDE.md              # voz + persona + dispositivos recorrentes + bíblia de arte
│   ├── _gen_covers.py               # gerador de capas
│   ├── _gen_sketches.py             # gerador de esboços internos
│   └── test_sketches/               # amostras para aprovação
├── 01_<Book_Slug>/                  # para livro único, apenas uma pasta sob Books/
│   ├── BOOK_PLAN.md                 # esboço do capítulo (qualquer N capítulos; 25 típico)
│   ├── chapters/                    # arquivos NN_slug.txt
│   ├── images/00_cover.png          # capa principal
│   └── sketches/                    # ilustrações internas
├── 02_<Book_Slug>/...               # livros adicionais
└── _publishing/                     # kits de metadados por livro

SERIES_GUIDE.md (ou BOOK_GUIDE.md para livro único) deve incluir:

• Registro de voz (com exemplos positivos + registros PROIBIDOS)
• Persona do narrador (biografia específica, textura, coisas para extrair, coisas para NÃO revelar)
• Dispositivos recorrentes (ex.: padrão "Eu tentei isso", parábola recontada moderna, uma âncora meditativa — escolha uma prática universal se o livro tiver momentos de sabedoria)
• Bíblia de arte de esboço (prefixo de prompt BLOQUEADO; testado via amostras de aprovação)
• Bíblia de capa (fórmula de composição — mesmo X em todas as capas da série)
• Convenções de marcadores (Fase 4)
• Listas de verificação de produção

Fase 2 — Geração de capas

Melhor da classe para texto legível em capa: modelo Google Gemini Nano Banana Pro (nano-banana-pro-preview). Melhor para cenas gerais com tipografia mais limpa: Nano Banana Flash (gemini-2.5-flash-image). Alternativa local: Flux Krea Dev FP8 via ComfyUI.

As chaves de API devem ser fornecidas via variável de ambiente — nunca codificadas no script:

export GEMINI_API_KEYS="key1,key2,key3,key4"   # separadas por vírgula, serão rotacionadas

Ou por chamada:

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

Fórmula de composição de capa (comprovada para séries de autoajuda descontraída; adapte por gênero):

• TOPO: NOME DO AUTOR em caps espaçadas com separador de logotipo opcional
• Título: caps em negrito estilo desenho à mão preenchendo o terço superior (a manchete clickbait)
• Subtítulo em cor de destaque (a promessa descritiva)
• Herói pequeno no quadro, ambiente domina
• Rodapé: citação em caps pequena (ex.: "DO AUTOR DE ___")
• Coesão da série: mesmo motivo visual recorrente em todas as capas (um chapéu, uma cadeira, uma janela — qualquer coisa consistente)

Regras de prompt (aprendidas em 2026-04-25):

• NÃO peça "espaço de céu branco vazio no topo" → produz faixa plana estourada. Deixe a cena preencher o quadro; sobreponha o título na sombra natural.
• COLOQUE o texto exato entre aspas ("o texto diz exatamente: '…'") — Pro reproduz literalmente.
• DIGA "a cena inteira preenche o quadro até o topo, SEM espaço negativo estourado."

Fase 3 — Portão de aprovação de esboço (obrigatório)

NÃO gere o lote completo de esboços antes de obter aprovação do usuário. Sempre:

1. Gere ~10 esboços de teste em alta qualidade (Flux Krea Dev FP8 a 1024×1024, 25 passos)
2. Mostre ao usuário → aguarde aprovação
3. Após aprovação, mude para configurações de produção mais rápidas (768×768, 18 passos) para aceleração de ~3-4×
4. Teste as configurações aceleradas com 1 esboço — confirme que a qualidade corresponde ao estilo aprovado
5. Então execute o lote completo

Prefixo de prompt de produção bloqueado para arte de linha de desenho animado (estilo Gor, comprovado em 2026-04-25):

Black ink loose hand-drawn pen sketch on pure white background,
minimalist cartoon line art, single subject, no shading, no fills, no grayscale tones,
no color, no gradient, no background detail, just black lines on white,
simple expressive contour lines, slight wobble, lots of empty white space,
flat 2D illustration, the entire image is pure solid white with only black ink lines drawn on it.
NOT a photograph, NOT a notebook page, NO paper texture, NO frame, NO binding, NO border.

Prompt negativo bloqueado:

photorealistic, photograph of a sketch, photograph of a notebook, paper texture,
notebook binding, page edges, sketchbook, journal, frame around the drawing,
3D render, color, gradient, shading, watercolor, oil paint, anime, manga,
intricate background, busy composition, detailed environment, gray fills,
cross-hatching, dense linework, decorative border, dark background, black background

Armadilha comum: se os esboços voltarem como fotos de desenhos a caneta dentro de um caderno, seu prompt mencionou "livro de bolso" / "caderno" / "entre parágrafos" → remova essas frases.

Para outros estilos (aquarela, fotocolagem, vetor plano, etc.), substitua o prefixo do prompt e execute o mesmo portão de aprovação.

Pós-processamento: qualquer pixel com R+G+B > 720 → ajuste para (255,255,255). Limpa tons quase brancos.

Fase 4 — BOOK_PLAN.md por livro

Cada livro recebe um esboço de capítulo. Três atos de ~⅓ cada. Elementos necessários:

• Slug de nome de arquivo para cada capítulo (snake_case)
• Resumo do capítulo em um parágrafo
• Lista de dicas de esboço (elementos visuais recorrentes)
• Banco de citações candidatas (o agente usa algumas, inventa outras)
• Posicionamento de âncora meditativa recorrente (~3 capítulos por livro, se aplicável)
• Regras de referência cruzada (relevante apenas para séries com vários livros)

Contagem de capítulos: 15-30 é típico. Alguns manifestos funcionam com 10 capítulos; alguns romances literários com 40+.

Fase 5 — Redação

Livro único: despache UM agente general-purpose com o BOOK_GUIDE.md + BOOK_PLAN.md.

Série com vários livros (paralela): despache UM agente general-purpose POR LIVRO. Cada agente recebe:

• Caminho para SERIES_GUIDE.md (leia primeiro)
• Caminho para seu BOOK_PLAN.md
• Especificação da persona recapitulada no próprio prompt (defesa em profundidade)
• Especificação da pasta de saída
• Convenções de marcadores (Fase 6)
• Meta de palavras por capítulo e total
• Diretiva de salvar conforme avança (não lote na memória)
• Formato de relatório de retorno

Limite da API Anthropic: 4 agentes general-purpose paralelos é o teto seguro. 5+ pode sofrer limitação.

Vigilância de deriva de persona. O modo de falha número um é o agente pegar a textura errada da persona. Durante o voo, periodicamente faça Grep por tokens proibidos (o que você definiu como fora dos limites no GUIDE). Se detectado, pare, arquive, reescreva o GUIDE de forma mais enfática, redespache.

Fase 6 — Convenções de marcadores

Arquivos .txt de origem usam tokens de marcador que o script de compilação substitui.

Marcador	Onde	Renderiza como
[SKETCH: descrição da cena]	Em linha, em sua própria linha	Um PNG de esboço pré-gerado inserido naquela posição
[QUOTE: citação de uma frase]	Em linha	EPUB: citação em HTML estilizada. PDF: citação estilizada OU regenerada como gráfico
[SEEDS]…[/SEEDS]	No final do capítulo, com marcadores -	Caixa de citação estilizada com aforismos em itálico com serifa (o dispositivo "Sementes de Sabedoria" de Gor)
Primeira e última entradas img_map	Mapa de imagem por capítulo	Ilustração de marquise de página inteira ANTES do texto do capítulo. Entradas do meio → quebra de texto (Padrão B v2 da skill illustrated-book)

Adote ou omita cada marcador conforme o gênero. Autoajuda e espiritualidade popular usam todos os quatro. Romances literários geralmente usam apenas [SKETCH:] e o mapa de imagem do capítulo.

Fase 7 — Geração de esboços (lote de produção)

Após todos os capítulos redigidos:

1. Grep todos os marcadores [SKETCH:] nos arquivos chapters/
2. Execute o script gerador de esboços em lote — gera um PNG por marcador em <book>/sketches/
3. Convenção de nomenclatura de arquivo: <chapter_slug>_s01.png, _s02.png, etc.
4. Pós-processamento de clareamento
5. Configurações de produção (bloqueadas para arte de linha): 768×768, 18 passos, Flux Krea Dev FP8, euler/simple, cfg 1.0, guidance 3.0

Taxa de transferência: ~15s/esboço em RTX 5080. 400 esboços em ~1,5 horas.

Fase 8 — Compilação (conforme skill illustrated-book)

Use o script comprovado _compile_novel.py (lida com PDF fpdf2 + EPUB ebooklib). O script suporta o conjunto completo de marcadores da Fase 6 e o layout híbrido (Padrão B v2: primeira + última entradas img_map tornam-se marquises de página inteira; entradas do meio quebram texto com alternância L/R).

Por livro:

python _compile_novel.py <Project_Name>/<Book_Slug>

Saídas: <Book>_EN.pdf, <Book>_EN.epub, <Book>_Cover_Amazon.jpg (1600×2560), e <Book>_RU.{pdf,epub} se existirem capítulos em RU.

Fase 9 — Audiolivros (Audiobook-Engine)

cd <caminho do Audiobook-Engine>
tts.bat audiobook "<caminho completo da pasta do livro>" en

EN: Kokoro v1.0 af_heart (~25-49× RTF). RU: F5-TTS Misha24-10 com voz clonada (~1× RTF). Saída: <Book>_AUDIOBOOK_<LANG>.mp3 a 192 kbps.

Fase 10 — Publicação

Use o padrão de kit de metadados de publicação: pacote de metadados por livro com categorias KDP, códigos BISAC, palavras-chave, preços sugeridos, resenha (HTML), títulos comparativos, biografia do autor. Unidade híbrida: prepare metadados, usuário abre KDP/Kobo/Google Play, cola/envia.

Para série com vários livros: lançamento rápido em 2-4 semanas, KDP Select apenas no Livro 1.

---

Lições críticas (comprovadas em várias execuções de livros até 2026-04-25)

1. A iteração de persona é a fase de maior risco

Redigir em escala com a persona errada é brutal de desfazer. Sempre execute uma amostra de 1 capítulo da persona proposta ANTES da redação paralela. Pergunte explicitamente: "isso é atraente para um comprador frio da Amazon?"

2. A voz autobiográfica do usuário raramente é o gancho certo

Autores imaginam que os leitores ficarão fascinados por sua vida real. Leitores frios querem projetar. Use como padrão o pseudo-autobiográfico genérico a menos que o usuário tenha reconhecimento de nome demonstrável.

3. O portão de teste de esboço é inegociável

~10 esboços de teste → aprovação do usuário → configurações de produção → teste de fumaça → lote completo. Pular o portão produz centenas de esboços errados.

4. Regras de prompt de capa

• Evite "espaço de céu branco vazio" → faixa plana estourada
• Coloque o texto exato entre aspas no prompt — Pro reproduz literalmente
• Coesão da série = diga explicitamente "mesmo X das capas anteriores" no prompt

5. Regras de prompt de esboço

• Evite "livro de bolso / página de caderno" → Flux enquadra o esboço como foto de caderno
• Use "desenho 2D plano em branco puro" em vez disso

6. Modelo de cota de API de capa

O nível gratuito do Nano Banana Pro é por chave por janela de tempo, não por dia total. Rotacione chaves; quando uma sofre limitação de taxa, a próxima assume após ~45s de resfriamento.

7. Audiolivro Kokoro: fixe o índice de estilo

Kokoro-onnx tem um bug de off-by-one em MAX_PHONEME_LENGTH=510. Corrija o helper:

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

8. Faça backup antes de redefinir

Quando uma mudança de persona for necessária no meio da redação, arquive os capítulos antigos (mova para _v1_old_persona_archive/). Não exclua. Eles contêm estruturas reutilizáveis, batidas e citações que podem ser mineradas para a v2.

9. As fases de compilação + audiolivro + publicação são 90% reutilizáveis

Uma vez que o GUIDE e o PLAN estejam corretos, o pipeline downstream é executado inalterado. Investimento: ~2 horas de configuração do pipeline uma vez. Por livro downstream: ~30 min.

10. A mesma fórmula de capa de estilo russo reproduz-se limpidamente via Nano Banana Pro para livros em inglês

Hat + cenário tropical + título em caps negrito preto + subtítulo em cor de destaque + ...

... (truncado para tradução)