Roteiro de Vídeo Curto
Possui a Fase 2. Leia a direção selecionada e sua pesquisa antes de escrever. Use os contratos de artefato ao persistir a saída.
Pré-condições
Confirme que a direção está explicitamente selecionada. Se estiver faltando, redirecione de volta para
short-video-discovery. Não escolha uma direção silenciosamente, a menos que o usuário tenha solicitado
seleção automática; ao selecionar automaticamente, use a direção recomendada e registre essa suposição.
Exija que a direção selecionada faça referência à versão atual da pesquisa. Se a pesquisa estiver ausente ou desatualizada, pare e corrija a Fase 1 em vez de preencher lacunas de memória.
Rejeite ou suavize qualquer gancho que seja mais forte do que a pesquisa. Mantenha IDs de fontes vinculados a afirmações factuais ao longo do plano de cena.
Escreva em duas passagens
Beat sheet
Defina o trabalho de cada batida antes de escrever a narração polida:
- gancho de tensão;
- promessa, que pode se sobrepor ao gancho;
- configuração do caso de uso, quando necessário;
- uma a três batidas explicativas ou demonstrativas;
- conclusão com prova ou resultado;
- lição em uma frase;
- um CTA contextual, que pode se sobrepor à conclusão.
Trate o tempo como um orçamento:
| Seção | Duração típica |
|---|---|
| Gancho de tensão | 3–7s |
| Promessa | 2–5s |
| Configuração do caso de uso | 4–10s |
| Explicação/demo | 20–40s |
| Conclusão/evidência | 5–15s |
| Lição | 2–6s |
| CTA contextual | 2–6s |
Os orçamentos podem se sobrepor e não precisam preencher a duração alvo. Termine cedo quando a conclusão estiver completa.
Roteiro e plano de cena
Escreva para ser ouvido: orações curtas, uma ideia por frase, verbos concretos e pausas naturais. Evite saudação, introdução standalone com logotipo, listas densas, experiência pessoal falsa e estatísticas sem suporte.
Para cada cena, forneça:
- propósito e duração flexível;
- narração exata;
- texto na tela;
- tipo visual, ação e necessidades de ativos;
- intenção de agrupamento de legendas;
- dica de música e SFX;
- transição;
- IDs de fontes;
- notas de pronúncia Kokoro para siglas, nomes de produtos, números e URLs.
Aplique os padrões de produção do repositório:
novos vídeos usam meta.width: 2160, meta.height: 3840, meta.fps: 60 a menos que
explicitamente sobrescrito. Siga o formato gravado da solicitação; não copie metadados
de projeto antigo 1080p/30 fps para um novo roteiro padrão. O comando draft preenche
campos de formato ausentes antes da aprovação. Planeje o movimento em segundos para que sua velocidade seja
independente de fps. Mantenha os padrões de
saída em inglês, captions.mode: "word-highlight" e um plano de movimento concreto
por cena. Registre o que muda visualmente, sua dica de narração e o estado final;
"aparecer o slide" sozinho não é um plano de movimento de cena. Projete grupos de legendas para
uma ou duas linhas; os tempos reais das palavras vêm da geração de voz, não do roteiro.
Inclua o plano de som compacto dos padrões nas notas de produção: emoção pretendida, música durante gancho/explicação/revelação/fim, ducking e dicas seletivas de acento vinculadas à narração ou visuais. "Música ambiente" ou uma lista SFX vazia sozinha não é um plano de som. Leve-o para a produção sem exigir outro lembrete; respeite e registre uma substituição explícita de som pelo usuário.
Quando o usuário solicitar uma direção de arte detalhada ou o plano de cena definir layout
concreto, tipografia, cor, diagrama, legenda, movimento ou comportamento de transição,
leia ../short-video-visual-design/SKILL.md. Mantenha o planejamento visual em nível editorial
na Fase 2; JSX detalhado permanece trabalho da Fase 3.
Trate as grafias de pronúncia como candidatas a serem testadas, não instruções de renderização autoritativas. Isso é importante quando o idioma do roteiro não possui uma voz disponível no provedor TTS selecionado.
Estime a duração da fala e sinalize cenas que estão muito densas. Não resolva uma cena muito longa aumentando cegamente a velocidade do TTS; encurte o texto ou expanda a cena primeiro.
Formato de revisão
Apresente um script.md legível e conciso nesta ordem:
- título, público, faixa de duração, tom;
- gancho, promessa, conclusão, lição, CTA;
- uma tabela de cenas contendo a função da batida, narração e notas de produção;
- apenas as fontes, candidatos de pronúncia, suposições e avisos que não estejam claros na tabela;
- duração total estimada.
Peça uma decisão: aprovar o roteiro ou listar revisões. Não chame Kokoro, busque ativos de produção, inicie o Remotion Studio ou renderize enquanto a aprovação estiver pendente.
Registre edições com video script --draft (também suportado após a produção).
Após aprovação explícita, use video script --approve; não defina manualmente hashes
ou timestamps de aprovação. Registre script_approved. Redirecione para short-video-production somente quando o usuário também
solicitar uma pré-visualização ou renderização final; a aprovação por si só aguarda no portão.