O que Roteiro de Vídeo faz?
O roteiro é o produto. PRÓXIMOS PASSOS é um bônus que aponta para o próximo trabalho.
1. Escolha o modo primeiro
Pergunte: animação, live action ou documentário? Se o briefing tornar óbvio, diga qual você escolheu e por quê em uma linha. Em seguida, leia o guia correspondente antes de escrever:
- Animação ou motion graphics:
references/animation.md - Live action, comercial, roteirizado:
references/live-action.md - Documentário, testemunhal, baseado em entrevistas, história de marca com pessoas reais:
references/documentary.md
Um híbrido (live action com gráficos animados, um documentário com abertura roteirizada) usa o guia do modo principal e empresta regras do outro para aqueles quadros. Diga isso.
2. Coleta (uma mensagem curta, apenas o que está faltando)
- Nome da marca e do produto, exatamente como o cliente diz.
- Duração (15, 30, 60, 90s, ou mais).
- Público-alvo e a única coisa que devem fazer ou sentir.
- Perfil da marca. Aceite um PDF de guia de marca, logotipos, capturas de tela, um site ou notas digitadas. Extraia paleta, tipografia, regras de logotipo, tom, slogan, palavras obrigatórias e proibidas. Resuma em 5 a 8 linhas e confirme. Ofereça salvar como
references/brands/<marca>.mda partir de_template.md. Nunca redesenhe um logotipo. - Perguntas específicas do modo do guia (dias de gravação e orçamento para live action; temas e B-roll para documentário).
- Notas legais que o cliente já possui. Não espere por elas. A Etapa 5 faz uma primeira análise.
Trabalhe com informações parciais. Sinalize lacunas. Nunca as preencha com invenção.
3. Estrutura
Construa o arco antes de escrever as linhas: gancho, problema, virada, prova, produto, payoff, fechamento. Espaços curtos comprimem isso. Use quaisquer nomes de seção do briefing como espinha dorsal.
4. Escreva
Siga o guia do modo. Regras compartilhadas para todos os modos:
- LOCUÇÃO é o texto final, escrito para ser falado: frases naturais e completas que carregam um pensamento real e conectam um quadro ao outro. Sem sequências de fragmentos, sem slogans empilhados. Um fragmento no fechamento, se merecer.
- VISUAL é escrito como direção: duas a três frases completas sobre enquadramento, movimento, luz e transição, em linguagem de produção ou animação conforme o modo exigir.
- Cerca de 2 palavras de LOCUÇÃO por segundo. Introdução e fechamento permanecem leves. Aperte primeiro os quadros mais densos.
- Nunca invente estatísticas, citações, nomes ou alegações. Use a fonte como escrita.
- TÍTULOS: 2 a 6 palavras. Ecoe o ritmo, nunca repita a LOCUÇÃO palavra por palavra. Linhas legais marcadas como
LEGAL:. - Sem travessões. Sem enchimentos. Sem jargão de IA ("desbloquear", "perfeito", "no mundo de hoje").
5. Primeira análise legal
Uma lista de sinalizações, não um aconselhamento jurídico. Diga isso uma vez. Verifique cada quadro para:
- Alegações: números, superlativos ("melhor", "#1", "comprovado"). Cada um precisa de fonte, data e escopo.
- Comparações com concorrentes, nomeados ou implícitos.
- Depoimentos e citações: aprovação por escrito, resultados típicos, divulgação paga.
- Categorias reguladas: saúde, suplementos, finanças, seguros, crianças, álcool, alegações ambientais.
- Preços, ofertas, testes: termos na tela.
- Marcas registradas, marcas de terceiros e UIs. Direitos: música, banco de imagens, semelhança, fontes.
- Autorizações para pessoas e locais (live action e documentário).
- Acessibilidade: sobreposições mantidas por tempo suficiente para leitura, legendas planejadas.
Cada sinalização: quadro, palavras exatas, o risco em uma linha, uma reescrita mais segura. Nunca altere o texto aprovado silenciosamente.
6. Próximos passos (bônus, mantenha conciso)
- Resumo: uma frase.
- Notas de tratamento: um parágrafo curto de 3 a 5 frases sobre visual, ritmo, música e tom da locução, transições.
- Âncora de estilo + prompts de quadro: uma linha de estilo, depois um prompt de imagem IA por quadro, para storyboards. Sem texto nas imagens, exceto no quadro do logotipo. Sem pessoas reais ou personagens registrados.
- Viabilidade (live action): dias, locais, principais, sinalizações.
- Sinalizações legais e perguntas em aberto.
- Próxima skill: live action vai para um deck de pré-produção; documentário vai para um cronograma de entrevistas e lista de takes de B-roll.
7. Renderizar
python scripts/build_script.py frames.json outputs/<nome>.xlsx \
--title "<Marca> - <Projeto>" --runtime "60-seconds" --type "Live Action" --notes notes.json
--type: Animation, Live Action ou Documentary.
Cada quadro: frame, time, visual, audio, title, prompt.
Para documentário, audio contém o TESTEMUNHO FONTE e TESTEMUNHO ALVO, title o terço inferior ou sobreposição.
notes.json: summary, treatment, style_anchor, feasibility, legal_flags, open_questions
(listas), além de para documentário interviews ([{"subject": "", "questions": [""]}]) e
broll ([{"location": "", "shots": [""], "must": true}]).
Exemplos: references/frames_example.json, references/notes_example.json,
references/documentary_example.json.
Nome do arquivo: código do projeto, se fornecido, senão <Marca>_<Projeto>_Script_v1.xlsx.
Mantenha uma cópia do roteiro como um arquivo JSON (title, runtime, type, frames, notes). O construtor lê diretamente dele, e a próxima etapa (deck de pré-produção) captura o título dele.
Passo de revisão (sempre, antes de apresentar)
Cada resposta é executada duas vezes. O usuário nunca vê o primeiro rascunho.
- Rascunhe a resposta completa.
- Revise como um diretor criativo e produtor exigentes fariam, contra a lista de verificação abaixo e todas as regras desta skill. Leia o texto como se estivesse ouvindo em uma reunião com o cliente. Marque cada falha.
- Corrija cada falha, depois apresente apenas a versão revisada.
- Termine com uma linha:
Revisão: <o que mudou>, ouRevisão: nenhuma alteração necessária.
Isso se aplica a cada etapa que produz algo: pesquisa, opções, texto, especificações e arquivos. Para um arquivo, construa-o, abra ou renderize, verifique, depois corrija e reconstrua antes de entregá-lo.
Lista de verificação
- Os timecodes são executados sem lacunas e terminam na duração. A LOCUÇÃO está dentro do orçamento. Avisos do construtor em zero.
- A LOCUÇÃO soa natural em voz alta como pensamentos completos que conectam um quadro ao outro, não slogans empilhados.
- Cada VISUAL diz ao diretor, diretor de fotografia ou animador o que fazer: enquadramento, movimento, luz, transição.
- Nenhuma estatística, citação, nome ou alegação inventada. Análise legal concluída. Sem travessões, sem jargão de IA.
8. Verifique, depois apresente
- O construtor verifica timecodes (sem lacunas, terminando na duração) e imprime a contagem de LOCUÇÃO contra um orçamento de 2 palavras por segundo. Corrija cada aviso.
- Nenhum número, nome ou citação inventado. Sem travessões. Análise legal concluída.
- Apresente o arquivo. Depois 2 a 4 linhas: modo, arco, contagem de quadros, palavras de LOCUÇÃO, principais sinalizações.
- Não faça nada extra a menos que solicitado.