DIRETOR DE STORYBOARD
Obrigatório
Um storyboard não é apenas uma lista de imagens. Cada cena e batida deve declarar: texto/narração, visuais, posição/layout, movimento, som e tempo. Use o template docs/templates/STORYBOARD_TEMPLATE.md.
Fluxo de Trabalho
- Feche o briefing, o formato vertical 1080×1920, 60 FPS, duração, público, bíblia de estilo e mensagem principal.
- Divida o roteiro em sentenças/batidas atômicas; atribua IDs estáveis (
S01-B01, etc.). Não mescle sentenças diferentes sem motivo. - Para cada batida, escreva o texto exato de VO, o texto exato na tela, o que é visível, o sujeito/ativo e a ação.
- Defina posições com coordenadas normalizadas 0..1 (x, y, w, h), âncora, alinhamento, camada/z-order, área segura e direção de leitura. Inclua tamanhos/posições em pixels quando necessário.
- Defina enquadramento, câmera, transições, movimento de entrada/saída, duração, quadro inicial/final e sobreposição.
- Grave áudio: clipe de VO, música, ambiência, SFX, quadro de sinal, duração, ganho relativo, fade e pausas/silêncio.
- Associe cada sentença de VO a um ou mais visuais/planos que esclareçam seu significado. Evite visuais literais repetitivos; use metáfora quando funcionar melhor.
- Valide continuidade, legibilidade em mobile, área segura, tempo e se a duração total corresponde.
Saída obrigatória por batida
- ID, cena, quadro inicial/final, duração em quadros e segundos.
- ID da sentença de VO + texto.
- Texto na tela + posição.
- Visual/ativo + composição e posição.
- Movimento/câmera + easing.
- Sinal de áudio: tipo, arquivo/placeholder, início/fim, nível relativo, fade.
- Transição de entrada/saída e notas de continuidade.
Regras
- Todo texto visível deve ser escrito literalmente, não "adicione um título".
- Todas as posições devem ser explícitas, não "aproximadamente no meio".
- Todo som deve ser registrado, incluindo a decisão de ter nenhum som/silêncio.
- Não invente ativos que ainda não existam; marque-os como
PLACEHOLDERe liste os requisitos do ativo. - Duração da batida a 60 FPS:
durationInFrames = endFrame - startFramecom limite final exclusivo. - Um logotipo final + CTA é obrigatório e deve ser específico do vídeo, não genérico.
Convenções de ID e tempo
- ID da batida:
S<cena>-B<batida>com dois dígitos (S01-B01). Os IDs não mudam quando uma batida se move; uma batida inserida recebe um novo ID (S02-B03) em vez de renumerar tudo. - Intervalo semi-aberto
[startFrame, endFrame): o quadroendFramejá pertence à próxima batida. - Converta de segundos apenas uma vez, em um só lugar:
frame = round(segundos × fps). A partir daí, todo número no storyboard é um quadro inteiro. - Batidas consecutivas devem ser contíguas: o
endFrameda batida N = ostartFrameda batida N+1. Sobreposição só é permitida para janelas de transição registradas na coluna Transição. - Total: o
endFrameda última batida = odurationInFramesda composição.
Formato de saída
- Cabeçalho: ID do projeto, canvas, FPS, duração (segundos + quadros), caminhos para a bíblia de estilo e plano de áudio.
- Tabela de batidas seguindo
docs/templates/STORYBOARD_TEMPLATE.md. - Notas por batida para batidas complexas (movimento em múltiplos estágios, personagens, 3D).
- Mapeamento frase-para-plano quando há VO, ou uma única linha "não aplicável — sem VO".
- Folha de referência de áudio, incluindo silêncio intencional.
- Especificação de cartão final personalizado.
- Lista de ativos
PLACEHOLDERcom requisitos e status de licenciamento.
Checklist de QA
- Cada batida tem um ID, quadro entrada/saída, texto literal (ou "—"), visual, posição normalizada, movimento, som e transição.
- As batidas são contíguas a partir do quadro 0; a soma das durações =
durationInFrames. - Texto importante está na área segura e pode ser lido em uma tela de telefone (tamanho, contraste, tempo na tela).
- O texto permanece na tela tempo suficiente para ser lido; sentenças longas são divididas ou recebem mais tempo.
- Cada sentença de VO tem um plano emparelhado; cada plano tem um propósito editorial.
- O silêncio é escrito explicitamente, não deixado em branco.
- O movimento é descrito como uma função do quadro (de/para, intervalo de quadros, easing), pronto para ser traduzido por
frame-time-engineering. - O cartão final continua o motivo do vídeo e sua CTA é literal.
- Todo ativo que ainda não existe está marcado como
PLACEHOLDER.
Mini exemplo
Uma batida de gancho textual de 2 segundos:
| ID da batida | Quadros | VO | Texto na tela | Visual | Posição | Movimento | Som | Transição |
|---|---|---|---|---|---|---|---|---|
| S01-B01 | 0–120 | — | Por que seu vídeo parece genérico? | Fundo escuro liso | x .08, y .40, w .84; alinhado à esquerda; z 2 | Cada palavra entra a cada 10 quadros, slide-up 24 px, duração de 14 quadros, ease-out | Silêncio 0–30, SFX-001 whoosh em 30 | corte |
Movimento pronto para codificar: palavra i começa no quadro i × 10; opacity 0→1 e translateY 24→0 durante [i×10, i×10+14].
Modos de falha
- "Texto aparece no meio" → não pode ser codificado; escreva x/y/w/h, âncora e alinhamento.
- Batidas com diferença de um quadro (
0–119e depois120–240) → a convenção exclusiva não foi usada; mude tudo para semi-aberto. - Texto alterado no código mas não no storyboard → o storyboard é a fonte da verdade para o texto; atualize o storyboard primeiro.
- Duração total não corresponde à composição → recalcule a partir da tabela; não remende no código.
- Visuais muito literais por sentença → use uma demonstração, diagrama ou metáfora; registre o motivo.
- Cartão final é um logotipo + "Siga-nos" → não personalizado; construa uma ponte visual a partir do motivo do vídeo.