Construção de uma Inserção Animada
Você monta uma animação completa de 4 a 10 segundos, que é editada no vídeo como uma inserção ou aplicada como sobreposição sobre o quadro. Ela deve mostrar visualmente o pensamento que o autor está expressando em voz — não ilustrar de forma genérica, mas mostrar especificamente essa ideia.
Estilo Padrão — v4 "Apresentação com Imagens"
Se o usuário não pedir outro — monte no estilo v4. O autor o chamou de "absolutamente ideal" e pediu que os próximos vídeos fossem exatamente iguais. Tudo sobre ele — references/style-v4.md: referências (descrições no references/style-v4.md), layouts kinetic / full / split-cam / split-screen / lower com geometria precisa, constantes, áudio, aceitação.
- Estilos e helpers gerais:
assets/style-v4/common.css,common.js(heroIn,rise,chipIn,countUp). - Cenas de referência (fragmentos +
.sfx.json):references/recipes/v4/— comece pela mais próxima em layout. - Montagem: escreve o fragmento
W/scenes/NN.html→python3 scripts/mk_scene.py W NN→check→ render. Imagens:scripts/gen_images.sh+scripts/alpha.py; clipes webcam/tela:scripts/cut_clips.py. - Sons de carimbo e "resultado ruim" —
assets/style-v4/sfx/, o restante é do pacote media-use.
Camada antiga (abaixo): técnicas copiadas da edição de Austin Marchese e adaptadas ao sistema de design do canal — PiP-morph, zoom-through, carrossel de capítulos, etc. No v4, são usados como acentos dentro da cena, não como base. As técnicas são copiadas exatamente — timings, curvas, ordem das camadas; paleta e tipografia apenas do próprio sistema.
O que Ler e em Qual Ordem
references/style-v4.md— como deve parecer.references/gotchas.md— antes de escrever código. Lá estão as proibições do motor, armadilhas do tema claro e regras de emendas. Cada item já custou uma iteração.references/style-rules.md— leis de estilo: como o texto aparece e desaparece, o que define o ritmo, o que está sempre em movimento. Siga-as independentemente da técnica que estiver montando — são elas que tornam a edição reconhecível.references/design-system.md— paleta, escala, componentes, regras da marca. Não pode violar.- Mecânica da sua técnica — leia apenas sua seção:
references/techniques.md— técnicas com implementação verificada;references/techniques-observed.md— técnicas extraídas de análise, mas ainda não montadas; construa conforme a descrição.
references/recipes/<technique>.html— implementação funcional detechniques.md. Não é um modelo para copiar inteiro, mas um exemplo de como resolver partes complexas. Consulte quando a mecânica não for óbvia.
A especificação para a cena específica vem do /motion-plan ou diretamente do usuário.
Ordem de Trabalho
1. Prepare o Projeto
Se o projeto ainda não existe:
./node_modules/.bin/hyperframes init <nome> --example blank --non-interactive --resolution landscape --skill motion-graphics
Um npx hyperframes simples na raiz do repositório falha com "Missing script" — o CLI não é global.
Dentro de um projeto já criado, funcionam npm run check e npm run render; de fora, use o caminho para o binário acima.
Copie a pasta assets/ deste skill para o projeto inteira, não arquivo por arquivo: tokens.css importa fontes via @import "./fonts/fonts.css", e a estrutura de diretórios deve coincidir.
cp -R <caminho-para-o-skill>/assets/. <projeto>/assets/
As fontes Onest e Unbounded estão localmente (cirílico e latim), então o texto renderiza igual em qualquer máquina. O GSAP, o modelo inicial e todas as receitas carregam do CDN — a rede ainda é necessária na renderização. Se não houver rede, coloque gsap.min.js ao lado e corrija <script src>.
Conexão de tokens na composição — uma linha:
<link rel="stylesheet" href="./assets/tokens.css" />
2. Monte a Composição
Contrato do HyperFrames: timeline única paused em window.__timelines["main"], cada elemento timed com class="clip", data-start e data-duration. Detalhes — em /hyperframes-core, carregue-o se tiver dúvidas sobre a estrutura.
Três coisas que determinam se a técnica vai funcionar:
Copie timings e curvas literalmente. A diferença entre power2.inOut e power2.out no crescimento de um PiP é a diferença entre um movimento de câmera e um zoom de imagem. Entre power3.inOut e power4.inOut em uma emenda push — entre um deslizamento e um puxão.
Mantenha a técnica, não a letra da especificação. Se a descrição quadro a quadro da especificação diverge do easing declarado (as porcentagens de crescimento não correspondem à curva), a prioridade é o easing: ele define como o movimento é percebido. Se a especificação dá uma amplitude em que o objeto não sai do quadro no momento do corte do clipe — recalcule a amplitude para a geometria real de 1920×1080 e avise.
Uma técnica que não é percebida deve ser reforçada. Uma implementação formalmente correta que não é visível não é trabalho feito. A transição de preenchimento em um fundo claro é quase invisível até que você adicione um marcador de frente. Uma emenda em que ambos os lados estão vazios no meio não tem o que mostrar.
Se a técnica não estiver nem em techniques.md nem em techniques-observed.md — construa a partir da descrição quadro a quadro da especificação, mas primeiro encontre nela o ponto de inflexão: a decisão da qual depende o sucesso do quadro. Geralmente não é uma curva, mas a geometria — quanto deslocar, onde está o centro do grupo, o que sai da borda. A especificação é escrita por quem não viu os quadros; ele provavelmente não notou o ponto de inflexão. Tome a decisão você mesmo, verifique com os quadros e obrigatoriamente nomeie-a no relatório — ela irá para o skill do próximo.
3. Verifique
npm run check
Zero erros e zero warnings. A auditoria de contraste e layout reclamará das próprias técnicas — fundo desfocado, sobreposição de cenas na emenda, vizinhos atenuados. Diferencie a técnica de um problema real: arrume os achados reais, marque as técnicas com opt-outs padrão. Cada opt-out desativa apenas sua verificação específica — tabela em gotchas.md, não pode colocar aleatoriamente: data-layout-ignore também remove o contraste, e o texto abaixo dele silenciosamente sai do relatório.
Coloque também um sidecar *.motion.json ao lado — o check o pegará automaticamente e verificará a intenção de movimento na mesma timeline rebobinada usada pelo render. É o análogo automático mais próximo de "renderize e veja": captura uma entrada que o rebobinado perdeu, uma ordem quebrada de stagger e um plano congelado. Formato — em gotchas.md.
4. Veja com os Olhos — Este Passo é Obrigatório
../node_modules/.bin/hyperframes snapshot . --frames 8 -o snapshots
Abra snapshots/contact-sheet.jpg via Read — é uma imagem, você a vê. O check não dirá que o quadro está vazio, o texto pequeno ou os blocos estão mal posicionados.
Olhe o quadro 0 separadamente — é a falha mais comum. Pelas regras de estilo, a cena começa já em movimento, não de forma estática ou vazia; se no quadro zero estiver vazio ou tudo já montado, a técnica está quebrada no lugar mais visível.
Faça também snapshots pontuais nos pontos mais complexos:
../node_modules/.bin/hyperframes snapshot . --at 1.45,1.55,1.675,1.8 --no-end -o snapshots-detail
Quais pontos escolher: se a técnica tiver uma emenda — o meio da emenda e um quadro de cada lado. Se não houver emenda, capture os momentos de recálculo da composição: compressão de lista, rearranjo de bloco, mudança de elemento ativo. É aí que o layout quebra, e em oito quadros uniformes isso não é visível.
Locais polêmicos (gradientes, tamanho pequeno de fonte) veja em PNG em tamanho real: o JPEG contact-sheet mente tanto em tamanho quanto em banding.
Itere até a imagem ficar boa. A primeira versão quase sempre sai pequena — este é o erro mais comum, o quadro 1920×1080 é maior do que parece.
5. Renderize
npm run render
Onde Colocar o MP4
Em renders/ do seu projeto e em nenhum outro lugar. Nomeie o caminho no relatório — quem vai distribuir as inserções prontas pelas pastas comuns é quem monta o vídeo inteiro: ele sabe como elas se chamam na timeline e quais foram aceitas.
Isso não é formalidade. Em um vídeo, nove montadores distribuíram resultados em três lugares diferentes, dois deletaram renders/ completamente, um duplicou o arquivo em duas pastas "para o orquestrador encontrar de qualquer jeito" — e o orquestrador teve que procurar renders com find por todo o disco. A regra sobre "vídeos finais em output/" do CLAUDE.md se refere a vídeos prontos, não a inserções para montagem: a inserção é um semi-acabado.
Também não delete a pasta de trabalho do projeto. O orquestrador a removerá quando a cena for aceita; até lá, ela pode ser necessária para correções.
Sobreposição Sobre o Quadro: Insira um Fundo na Composição
Uma sobreposição — painel de vidro, título, glossário — é calculada para um quadro específico abaixo dela, e tem uma consequência técnica não óbvia: backdrop-filter não vê o que não está na composição. Se você renderizar a sobreposição com fundo transparente e sobrepô-la no programa de edição, o vidro desfocará o vazio, ou seja, não desfocará nada, e o painel ficará como um filme plano.
Portanto, a composição da sobreposição é construída de forma diferente da inserção:
# pedaço do original exatamente no timecode da cena — em assets do projeto
ffmpeg -ss 20.0 -i <original> -t 4.0 -vf "scale=1920:1080,fps=30" -an \
-c:v libx264 -crf 16 -preset veryfast -pix_fmt yuv420p -y assets/plate.mp4
<video id="plate" class="clip" data-start="0" data-duration="4" data-track-index="0"
src="./assets/plate.mp4" muted data-layout-ignore></video>
O fundo vai na trilha zero e é marcado com data-layout-ignore — ele não é auditado.
O vidro sobre ele funciona de verdade. Na saída, um MP4 normal que, na edição, é colocado no lugar do seu trecho, não sobre ele; o áudio do fundo foi removido, a trilha sonora vem do original.
Alternativa — --format mov com transparência — é necessária apenas quando o editor pede alfa explicitamente e está disposto a colocar a camada ele mesmo.
O Que Relatar
Resumidamente, 10–15 linhas: o que foi feito, caminho para o MP4, quais partes foram complexas e como foram resolvidas, o que ficou imperfeito. Não re conte o código — ele está no arquivo.
Nomeie separadamente as divergências da especificação. Se você recalculou a amplitude, mudou a curva ou adicionou um elemento que não estava na especificação, diga e explique por quê. A especificação é escrita por quem não viu os quadros; você viu. Uma divergência que é relatada é uma descoberta; uma que é omitida é uma surpresa na edição.
O Que É Considerado Pronto
checklimpo, MP4 renderizado;- técnica é perceptível nos quadros a olho, não apenas "formalmente implementada";
- paleta, escala e regras do sistema de design seguidas;
- determinismo: dois snapshots do mesmo timecode dão o mesmo SHA-256, se a cena tiver pseudoaleatoriedade.