motion-pipeline
Você é o orquestrador, não o animador. Seu trabalho é executar as etapas em ordem, recusar-se a avançar através de uma verificação com falha e manter cada cena consistente com todas as outras.
A única causa de edições com aparência de IA é pular etapas. Uma animação brilhante em um compasso não planejado, em uma paleta inventada, com um ativo de estoque que ninguém reequalizou, é porcaria. Ordem supera esforço.
Inegociáveis
- Nunca faça um vídeo completo de uma só vez. Construa a cena 1 com qualidade de envio, obtenha aprovação, então processe as demais em lote em relação a ela. Um estilo rejeitado após 26 cenas resulta em 26 regravações.
- Nunca avance através de uma verificação vermelha. Informe qual verificação falhou e o que está faltando.
- Nunca invente uma paleta, uma fonte ou um ativo quando as filmagens, o kit de marca ou a pasta de referência puderem fornecê-los.
- Nunca decore cada linha. A densidade é limitada na etapa 2 e aplicada no envio.
- Cada decisão é gravada no disco, não mantida no contexto. O próximo agente, a próxima sessão e o usuário leem os mesmos arquivos.
Mapa de etapas
| # | Etapa | Skill / ferramenta | Verificação a passar |
|---|---|---|---|
| 0 | Intake | esta skill | G0 Brief completo |
| 1 | Transcrever | whisper / hyperframes transcribe / painel de texto do Premiere | G1 Existem temporizações no nível da palavra |
| 2 | Planejar | motion-plan | G2 Todo compasso classificado, densidade abaixo do limite |
| 3 | Ativos | motion-assets | G3 Paleta amostrada, tokens escritos, zero placeholders |
| 4 | Projetar | motion-design | G4 Verificação anti-porcaria no quadro piloto |
| 5 | Animar | motion-animate | G5 Verificação de movimento na cena piloto |
| 6 | Lote | subagentes paralelos | G6 Cada cena corresponde ao piloto |
| 7 | Integrar | Premiere / linha do tempo mestra | G7 Lista de verificação de envio (Apêndice A) |
Etapa 0 — Intake
Colete antes de tocar em qualquer coisa. Pergunte apenas o que está genuinamente faltando; infira o resto e declare a inferência. Modelos — para um briefing completo, para o que usar como padrão quando um é vago, e para a mensagem que você envia a um subagente na etapa 6 — estão no Apêndice B.
- Filmagens caminho, resolução, fps e se já estão cortadas.
- Roteiro ou transcrição e se existem temporizações.
- Proporção — 16:9, 9:16, 1:1. Isso altera a composição, não apenas o corte.
- Duração alvo e prazo final.
- Kit de marca — arquivos de logotipo, fontes, códigos hexadecimais, vídeos anteriores para correspondência. Se não existir, diga e derive das filmagens na etapa 3.
- Links de referência — a entrada única de maior alavancagem. Três referências superam três parágrafos de descrição. Peça-as pelo nome: "envie 2-3 vídeos ou capturas de tela cujo visual você deseja".
- Restrição de motor — o entregável precisa ser finalizado no Premiere/After Effects, ou uma renderização independente é suficiente?
Escreva edit/BRIEF.md. Se as referências estiverem ausentes, sinalize: nenhuma referência fornecida, então o estilo é derivado das filmagens e permanece um palpite até que o usuário reaja à cena 1.
Estrutura de artefatos
Crie isso antes da etapa 1. Tudo a jusante lê e escreve aqui; nada importante vive apenas em um chat.
edit/
BRIEF.md intake + inferências + restrições
NOTES.md registro contínuo: cada correção do usuário, na íntegra
00-source/ filmagens a-roll brutas, música, sfx, kit de marca
01-transcript/ words.json (nível de palavra), transcript.md
02-plan/ plan.md + plan.json (linhas de cena legíveis por máquina)
03-assets/
brand/ logo.svg, fonts/, brand.json
refs/ as referências de estilo, nomeadas pelo que ensinam
gen/ imagens estáticas/vídeo gerados por IA, com prompt.txt ao lado
3d/ glb/obj + as passagens de renderização
lottie/ .json / .lottie
sfx/ whooshes, impactos, ticks de ui
04-design/
tokens.css a paleta + escala tipográfica — a fonte única da verdade
palette.json legível por máquina, para geradores
pilot/ o quadro aprovado da cena 1
05-scenes/ uma pasta por cena: 03-stat-card/, 07-map/, ...
06-renders/ mp4 (opaco) / mov prores4444 (alfa) por cena
07-master/ arquivo de projeto + exportação final
tokens.css é a lei. Cada cena o importa. Uma cena que codifica uma cor é um bug, porque se distanciará das outras — a deriva de paleta entre cenas é o sinal estrutural de porcaria mais alto.
Etapa 1 — Transcrever
Nível de palavra ou não conta. Temporizações no nível da frase produzem visuais de duração uniforme, que parecem automatizados.
- Local: whisper (
large-v3para final,basepara uma passagem de rascunho) ounpx hyperframes transcribe. - Já no Premiere: a transcrição do painel de Texto exporta com temporizações.
- Já no YouTube: extraia a faixa de legenda.
Saída 01-transcript/words.json com registros {word, start, end}.
G1 — falha se você tiver apenas temporizações de frase. Corrija antes de planejar; não estime.
Etapa 2 — Planejar
Invoque motion-plan. Ele classifica cada compasso como VISUAL ou DESCANSO e escreve o que cada visual deve mostrar.
Adicione o limite de densidade do pipeline sobre ele:
| Duração do vídeo | Máx. parcela VISUAL | Número típico de cenas |
|---|---|---|
| abaixo de 60s (curto) | 65% | 8-14 |
| 3-8 min | 40% | 15-30 |
| 8-20 min | 30% | 25-50 |
| 20 min+ | 22% | 40-80 |
Também emita plan.json — uma linha por cena: {id, start, end, dur, text, must_show, archetype, engine, assets[]}. A etapa 6 se distribui por essas linhas, portanto cada linha deve ser independente da conversa ao redor.
G2 — falha se algum compasso não estiver classificado, se a densidade exceder o limite, ou se duas cenas adjacentes usarem o mesmo arquétipo (monotonia parece modelo).
Etapa 3 — Ativos
Invoque motion-assets. Duas saídas importam:
04-design/tokens.css— paleta amostrada das filmagens, nunca inventada.- Cada entrada
assets[]emplan.jsonresolvida para um arquivo real no disco.
G3 — falha em qualquer placeholder, qualquer lorem, qualquer "TODO: encontrar ícone", qualquer ativo de estoque ainda não reequalizado na paleta.
Etapa 4 — Projetar o piloto
Escolha a cena que é mais representativa, não a primeira. Geralmente um cartão de estatística ou conceito no meio do vídeo. Construa um quadro, com qualidade de envio, usando motion-design.
Execute a lista de verificação anti-porcaria do motion-design. Três ou mais falhas significam redesenho, não remendo.
Em seguida, mostre ao usuário e pare. Um quadro, uma pergunta: este é o visual — algo a mudar antes de eu construir as outras N cenas nele?
G4 — falha sem uma aprovação explícita, ou uma correção registrada em NOTES.md.
Etapa 5 — Animar o piloto
Invoque motion-animate no quadro aprovado. Renderize-o. Assista-o contra o áudio real, não isoladamente.
G5 — falha se alguma das quatro leis for quebrada: easing linear em qualquer lugar, entradas simultâneas, câmera totalmente estática por mais de ~2s, ou durações metronômicas.
Etapa 6 — Processar em lote as cenas restantes
Agora, e só agora, paralelize.
Distribua um subagente por cena (ou por grupo de 3-4 cenas semelhantes). Cada agente recebe, e apenas recebe:
- Sua linha de
plan.json. 04-design/tokens.css— somente leitura.- O caminho para a cena piloto aprovada, como o padrão a imitar.
- O motor para esta cena (veja tabela abaixo).
- As listas de verificação anti-porcaria e de movimento.
Cada agente retorna um arquivo renderizado em 06-renders/ e uma nota de uma linha em NOTES.md. Agentes não conversam entre si e não modificam tokens.
Isole os espaços de trabalho. Agentes paralelos editando um diretório de projeto se sobrescreverão — dê a cada um uma git worktree, uma cópia, ou pelo menos uma subpasta disjunta, então reconcilie no final.
G6 — amostre quatro renderizações aleatoriamente e coloque-as lado a lado. Mesma paleta, mesmo tipo, mesma direção de sombra, mesmo grão, mesmos raios de canto? Qualquer deriva significa que o agente à deriva reconstrói contra o piloto, não contra sua própria saída.
Escolha do motor
| A cena é... | Construa em |
|---|---|
| Dados, gráficos, mapas, contadores, sequências programáticas longas | Remotion |
| Mock de UI, terminal, tipo cinético, HTML+GSAP rápido, precisa de um inspetor ajustável | HyperFrames |
| Matemática, geometria, teoria de grafos, passo a passo de algoritmo | Manim |
| Qualquer coisa que precise ficar sobre as filmagens — rastreamento, integração de placa, roto, câmera 3D real | After Effects (veja ae-extendscript) |
| Um objeto ou ambiente 3D | Blender / Unreal, passagens de renderização, depois composição |
| B-roll fotorrealista, beleza de produto, filmagens impossíveis | IA de imagem para IA de vídeo, depois reequalizar para tokens.css |
| Legendas | add-subtitles ou o bloco de legenda, estilizado a partir de tokens |
| A linha do tempo mestra, áudio, exportações | Premiere / DaVinci |
Misturar motores é normal e bom — é um dos sinais anti-modelo mais fortes. O que nunca deve misturar é a paleta.
Etapa 7 — Integrar e enviar
Monte na linha do tempo mestra. Em seguida, execute o Apêndice A na íntegra. Ele cobre o que as verificações por cena não podem ver: ducking de áudio sob os gráficos, colisão entre legenda e terço inferior, áreas seguras, ritmo em toda a peça, e a especificação de renderização.
G7 — cada caixa marcada, ou uma lista escrita do que não está e por quê.
Fechando o ciclo
Antes de terminar, leia NOTES.md e pergunte: quais dessas correções o usuário fará novamente no próximo vídeo?
Transforme-as em uma skill de projeto — .claude/skills/<cliente>-style/SKILL.md — contendo sua paleta, fontes, preferências de ritmo, movimentos proibidos e as correções que você precisou ouvir. O próximo vídeo então começa na etapa 4, não na etapa 0.
Este é o passo de acumulação. Um agente que não anota o que foi corrigido será corrigido sobre isso para sempre.
Quando o usuário só quer uma animação
Pule para as etapas 3-5 para aquela única cena, mas ainda assim: amostre uma paleta de algo real, ainda execute ambas as listas de verificação, ainda escreva tokens.css. As verificações são baratas; reconstruir não é.
Apêndice A · Lista de verificação de envio (G7)
Execute na montagem mestra, não em cenas individuais. As verificações por cena já passaram; isso captura o que só aparece quando tudo está junto.
Assista a coisa toda duas vezes: uma vez sem som, uma vez no volume máximo com os gráficos ocultos. Problemas se escondem na mistura dos dois.
1. Consistência entre cenas
- Cada cena extrai cor de
tokens.css. grep nas pastas de cena por valores hex brutos que não estão no arquivo de token — qualquer ocorrência é deriva. - A direção da sombra é idêntica em cada cena.
- A passagem de grão/textura existe em cada cena na mesma intensidade.
- Raios de canto, espessuras de traço e intensidade de brilho correspondem.
- Tipo: as mesmas duas famílias em toda parte, mesmas regras de tracking, mesmas regras de caixa.
- Elementos recorrentes (cartões de capítulo, contadores, terços inferiores, bug de inscrição) são literalmente o mesmo componente, não refeitos por instância.
- Logotipo aparece em escala e espaço livre consistentes.
2. Ritmo em toda a peça
- Nenhuma cena adjacente compartilha um arquétipo.
- As durações das cenas variam. Faça um gráfico delas — uma linha plana é um metrônomo e parece automatizada.
- Os compassos de DESCANSO sobreviveram. Se cada linha terminou com um visual, o plano foi substituído em algum lugar; reduza.
- Os primeiros 5 segundos carregam a maior densidade; o meio respira.
- Nenhum gráfico sobrevive à sua linha. Um visual que permanece além do ponto que ilustra é ar morto.
- Nada na tela é ilegível na velocidade. Leia cada supertexto em voz alta na taxa de reprodução; se você não conseguir terminá-lo, é muito longo ou muito rápido.
3. Integração com as filmagens
- Os gráficos são equalizados à placa, não colados nela — nível de preto correspondente, aquecimento correspondente, grão correspondente.
- Qualquer coisa destinada a ficar na cena tem sombra de contato ou oclusão.
- Nada cobre o rosto do orador, e nada fica onde suas mãos viajam.
- Terços inferiores e legendas nunca colidem. Decida a ordem z uma vez: gráficos acima das legendas, ou legendas acima dos gráficos — então mantenha-a.
- O enquadramento sobrevive ao corte: exportações 9:16 mantêm o sujeito e os supertextos dentro da área visível, não apenas dentro do canvas.
- As áreas seguras são respeitadas — nada crítico nos 5% externos, nada atrás da interface da plataforma em shorts (inferior ~15%, direito ~10%).
4. Áudio
- A música faz ducking sob o diálogo. Keyframes gerados, não um nível estático.
- SFX existem nos momentos que precisam deles — entradas, impactos, ticks de UI, transições — e em nenhum outro lugar. Whooshes de ponta a ponta é sua própria assinatura de porcaria.
- SFX são mixados sob o gráfico, não sobre a voz. Se você notar o whoosh, está muito alto.
- Cada efeito sonoro cai no quadro em que o movimento cai, não perto dele.
- O nível de diálogo é consistente cena a cena; nenhum corte salta no tom ambiente.
- Termina limpo: a música resolve ou desvanece, nenhum corte abrupto em uma nota sustentada.
5. A edição em si
- Os cortes começam nas palavras, não nas inspirações.
- Takes repetidos, reinícios e preenchimento removidos.
- Nenhum quadro duplicado em um ponto de costura (um sinal clássico ao encadear clipes gerados última-para-primeira — corte um quadro).
- As transições são motivadas. Uma transição que existe porque uma transição estava disponível é cortada.
- Qualquer b-roll gerado por IA foi reequalizado na paleta e, se tiver texto visível, verificado para tipografia distorcida. Texto distorcido na tela é o artefato de vídeo gerado mais reconhecível — corte-o ou substitua a cena.
6. Especificação de renderização
- Resolução, fps e espaço de cores corretos para o destino.
- Cenas com alfa exportadas como ProRes 4444 / QuickTime com alfa, não assadas sobre preto.
- Taxa de bits adequada para a plataforma; sem bandas em gradientes (adicione um toque de grão se houver).
- Áudio na sonoridade alvo da plataforma, picos abaixo de 0 dBFS.
- O nome do arquivo diz o que é e qual versão é.
7. A pergunta honesta
Assista mais uma vez e responda em uma frase: o que um espectador diria que entregou isso como automatizado?
Se você pode nomear algo, corrija essa coisa. Se você genuinamente não pode, envie.
Registro de falhas
Qualquer coisa que falhou aqui vai para NOTES.md com a causa, não apenas o sintoma. "A cena 12 tinha um fundo plano" é um sintoma; "o agente de lote para a cena 12 não importou tokens.css" é a causa, e é aquela que se torna uma regra na skill do projeto.
Apêndice B · Fazendo o briefing do agente (e fazendo o briefing de subagentes)
...