Módulo 2.1 — Setup do mkbook

📥 Clone e instalação

Antes de qualquer coisa, ambiente pronto. Sem isso, você abandona no primeiro "command not found".

⌨️ macOS

# obrigatório
brew install pandoc git
npm install -g @anthropic-ai/claude-code

# opcional - PDF de alta qualidade
brew install --cask basictex

# opcional - MOBI
brew install --cask calibre

# clone
git clone https://github.com/inematds/mkbook.git
cd mkbook

⌨️ Ubuntu/Debian

sudo apt install pandoc git texlive-xetex calibre
npm install -g @anthropic-ai/claude-code
git clone https://github.com/inematds/mkbook.git && cd mkbook

💡 Checa antes de prosseguir

Rode pandoc --version && claude --version. Se ambos respondem, você tá pronto. Se falha, resolva ANTES — não tente improvisar.

🚀 Bootstrap em 1 comando

Existem 3 caminhos pra inicializar a bíblia. Escolha o que combina com você.

🌐 Web

Form visual com previews. Baixa bible.md pronto.

inematds.github.io/
mkbook/setup/

⌨️ CLI

Wizard interativo no terminal.

./scripts/setup.sh

📝 Manual

Para quem já fez antes.

./scripts/new-book.sh
"Meu Livro"

✓ O que acontece

Copia templates/bible.md, outline.md, stories.md pra raiz
Faz git init e primeiro commit (se ainda não é repo)
Substitui placeholder pelo título passado

🧠 Skill ebook-writer

O cérebro do pipeline mora em .claude/skills/ebook-writer/SKILL.md. Sem ela, scripts não sabem o que fazer.

📋 O que a skill define

Triggers: palavras que ativam cada um dos 7 prompts
Inputs: quais arquivos a skill SEMPRE lê antes de escrever
Outputs: onde salvar cada tipo de resultado (arquivo, não chat)
Regras invioláveis: nunca escrever sem ler bíblia, sempre puxar 1 história, respeitar glossário

💡 Skill = padronização

Sem skill, você cola prompt diferente cada vez e ganha resultados diferentes. Com skill, o mesmo trigger sempre produz mesmo formato. Reproducibilidade.

📁 Estrutura de pastas

Caminhos fixos por convenção deixam scripts simples e agentes deterministas.

mkbook/
├── bible.md # sua lei
├── outline.md # estrutura
├── stories.md # banco de anedotas
├── chapters/ # capítulos (gitignored)
│ ├── 01-draft.md
│ └── 01-edited.md
├── build/ # saídas (gitignored)
│ └── book.epub
├── scripts/ # automação
└── .claude/skills/ebook-writer/ # cérebro

🌿 Git como rede de segurança

1 commit por estágio do capítulo. Quando "polir" piora o cap, você volta na versão de ontem em segundos.

git commit -m "cap 3: draft"após write-chapter.sh

git commit -m "cap 3: edited"após edit-chapter.sh

git commit -m "cap 3: review humana"após sua revisão final

📊 Voltar versão antiga

# vê histórico do cap 3
git log chapters/03-edited.md

# volta pra versão específica
git checkout <hash> -- chapters/03-edited.md

✅ Smoke test em 10 minutos

Antes do livro real, rode pipeline com bíblia fake. Pega bugs do pandoc agora, não no dia 28.

./scripts/new-book.sh "Teste"
echo "Avatar: João, 30, dev" >> bible.md
echo "História qualquer" >> stories.md
claude
> /ebook-writer gere outline simples de 3 caps
> /ebook-writer escreva cap 1 (500 palavras)
exit
./scripts/build-epub.sh
open build/book.epub

✓ Critério de sucesso

Se book.epub abre no leitor (Apple Books, Kindle Previewer, Calibre), pipeline tá OK. Apaga o teste e começa o livro real.

⚠️ Se quebrar

"pandoc not found" → instala pandoc
"claude not found" → npm install -g @anthropic-ai/claude-code
"skill not loaded" → verifica que .claude/skills/ebook-writer/SKILL.md existe
EPUB inválido → roda epubcheck pra ver erro específico

✓ Resumo do módulo

✓

Ambiente checado antes de começar — pandoc + claude code

✓

3 caminhos pra bíblia — web, CLI ou manual

✓

Skill ebook-writer ativa — cérebro do pipeline

✓

Convenção de pastas — agentes deterministas

✓

Git por estágio — draft, edited, review

✓

Smoke test antes do livro real — pega bugs cedo

Próximo Módulo:

2.2 — ✍️ Um capítulo por dia

← Voltar para Trilha Próximo Módulo →