motion-script

Roteiro Papercut

A pesquisa, o roteiro, a faixa de banners, a cenografia e as piadas são escritos juntos, porque cada um alimenta os outros. O sistema completo, com o banco de frases e dois exemplos encenados, está em references/storytelling.md. Banco de piadas e formatos: references/comedy.md.

Cada batida executa três faixas que fazem trabalhos diferentes:

• Narração (mostrada como legendas): conta a história, em tom casual e segunda pessoa, muda a cada frase.
• Banner: adiciona o fato duro, número ou ressalva honesta que a narração pula, muda a cada 1,8 a 3 s.
• Cenário: ilustra literalmente um substantivo concreto da narração, com a interface do produto fazendo a demonstração, muda junto com o banner.

Pré-voo

• Instalação: o mínimo é suficiente. Resolva $MOTION_LIB apenas se você quiser a folha de fundo (style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg) ao escolher cenários. Cada imagem custa cerca de 0,7 a 1,5 mil tokens, então abra apenas o que a etapa precisar.
• Precisa do BRIEF no topo de episodes/NN-slug/research/facts.md e do bloco HOOK no topo de episodes/NN-slug/video/STORYBOARD.md. Faltando um: execute motion-strategy ou motion-hook primeiro.
• A pesquisa precisa de busca ou fetch na web, e de qualquer ferramenta de navegador para capturas de tela. Sem elas, peça ao usuário capturas de tela e fatos.

1. Pesquisa e UI aproximada

• Colete fatos da fonte com uma fonte para cada um: nome, fabricante, números, preço, requisitos, limitações, números de concorrentes. Marque qualquer coisa incerta.
• Pegue as telas principais (2 a 4), rótulos e textos de botões reais, a cor de destaque e imagens hero. O vídeo reconstrói uma versão aproximada da interface como adereços de papercut, não uma gravação de tela (references/storytelling.md seção 5).
• Confirme o enquadramento do papel a partir do BRIEF. Nunca invente comportamento do produto. Veja a nota de enquadramento de papel em $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md.
• Escreva a lista em research/facts.md abaixo do BRIEF. Todo número no roteiro, banners e interface deve ser rastreável até ele.

2. Escolha o modo

Modo	Quando
Drop de código aberto	Uma alternativa gratuita ou local a um produto pago
Lançamento de notícias / vale a pena	Um novo tier pago, modelo ou recurso de uma grande empresa
Desbloqueio de recurso / tutorial	Uma configuração ou comando oculto que muda como uma ferramenta funciona

Fórmulas de hook e o meio de cada modo: references/storytelling.md seção 6. Aplique a atualização do hook: abra a lacuna e a aposta, não a notícia.

3. Roteiro na espinha

Escreva 75 a 95 palavras para 22 a 30 s, cerca de 3,5 a 4 palavras por segundo, dentro do formato escolhido, com um novo cenário a cada 1,5 a 3 s. As 10 batidas:

1. Hook (0 a 3 s), já fixado por motion-hook
2. Prova ou tensão
3. Reenquadramento ("Então, em vez de..., você pode...")
4. Revelação do nome ("Chama-se...", nunca antes do hook)
5. Como funciona, uma demonstração concreta
6. Escalação ("E X é só o começo, porque..." mais uma pilha de exatamente três)
7. Pico ("E veja só:" mais o maior número)
8. Contraponto (a ressalva honesta)
9. Recompensa ("o que significa...")
10. Chamada para ação ("Ainda bem que eu fiz [brinde]. Para o link, comente PALAVRA-CHAVE.")

Encurte as batidas em vez de acelerar a narração. Regras:

• Segunda pessoa, contrações, orações curtas unidas por "e", "porque", "o que significa". Vocabulário no nível do público em SERIES.md.
• Nomeie uma grande marca na primeira frase, mesmo quando o assunto é outra coisa.
• Todo número é concreto e com fonte. Uma pilha de features, sempre três itens.
• Pelo menos uma limitação real, na narração ou nos banners. A palavra-chave da CTA é uma palavra curta ligada ao tópico.
• A última linha repete a palavra-chave ou número do hook, depois dá a palavra-chave.

Escreva em narration/script.json como [{"id": "l1_hook", "text": "..."}, ...], uma linha por grupo de frase ou oração. A linha l1_hook é SAY do bloco HOOK. Marque a(s) uma ou duas palavras em que cada linha se apoia (o número, a palavra de virada, o veredito) na tabela de cenografia; motion-voice as usa.

4. Faixa de banners

10 a 18 banners, 3 a 7 palavras, EM CAIXA ALTA, um fato cada, cerca de um a cada 2 a 3 s. Eles nunca repetem a narração: lidos sozinhos são uma ficha de fatos. Inclua uma estatística principal, uma tradução de preço, um fato de credibilidade, disponibilidade, pelo menos uma ressalva honesta, pelo menos um fato de confiança ou segurança, alegações de recursos, pelo menos um contraste com concorrente e um banner de alcance/ decisão antes da CTA. Tipos e exemplos: references/storytelling.md seção 3.

5. Tabela de cenografia

Uma linha por banner, escrita em STORYBOARD.md abaixo do bloco HOOK:

t (s) | PALAVRAS DA NARRAÇÃO abaixo dele | BANNER | CENÁRIO (cômodo + cor de fundo) | ADEREÇO HERO (um trocadilho visual do substantivo concreto da narração) | MOMENTO DE UI DO PRODUTO | AÇÃO DO MASCOTE E ADEREÇO DE FIGURINO | PIADA

• Um novo cenário para cada banner, cores de fundo rotativas. O cenário ilustra uma palavra da linha de narração, não o banner.
• Números viram adereços físicos: placas de preço, balanças, paredes de multiplicadores, medidores, medidores, corridas. Concorrentes aparecem como cartões fixados, nunca como o herói.
• O mascote é o substituto do espectador e reage. A interface do produto é uma reconstrução aproximada em um monitor ou laptop de papel com interações falsas.
• Um retorno a um cenário anterior antes da CTA. O cenário da CTA mostra uma caixa de comentários digitando a palavra-chave.
• motion-storyboard adiciona as colunas de câmera e transição.

6. Passagem de humor (após o roteiro, antes da cenografia ser final)

Adicione a coluna PIADA. A narração permanece séria; apenas a imagem é boba.

1. Um formato para todo o reel.
2. Uma piada por banner que encena o ponto, de references/comedy.md.
3. Um adereço de figurino por ideia. O item próprio do mascote fica e ganha um adereço por cima.
4. Uma batida de mascote sofrendo, na linha de contraponto.
5. Um adereço no quadro 0 que retorna mudado no cenário da CTA (ESTOU FORA vira GRÁTIS).
6. Um momento de fundo absurdo e inexplicado.
7. No máximo um meme, reconstruído no estilo próprio da série, nunca um clipe, foto ou áudio real.

Nenhuma piada pode cobrir o banner, as legendas ou o número-chave, e cada uma deve ser lida em menos de 1 s.

Portão

• 75 a 95 palavras, 22 a 30 s, uma limitação honesta, uma pilha de exatamente três.
• Todo número e banner é rastreável até facts.md; banners sozinhos são lidos como uma ficha de fatos.
• Última linha repete a palavra-chave ou número do hook.
• Passagem de humor feita: figurino por ideia, uma batida de sofrimento, um adereço que retorna, um momento absurdo, no máximo um meme.

Entrega

O próximo é motion-storyboard. Ele lê narration/script.json e o bloco HOOK e a tabela de cenografia em episodes/NN-slug/video/STORYBOARD.md. Para uma execução apenas do roteiro, pare aqui e forneça esses arquivos ao usuário. O prompt de storytelling copiável para outra ferramenta é references/storytelling.md seção 7.