LordVayron/video-factory

Transforma um roteiro aprovado em cenas, folhas de bloqueio e planos (projects/<slug>/shotlist.json) construídos para continuidade — cada cena é storyboardizada como uma imagem de grade e filmada como uma geração de múltiplos planos, para que os personagens mantenham suas posições, adereços e lados de tela entre os cortes. Use após o roteiro ser aprovado, quando os planos quebrarem a continuidade ou ao planejar cobertura para diálogos.

O que é video-factory?

Esta skill, chamada Cinematographer, transforma um roteiro aprovado em um plano de filmagem detalhado, garantindo continuidade técnica entre os cortes. Ela opera com base no princípio de que modelos de IA (Higgsfield Popcorn, Wan 3.0 / Seedance 2.0) mantêm a continuidade quando uma cena é gerada **em conjunto** e a perdem quando cada plano é gerado isoladamente. Por isso, a skill define uma cena como uma unidade de local e momento, com até 15 segundos, storyboardada como uma única imagem de grade e gerada como um único vídeo de múltiplos planos — abrindo no primeiro painel da cena e usando referências de personagens, cenário e voz. A skill gera um arquivo `shotlist.json` com metadados completos de cada plano: duração, enquadramento, lente, câmera, movimento, diálogo, efeitos sonoros e bloqueio (posição, direção, postura e adereços de cada personagem). Ela impõe regras rígidas de continuidade, como a regra dos 180° (lados de tela nunca invertem), a proibição de mudanças de lugar fora da tela sem um plano de transição, e a exigência de que planos individuais sejam sujos — ou seja, mantenham a borda do parceiro de cena no quadro. A skill também inclui uma validação automática via `engine/continuity.mjs`, que compara um quadro de cada plano com o planejado e rejeita takes que violem a continuidade (fundo, lado, teletransporte, dia/noite, assento vazio, guarda-roupa). É ideal para planejar cobertura de diálogos, consertar planos que quebram a continuidade ou garantir que uma sequência inteira de cenas mantenha coerência visual.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/LordVayron/video-factory/tree/HEAD/.claude/skills/cinematographer

Documentação

Cinematographer

Leia references/cinematography.md (gramática visual, estilo) e references/models.md (modelos) uma vez por sessão.

Pense em cenas, não em planos

Pesquisa (Higgsfield Popcorn, Wan 3.0 / Seedance 2.0 multi-shot): modelos de IA mantêm a continuidade quando uma cena é gerada junta, e a perdem quando cada plano é gerado sozinho. Portanto:

Cena = um local, um momento contínuo, ≤ 15 s, 2–5 planos de 2–5 s cada.
Storyboard = UMA imagem de grade por cena (todos os painéis em uma geração) → dividir em painéis.
Vídeo = UMA geração de múltiplos planos por cena (Plano 1 [0-3s] … Corte seco. Plano 2 [3-6s] …), abrindo no primeiro painel da cena, com referências de personagem e cenário e referências de voz.
Um episódio de 20 s tem tipicamente 2 cenas → 2 imagens de grade + 2 gerações de vídeo, todas executadas em paralelo.

shotlist.json

"scenes": [
  { "id": "A", "summary": "uma linha: o que acontece", "shots": ["s01","s02","s03"],
    "blocking": "Milo senta na CADEIRA ESQUERDA da mesa redonda de frente para a direita, papel à sua frente; Rex senta na CADEIRA DIREITA de frente para a esquerda; Ana não está na sala." }
],
"shots": [ { "id": "s01", "duration": 3, "characters": ["milo","rex"], "framing": "plano médio dois", "lens": "lente 35mm", "camera": "câmera fixa",
             "image": "momento congelado para o painel do storyboard", "motion": "o que muda neste plano",
             "dialogue": [{ "char": "milo", "text": "…", "delivery": "…" }], "sfx": "…" } ]

Folha de bloqueio (escreva antes dos planos)

Para cada cena: posição de cada personagem (qual cadeira, esquerda/direita do quadro), direção do olhar, postura, adereços nas mãos e qualquer movimento com sua temporização ("em s03 Rex levanta e vai até a porta"). Se um personagem se move, o próximo plano começa onde ele terminou. O texto do bloqueio entra no prompt da grade do storyboard e no prompt do vídeo literalmente.

Cobertura que mantém a continuidade

Âncora com o plano dois. O diálogo entre dois personagens sentados ocorre principalmente em um plano médio dois; corte para reações e punchlines.
Planos individuais mostram a geografia: um plano fechado de um personagem mantém a mesa e o ombro ou a borda do outro no quadro (sobre o ombro), contra a mesma parede de fundo todas as vezes.
Regra dos 180°: os lados da tela nunca invertem. Escreva "Milo esquerda do quadro, Rex direita do quadro" em todo plano que tenha ambos.
Nomeie a câmera em cada plano ("câmera fixa", "aproximação lenta"). Câmeras sem nome fazem Wan cortar por conta própria.
Comédia física no plano aberto, para que toda a ação seja legível.
Corte na ação ou na palavra do punchline; mantenha a batida de reação (0,5–1 s) após a fala.
Sem saltos impossíveis: um personagem não pode estar na mesa em s02 e no meio da sala em s03, a menos que um plano o mostre se movendo.

Antes de entregar

Cada cena ≤ 15 s com 2–5 planos; o total corresponde à duração do roteiro.
Cada plano tem enquadramento, lente, câmera, imagem, movimento, diálogo (ou nenhum) e sfx.
node engine/gen.mjs estimate <slug>.

Lógica de continuidade (regras rígidas, aplicadas por `engine/continuity.mjs`)

Cada cena declara seats. Cada personagem ganha um lugar e um lado de tela: { "rex": { "place": "a ALMOFADA DIREITA do sofá", "side": "right" } }. Os prompts repetem isso como TRAVA DE ASSENTO em cada plano, inclusive abertos.
Ninguém muda de lugar fora da tela.
- Se a história precisar de um personagem em outro lugar, adicione um plano cujo moves diga para onde e como, e cuja ação mostre o movimento: "moves": { "rex": { "to": "o tapete", "side": "right", "how": "pula do sofá" } }.
- A verificação do plano falha se uma cena posterior começar um personagem em algum lugar novo sem esse plano.
Planos individuais são planos sujos. Quando personagens compartilham mobília, um close-up mantém a borda do parceiro (pelo, orelha, ombro) no seu lado da tela. O assento ao lado do sujeito nunca está vazio.
Após a filmagem, execute node engine/continuity.mjs <slug>.
- Um juiz de visão lê um quadro por plano e o compara com o planejado: móveis/chão, lado, teletransportes, dia/noite, assento vazio do parceiro, sala, guarda-roupa.
- Uma take reprovada não pode ser editada (edit.mjs a recusa). Refaça-a com uma nota nomeando a violação.