Fluxo de curtas-metragens cinematográficos
Cria um pacote de produção revisável a partir de uma ideia ou roteiro. Esta skill planeja e valida; não autoriza gerar imagens, áudio, modelos 3D, renders nem vídeo. Pergunte apenas quando uma decisão criativa ou técnica importante não puder ser inferida. Respeite a autorização explícita de produção e as instruções do projeto destino.
Fluxo e portões de aprovação
| Etapa | Entrada | Saída revisável | Aprovação para avançar |
|---|---|---|---|
| Encomenda | Ideia, roteiro ou pedido | Brief com público, formato, duração, idioma, tom, restrições e entregáveis; incógnitas sinalizadas | Requisitos essenciais completos; fatos e restrições compreendidos |
| História | Brief aprovado | Logline, objetivo, obstáculo, risco, beats, virada e desfecho | Causa/efeito legíveis; fatos separados da ficção; sem decisão narrativa bloqueante |
| Estética e recursos | História aprovada | Folha de estilo, critérios de personagens/ambientes e lista de recursos candidatos | Estilo coerente; cada recurso usado tem fonte/licença/formato/rig verificados ou fica marcado como pendente e fora do plano aprovado |
| Storyboard | História e direção aprovadas | JSON por plano; blocos opcionais cinematography e animation descrevem câmera/luz e atuação por beats | Validador passa; intenção de foco/corte e beats/continuidade revisada. Still 9:16 e sequência têm portões separados; rig não verificado não fica aprovado para produção |
| Plano técnico | Storyboard aprovado | Motor e versões, recursos/licenças, animação, voz/legendas, perfil e custo/limitações previstos | Rota local viável; dependências e medidas de recursos explícitas; sem incerteza crítica oculta |
| Controle de qualidade | Pacote anterior completo | Rúbrica com evidência, resultados automáticos, revisão visual e avaliação humana separadas | Todos os defeitos corrigidos ou aceitos expressamente; bloqueios listados; não afirmar checks sem executá-los |
Não pule um portão falhado. Um plano, pré-visualização, fotograma, narração ou render não autoriza a próxima etapa de produção.
Para cada storyboard execute python scripts/validate-storyboard.py caminho/para/o/storyboard.json. validate-skill.py também valida estrutura e cronologia de todos os examples/**/storyboard.json e templates/storyboard.json, reutilizando o validador de storyboard. Para revisar a skill completa, execute python scripts/validate-skill.py . e python -m unittest discover -s tests -v.
Os projetos podem versionar um pipeline.json com pipeline_version: 1, independente do storyboard. Valide com python scripts/pipeline.py validate caminho/para/o/pipeline.json; inspecione o DAG sem executar nem escrever com plan ou dry-run; valide um manifesto existente com validate-manifest pipeline.json run-manifest.json. Consulte references/pipeline-orchestration.md antes de editar esse contrato.
As legendas usam intervalos [start_ms, end_ms): sobreposições rejeitadas por padrão. Uma sobreposição intencional requer overlap_exception não vazio na legenda que começa depois; documente seu motivo.
Para vincular voz e planos, narrative_timing é opcional em schema_version: 1: etiquete o relógio como estimado ou gravado e anote beats, pausas e cortes com âncoras referidas a cenas. Com gravação real, use sua duração como relógio e revise as legendas novamente. As âncoras não demonstram sincronia; não declare alinhamento palavra por palavra sem evidência de alinhador ou revisão manual.
Salve pacotes novos em deliverables/<slug>/ com um brief/plano e storyboard.json. Use um slug estável e conserve os entregáveis existentes; não mova nem sobrescreva pacotes anteriores ao criar um novo.
Estado de capacidade
Implementado: guias de planejamento, contratos opcionais de cinematografia e animação, rúbrica qualitativa, planejador DAG local e validação de contratos de pipeline/manifesto. pipeline.py plan e dry-run mostram o grafo sem executar etapas nem criar arquivos. A validação de storyboard verifica estrutura e tempos declarados; não valida câmera, atuação, existência/compatibilidade de rigs nem qualidade visual. O validador de manifestos verifica estados, pegadas e saídas, mas não cria nem retoma execuções.
As etapas audiovisuais e seus adaptadores continuam pendentes. Não há geração de mídia, motor de render, adaptador de TTS, composição, QA audiovisual temporal nem scanner legal. Os resultados de benchmarking, disponibilidade de assets, licença, ferramentas e compatibilidade são verificados por tarefa.
Contexto local
Ao trabalhar na VideoIA, leia primeiro AGENTS.md e as instruções locais pertinentes. O ambiente de referência conhecido é Windows 11, GTX 1650 de 4 GB, 16 GB de RAM, Blender local, Remotion/React/Three.js/R3F, FFmpeg, Kokoro TTS e pacotes de recursos CC0 opcionais. É contexto, não garantia de que um binário, modelo, pacote, licença ou versão continue instalado. Priorize fluxos locais/gratuitos e pré-visualizações modestas; verifique as versões ativas antes de aplicar padrões do framework.
Reutilize as skills instaladas do Remotion em vez de copiar seus manuais. Consulte os guias de boas práticas, markup, 3D, legendas, Studio ou render apenas se a tarefa exigir. O render requer pedido explícito. Não instale dependências, baixe recursos, use serviços pagos, publique nem modifique projetos alheios sem autorização.
Use a rúbrica cinematográfica para separar validação automática, inspeção de fotogramas fixos e julgamento humano. Imagens estáticas não provam qualidade temporal de animação.
Recursos
- Narrativa: references/storytelling.md
- Identidade visual: references/art-direction.md
- Design de planos: references/cinematography.md
- Personagens, ambiente e animação: references/animation-3d.md
- Integração Remotion/R3F: references/remotion-integration.md
- TTS, áudio e legendas: references/voice-and-captions.md
- Portões de revisão: references/quality-control.md
- Rúbrica cinematográfica: references/cinematic-quality-rubric.md
- Arquitetura e uso do pipeline: references/pipeline-orchestration.md
- Segurança e validação reproduzível do pipeline: references/pipeline-security.md
- Auditoria de fontes: docs/sources.md
- Skills candidatas: docs/skill-candidates.md
- Descobertas locais: docs/lessons-learned.md
- Prompts iniciais: docs/prompt-library.md
- Pendências: docs/roadmap.md
- Descoberta local do Codex: docs/codex-discovery.md