Shrimer06/remotion-video-superpowers

Superpoderes de Vídeo Remotion

Use esta habilidade para executar a produção de vídeos Remotion como um fluxo de trabalho disciplinado de especificação -> planejamento -> execução -> verificação. Não pule diretamente para a animação em vídeos não triviais.

Fluxo de Trabalho

1. Crie ou atualize uma especificação de vídeo antes da implementação.

   • Leia references/writing-video-specs.md.
   • Salve as especificações em docs/video/specs/YYYY-MM-DD-project-name.md no projeto quando for prático.
   • Capture objetivos, não objetivos, público-alvo, direção visual, ativos, requisitos de narração, restrições e critérios de aceitação.

2. Crie ou atualize um plano de produção.

   • Leia references/writing-video-plans.md.
   • Salve os planos em docs/video/plans/YYYY-MM-DD-project-name.md no projeto quando for prático.
   • Use tarefas com checkboxes. Cada tarefa deve listar arquivos, etapas, validação e condições de parada.

3. Complete a obtenção de ativos antes da implementação da animação.

   • Leia references/asset-sourcing.md.
   • Colete e registre ativos do produto, ativos da marca, referências de UI, capturas de tela, modelos 3D, recursos de mapa/geoespaciais, tokens de serviço/nomes de ambiente, referências de áudio, licenças, atribuições, caminhos locais e fallbacks.
   • Não inicie a animação de cenas até que os ativos necessários estejam disponíveis localmente ou um fallback seja explicitamente registrado.

4. Execute o plano tarefa por tarefa.

   • Leia references/remotion-scene-execution.md antes de editar código Remotion.
   • Leia references/frontend-animation-system.md quando o vídeo contiver UI web, interface de produto, dashboard, animação no estilo frontend, Three.js, Anime.js ou coreografia de animação complexa.
   • Leia references/3d-map-and-model-resources.md quando o vídeo precisar de mapas, rotas, cidades, terreno, edifícios, pontos de referência, gêmeos digitais, equipamentos, naves espaciais, objetos 3D do mundo real ou serviços baseados em token como Mapbox/Cesium ion.
   • Use useCurrentFrame() e interpolate() para animação segura em busca (seek).
   • Evite transições CSS e animação não determinística em tempo de execução.
   • Mantenha o texto da cena curto; mova explicações para a narração.
   • Renderize stills em torno de inícios, picos e transições de cena antes da renderização final.

5. Trate a narração como uma fonte de primeira classe na linha do tempo.

   • Leia references/elevenlabs-v3-scripting.md antes de escrever scripts ElevenLabs v3.
   • Leia references/audio-sync-and-muxing.md antes de importar, sincronizar ou multiplexar áudio.
   • Inspecione a duração real do áudio com o script scripts/inspect-audio.sh desta habilidade.
   • Prefira esticar o tempo da cena para caber na narração final em vez de cortar o áudio.

6. Execute a verificação de qualidade final antes da entrega.

   • Leia references/qa-checkpoints.md.
   • Execute lint/typecheck do projeto quando disponível.
   • Renderize stills de verificação com o script scripts/render-checkpoints.sh desta habilidade ou comandos explícitos npx remotion still.
   • Renderize o MP4 final.
   • Multiplexe a narração com o script scripts/mux-voiceover.sh desta habilidade quando a confiabilidade do áudio for importante.
   • Verifique duração, stream de áudio e volume com ffprobe/ffmpeg.

Regras dos Superpoderes

• Trate a especificação como a fonte da verdade. Se a implementação conflitar com a especificação, atualize a especificação ou pare e pergunte.
• Trate o plano como executável. Não marque uma tarefa como concluída até que sua verificação passe.
• Pare em caso de validação falha que afete a qualidade final do vídeo: lint quebrado, texto ilegível, cenas sobrepostas, áudio ausente, duração incompatível ou visuais chave em branco.
• Para revisões, identifique primeiro a cena e o intervalo de quadros afetados, renderize stills antes/depois e então corrija apenas o código necessário.
• Preserve a mídia fornecida pelo usuário. Copie ou referencie deliberadamente; não sobrescreva downloads de origem.
• Não use capturas de tela como linguagem visual principal para um vídeo promocional, a menos que o usuário explicitamente queira um tour de tela. Traduza ideias de produto em metáforas de movimento e use capturas de tela como evidência, transições ou prova rápida do produto.

Roteamento de Referência

• Precisar projetar o vídeo: leia writing-video-specs.md.
• Precisar planejar a implementação: leia writing-video-plans.md.
• Precisar reunir ativos do produto, modelos, capturas de tela, tokens, licenças ou referências: leia asset-sourcing.md.
• Precisar codificar cenas ou transições Remotion: leia remotion-scene-execution.md.
• Precisar projetar animação rica no estilo frontend: leia frontend-animation-system.md.
• Precisar de mapas, cidade/terreno 3D, rotas ou modelos 3D externos: leia 3d-map-and-model-resources.md.
• Precisar de um script de narração, especialmente ElevenLabs v3: leia elevenlabs-v3-scripting.md.
• Precisar alinhar áudio MP3/WAV ou corrigir "sem som": leia audio-sync-and-muxing.md.
• Precisar inspecionar a qualidade final: leia qa-checkpoints.md.

Ao executar scripts empacotados de um diretório de projeto, use o caminho absoluto para o diretório scripts/ desta habilidade, a menos que existam scripts equivalentes locais do projeto.