Doutrina de Movimento (Gateway)
Leia isto ANTES de compor qualquer animação. Decide O QUE acontece em cada junta e como cada cena se comporta; as skills de técnica a implementam. Estas regras substituem as orientações de movimento genéricas/a montante. A falha que isso evita: cenas autoradas isoladamente — o momentum do olho morre a cada corte, e as cenas oscilam no lugar entre a entrada e a saída.
Mapa de rotas
| Decisão (esta skill) | Skill de implementação |
|---|---|
| Escolha de transição de junta + parâmetros + código | cut-the-curve §1–5 (o catálogo) |
| Cascatas de entrada de texto/elemento | cut-the-curve §6 (entrada cascata) |
| Reposicionamento de grupo em cena (sem corte) | cut-the-curve §7 (curva de ajuste) |
| Ação liderada por cursor / início de cena / ignição de morph | oversized-cursor |
| Mecânicas de renderização de junta / proteção contra flash branco | seam-craft |
| Trabalho de lançamento de produto / explicador / legenda | sobrepõe text-beat-economics, brand-faithful, captions-overlay no topo da skill a montante |
Ordem de autoria: ledger de vetores (ledger.json) → CARIMBE as juntas mestre a partir dele (scripts/seam-stamp.mjs --ledger ledger.json --write index.html) → rota de movimento sustentado por fase → carriers e causas → comps de construção → VERIFIQUE (scripts/seam-gate.mjs).
Autore manualmente apenas morphs de Tier A / match-cuts; juntas carimbadas passam pelo portal por construção.
Parte 1 — A Lei da Junta
A Lei Vetorial
Como a Cena A sai determina como a Cena B entra: mesmo eixo, mesma direção, velocidade combinada, corte no meio do movimento em ambos os lados.
- Eixo — x permanece x, y permanece y, Z permanece Z. Nunca troque eixos através de um corte.
- Direção — nunca espelhe. Em Z, direção = o SINAL da mudança de escala: crescer = empurrar (câmera para frente), encolher = puxar (câmera para trás). Uma saída que recua respondida por uma entrada que cresce do pequeno é um vetor espelhado — a violação mais comum, porque crescer-do-pequeno é a entrada padrão de elemento.
- Velocidade — velocidade inicial da entrada ≈ velocidade final da saída, através de eases espelhadas (saída
power4.in+ entradapower4.out, mesma distância e duração; o lado que entra pega ≥50% do caminho nocional). Mecânicas emcut-the-curve. - Fase — o corte cai no meio do movimento em AMBOS os lados. Se acomodar antes do corte, ou começar do repouso depois dele, é um tempo morto.
A Corrente
Cada filme escolhe UMA direção dominante (padrão da casa: ESQUERDA). Cada junta comum a usa. Outros vetores são RESERVADOS — gastar um significa algo:
| Vetor | Significado |
|---|---|
| A corrente (ESQUERDA) | "próxima batida" — progresso neutro para frente |
| Para cima | elevação — uma conclusão ou revelação se eleva acima do que veio |
| Z para frente (zoom-travessia) | aprofundando no mesmo pensamento |
| Z para trás (zoom inverso) | CHEGADA — algo maior pousa |
| Explosão de escala (explodir) | saindo de um mundo — uma superfície explode em direção à câmera |
- Nunca execute juntas consecutivas em direções opostas — pingue-pongue soa como erro.
- Uma mudança de direção precisa de uma causa visível (clique / ricochete / impacto) ou um limite de capítulo.
O Ledger de Vetores
Escreva-o antes de autorar qualquer linha do tempo mestre — como ledger.json na raiz do projeto (esquema: references/seam-gate.md). Uma linha por junta: tempo de corte, vetores de saída e entrada (eixo + direção sinalizada; linhas Z carregam o sinal de escala), seletores, técnica. Saída e entrada devem corresponder; se uma linha não corresponder, corrija o plano, não o easing. O verificador checa a consistência das linhas estaticamente antes de qualquer amostragem em tempo de execução.
Carriers
O olho segue objetos, não abstrações. As juntas mais fortes entregam um carrier concreto através do corte em posição E velocidade combinadas: um cursor no meio do caminho, um contêiner que encolhe/encaixa no próximo layout, uma marca que voa para seu lugar exato, o grupo de palavras de um corte cascata. Sem carrier natural, os heróis da cena o carregam (viagem parcial + fade precoce, entrada em pleno voo). Nunca um crossfade — ele não tem carrier algum.
Movimento Causal
Encadeie o movimento para que cada movimento seja visivelmente lançado pelo anterior: clique → compressão → liberação mola → voo → impacto → recuo → revelação.
- Efeitos começam NO quadro causador — mesma posição na linha do tempo, nunca "logo depois."
- Reações escalam com a massa implícita: elementos grandes recuam mais devagar, pequenos estalam.
- Uma força é uma licença para mudar de direção; uma inversão sem causa é um pingue-pongue.
O Portal da Junta (portal de construção — execute o verificador, saia 0 ou a junta não está pronta)
node <SKILL_DIR>/scripts/seam-stamp.mjs --ledger ledger.json --write index.html # gerar
node <SKILL_DIR>/scripts/seam-gate.mjs verify --ledger ledger.json --project . # verificar
O script (uso + esquema do ledger: references/seam-gate.md) impõe numericamente, por junta: consistência da linha do ledger, saída ainda se movendo no corte, entrada em pleno voo (nunca do repouso), direção medida = direção do ledger, correspondência de velocidade de entrada/saída (AVISO), sobreposição zero (um lado visível por quadro — o corte não é um dissolve), a regra do sinal Z (d(escala)/dt mesmo sinal em ambos os lados; as entradas da cena que chega são escaneadas por conflito de sinal), e continuidade do retângulo carrier com escala ancestral incluída. Use seam-gate.mjs probe --t <corte> para encontrar os verdadeiros seletores carrier de cada junta ao autorar o ledger.
Regras que o script não pode verificar — ainda suas:
- Edições reabrem a junta. Qualquer mudança no primeiro/último ~1s de uma cena (incluindo re-timing para novo VO) invalida a auditoria daquele limite — execute o verificador novamente.
- Áudio é o relógio. Re-timing de cenas para os timestamps reais das palavras do VO; nunca apresse uma leitura para caber em um slot. Um VO regerado reabre suas juntas.
- Pegadinha do clip-gate (a causa usual de uma FALHA de sobreposição zero): um clip cujo
data-startprecede seu tween de entrada é desocultado em sua opacidade inicial — definaautoAlpha: 0inicial Edata-start= o tempo de corte, nunca antes.
Parte 2 — Performance (a cena continua performando)
Sem oscilação ociosa
Loops senoidais ociosos (respirar, flutuar, derivar, pulsar brilho) são PROIBIDOS como movimento sustentado — eles soam como "o vídeo está esperando." Uma cena que termina de entrar com segundos sobrando é um bug de planejamento: adicione história, não oscilação. Cada fase entre entrada e saída é propriedade de uma destas rotas (nomeie a rota no plano):
| Rota | O que é |
|---|---|
| Revelações em etapas | Segure conteúdo de volta; libere-o nas batidas da narração — o quadro continua ganhando informação (padrão para ≥2 grupos de conteúdo) |
| Câmera com intenção | Um caminho mapeado de escala+pan: estabelecer amplo → viajar → chegar no sujeito |
| Vida de UI sequenciada | O produto se comporta ao longo do tempo: progresso avança, destaque de etapa, contadores marcam |
| Sequências animadas | Elementos encenam uma batida: um cartão é arquivado em uma pilha, um item é arrastado, um resultado se monta |
| Ação liderada por cursor | Um cursor grande guia o olho para um gatilho; seu CLIQUE acende a próxima batida (oversized-cursor) |
Teste: pause em qualquer segundo — algo significativo deve estar em pleno voo (uma revelação pousando, a câmera viajando, a UI fazendo o que a narração diz).
Pausa antes do clímax
Agende uma pausa de 0,3–0,75s entre a ação principal e seu resultado — a vírgula dramática. Uma cena que salta diretamente da ação para o resultado a perde.
Intenções de timing
- Entrada única ≤ ~800ms; buildup mais longo = escalonamento de múltiplos elementos, não um elemento lento.
- Saída ≈ 75% da entrada. Exceção: cut-the-curve inverte isso (entrada ~127% da saída).
- Escalonamento total ≤ 500ms; com 8+ elementos, aperte o atraso por item ou escalone os primeiros.
- Eases proibidos:
bounce.out/elastic.out. Overshoot de entradaback.out(1.4–1.7)é aceitável. - Elementos semelhantes compartilham uma intenção de ease + duração — nunca um par único por elemento.
Vocabulário de transição
Use apenas 2–3 transições entre cenas por filme e repita-as; o limite padrão é cut-the-curve na direção da corrente. Morphs de elemento compartilhado escritos à mão (intent: morph) não contam para o orçamento.
Anti-Padrões
| Não faça | Em vez disso |
|---|---|
| Autore a entrada de cada cena isoladamente | Escreva o ledger de vetores primeiro |
| Crossfade entre cenas | Cut-the-curve na direção da corrente |
| Saída completa, DEPOIS a cena muda | Corte no meio do movimento em ambos os lados |
| Entrada começa do repouso após um corte | Entre ≥50% através do caminho nocional |
| Saída com zoom inverso → entrada crescendo-do-pequeno (ou push → retração exagerada) | Corresponda o sinal da velocidade de escala (Portal da Junta 7) |
| Introdução pop-in da própria cena que chega sob uma passagem Z | Segure seu quadro de abertura composto, ou corresponda o sinal |
| Oscilação ociosa / respirar / flutuar para preencher tempo | Atribua uma rota de movimento sustentado; ou adicione história |
| Inversão de direção sem causa | Gaste uma força, ou mantenha a corrente |
| Vetores reservados usados como variedade | Padrão para a corrente; gaste-os com significado |
| Reação alguns quadros após sua causa | Ignição no mesmo quadro |
| Ação salta diretamente para o resultado | Agende pausa antes do clímax (0,3–0,75s) |