Mapa da trilha
Conteúdo detalhado
⚙️ Setup do projeto mkbook
Clonar, instalar dependências e ter pipeline funcional em 10 minutos.
Comandos pra clonar o repo, instalar pandoc/calibre e checar que Claude Code está autenticado.
Sem ambiente pronto, você abandona no primeiro erro de "command not found".
Dependency check, fail-fast setup, smoke test.
Script que copia templates pra raiz, faz git init e primeiro commit em 1 comando.
Bootstrap reproduzível: você sempre começa do mesmo ponto.
Idempotent setup, project scaffolding.
Skill custom em .claude/skills/ebook-writer/ que orquestra os 7 prompts.
Skills são reutilizáveis e padronizam invocação. Sem skill, cada vez você cola prompt diferente.
Skill triggers, pipeline persistente.
Onde mora cada coisa: bíblia/outline na raiz, capítulos em chapters/, saídas em build/.
Caminhos fixos deixam os scripts simples e os agentes deterministas.
Convention over configuration.
Padrão de commits: draft → edited → final, cada um com mensagem clara.
Quando um capítulo piora depois de "polir", você volta na versão de ontem em segundos.
Atomic commits, time travel, rollback grátis.
Rodar a pipeline inteira (write → edit → build) com bíblia dummy pra garantir que tudo funciona.
Você descobre bug do pandoc agora, não no dia 28 do projeto.
End-to-end test, ambiente de validação.
✍️ Um capítulo por dia
Prompt 3 do framework rodando como script. Bíblia + outline + stories alimentam o agente.
5 padrões de abertura que funcionam: cena, dado chocante, pergunta, contradição, promessa.
Leitor decide continuar ou fechar nos 3 primeiros parágrafos. Sem hook, perde.
Cold open, in medias res, pattern interrupt.
Como as amostras coladas em bible.md moldam ritmo, gírias e construção das frases.
Sem amostras suficientes, sai "voz LLM padrão". Compare antes/depois de adicionar mais texto-modelo.
Few-shot prompting, in-context voice cloning.
Como tags em stories.md guiam o agente a escolher e reescrever 1 anedota relevante.
Capítulo sem história = blog post. Com história = livro que viraliza no boca a boca.
Tag retrieval, story-first writing.
Como costurar seções sem usar conectores zumbis ("portanto", "em seguida", "neste tópico").
Transição forçada quebra fluxo. Transição implícita por pergunta segura o leitor.
Smooth pacing, narrative momentum.
Cada seção termina com 1 coisa concreta que o leitor consegue fazer essa noite.
Livro só teórico não muda nada. Takeaway = mudança = review positiva.
Implementation intention, next-step concrete.
Última frase do capítulo abre tensão que só o próximo resolve.
Diferença entre livro abandonado no cap 4 e livro lido até o fim.
Open loop, cliffhanger discipline, completion rate.
✂️ Editor implacável
Prompt 4. Capítulo nota 7 vira nota 10 sem dó: cortar, reescrever, eliminar repetição.
Primeiro draft sempre tem 20% de gordura. Editor identifica e corta sem dó.
Texto enxuto lê mais rápido, vende melhor e parece mais autoral.
Word count discipline, kill your darlings.
Substituir "ele estava nervoso" por "a mão dele tremia ao pegar o café".
Telling soa LLM. Showing convence e gruda na memória.
Concrete detail, sensory writing.
Por que esses 10% sustentam 90% da experiência. Onde focar a revisão.
Leitor sempre lê abertura. Quase sempre lê fechamento. O meio ele escaneia.
Primacy/recency effect, edge polish.
Editor flagga palavras repetidas em proximidade e sugere sinônimos contextuais.
Repetição não-intencional cansa o leitor sem ele perceber por quê.
Lexical variety, prose rhythm.
Editor checa cada termo técnico contra o avatar da bíblia — explica ou substitui.
Jargão sem definir é o motivo nº 1 de review 1 estrela em não-ficção.
Reader-level matching, accessibility.
Como pedir ao editor uma avaliação numérica + lista do que falta pra virar 10.
Sem nota você nunca sabe se melhorou. Com nota, vê progressão objetiva.
Quantified critique, iterative refinement.
🔍 Consistência cruzada
Não está no framework original. mkbook adiciona: verificador roda contra TODOS os capítulos pra achar contradições.
Agente checa se cada termo do glossário é usado da mesma forma nos 12 capítulos.
"Agente" vira "bot" no cap 7 — leitor estranha. Sem checker você não percebe.
Term consistency, vocabulary drift.
Análise de tom/ritmo/formalidade comparando capítulos contra a bíblia.
Capítulos escritos em dias diferentes podem ter humor diferente. Verificador acha.
Voice drift, style cohesion.
Detecta se você (ou o agente) repetiu a mesma história em capítulos diferentes.
Repetir história é o erro nº 1 que faz leitor pensar "esse livro só tem isso".
Anecdote deduplication, freshness check.
Para cada capítulo, agente confere se a promessa do outline foi cumprida.
Capítulo que não entrega o prometido frustra. Esse check pega cedo.
Promise-payoff loop, contract check.
Confere se o fim do Cap N gancha logicamente com a abertura do Cap N+1.
Cliffhanger desconectado parece falso. Conexão real puxa pra continuar.
Narrative bridge, pacing.
Varre cada capítulo procurando padrões proibidos na bíblia (clickbait, promessa irreal etc).
Garante integridade da marca-livro mesmo após muitas iterações de IA.
Brand integrity gate.