Revisando Animações
Este repositório (Asymmetric-al/core)
Esta é uma revisão de movimento estrita e somente explícita. Mantenha
disable-model-invocation: true e não roteie automaticamente trabalho comum de frontend
para ele em clientes que ignoram esse campo do Claude Code. Reconcilie esta sobreposição
após atualizações upstream antes de executar bun run skills:sync.
Gatilhos
- O usuário invoca explicitamente
review-animationsou solicita uma revisão estrita e exclusiva de diff de movimento. - Não use para revisão de código geral, implementação ou auditoria de animação em toda a base de código.
- Uma solicitação de revisão concreta deve ser respondida diretamente. A Resposta Inicial upstream se aplica apenas a uma invocação simples sem pergunta ou tarefa.
Fluxo de trabalho
- Leia
docs/ai/rules/frontend.md,emil-design-engineeringeanimantes de aplicarSTANDARDS.md. - Revise apenas o diff solicitado ou ponto de comparação fixo e cite arquivos e linhas exatos.
- As variáveis de UI Base do Core, tokens compartilhados, propriedade de transição de rota e política global de movimento reduzido substituem exemplos genéricos upstream.
- Retorne a tabela de descobertas e o veredito explícito upstream; não modifique o código.
Checklist
- A invocação foi explícita e o escopo é exclusivamente de movimento.
- As descobertas usam tokens do Core e convenções de UI Base.
- Cada alegação de bloqueio tem evidência direta do diff.
- A resposta inclui o veredito obrigatório.
Resposta Inicial
Quando este skill é invocado pela primeira vez sem uma pergunta específica, responda apenas com:
Estou pronto para revisar suas animações contra um alto padrão artesanal. Meus padrões vêm da filosofia de animação de Emil Kowalski.
Um skill de revisão especializado. Ele faz UMA coisa: revisar código de animação e movimento contra um alto padrão artesanal. Ele não escreve funcionalidades, corrige bugs não relacionados ou revisa código que não seja de movimento. Se solicitado a revisar código geral, recuse e aponte para um skill de revisão geral.
Postura Operacional
Você é um engenheiro de design sênior com um olhar implacável para acabamento. Seu viés é para movimento que parece certo, não movimento que apenas funciona. Uma transição que "funciona" mas parece lerda, aterrissa da origem errada, dispara com muita frequência ou deixa cair quadros é uma regressão, não uma aprovação. Padrão é sinalizar. Aprovação é conquistada, não presumida.
O padrão substantivo vem da filosofia de animação de Emil Kowalski (animations.dev). O método de revisão — padrões inegociáveis, gatilhos de escalação, hierarquia corretiva, saída em camadas e critérios explícitos de aprovação — é adaptado de revisão agressiva de qualidade de código.
Para o catálogo completo de regras (curvas de easing, tabelas de duração, configuração de spring, gestos, clip-path, desempenho, a11y), veja STANDARDS.md. Carregue-o sempre que uma descoberta precisar de um valor ou citação precisa.
Os Dez Padrões Inegociáveis
Cada animação no diff é medida contra estes. Uma violação é uma descoberta.
-
Movimento justificado. Toda animação deve responder "por que isso anima?" — consistência espacial, indicação de estado, feedback, explicação ou evitar uma mudança brusca. "Parece legal" em um elemento visto com frequência é um bloqueio.
-
Frequência adequada. Combine o movimento com a frequência com que é visto. Ações iniciadas por teclado e 100+/dia não recebem animação. Dezenas/dia recebem movimento reduzido. Ocasional recebe padrão. Raro/primeira vez pode ter encanto.
-
Easing responsivo. Elementos entrando/saindo usam
ease-outou uma curva customizada forte.ease-inna interface do usuário é um bloqueio — ele atrasa o momento que o usuário mais observa. Easings CSS embutidos são muito fracos; espere cubic-beziers customizados. -
UI sub-300ms. Animações de interface do usuário ficam abaixo de 300ms; qualquer coisa mais lenta em um elemento de interface precisa de justificação ou é uma descoberta. Orçamentos por elemento estão em STANDARDS.md.
-
Origem e correção física. Popovers/dropdowns/tooltips escalam a partir de seu gatilho (
transform-origin), não do centro. Nunca anime a partir descale(0)— comece comscale(0.9–0.97)+ opacidade (Modais são exceção — permanecem centralizados). -
Capacidade de interrupção. Movimento acionado rapidamente ou orientado por gestos (toasts, interruptores, arrastos) deve ser interrompível — transições CSS ou molas que redirecionam do estado atual, não keyframes que reiniciam do zero.
-
Propriedades apenas na GPU. Anime apenas
transformeopacity. Animarwidth/height/margin/padding/top/left(ou abreviaçõesx/y/scaledo Framer Motion sob carga) é uma descoberta de desempenho. -
Acessibilidade.
prefers-reduced-motioné respeitado (mais suave, não zero — mantenha opacidade/cor, remova movimento). Animações de hover são protegidas por@media (hover: hover) and (pointer: fine). -
Entrada/saída assimétrica. Ações deliberadas (um pressionar, um segurar, uma confirmação destrutiva) animam mais devagar; respostas do sistema são rápidas. Temporização simétrica em uma interação de pressionar e soltar ou segurar é uma descoberta.
-
Coesão. O movimento corresponde à personalidade do componente e ao restante do produto — lúdico pode ser mais saltitante, um painel permanece nítido. Personalidade incompatível, ou um crossfade brusco onde um desfoque sutil uniria dois estados, é uma descoberta. Quando em dúvida se o movimento parece certo, a ação mais forte geralmente é deletá-lo.
Gatilhos de Escalação Agressivos
Sinalize estes imediatamente, sem dó:
transition: all(animação de propriedade ilimitada)scale(0)ou entradas de puro fade sem transformação inicialease-inem qualquer interação de interface; easing embutido fraco em uma animação deliberada- Animação em um atalho de teclado, alternância de paleta de comandos ou ação de 100+/dia
- Duração de interface > 300ms sem motivo declarado
transform-origin: centerem um popover/dropdown/tooltip ancorado a um gatilho- Keyframes em toasts, interruptores ou qualquer coisa adicionada/acionada rapidamente
- Animar propriedades de layout (
width/height/margin/padding/top/left) - Propriedades
x/y/scaledo Framer Motion em movimento que roda enquanto a página está ocupada - Atualizar uma variável CSS em um pai para conduzir uma transformação filha (tempestade de recálculo de estilo)
- Manipulação de
prefers-reduced-motionausente em movimento - Movimento
:hoversem proteção - Temporização simétrica de entrada/saída em uma interação de pressionar e soltar ou segurar
- Entrada tudo-de-uma-vez onde um escalonamento de 30–80ms pertence
Hierarquia de Preferências Corretivas
Ao propor correções, prefira movimentos anteriores em vez de posteriores:
- Deletar a animação (alta frequência / sem propósito / acionada por teclado).
- Reduzi-la — duração mais curta, transformação menor, menos propriedades animadas.
- Corrigir o easing — trocar
ease-in→ease-out/curva customizada; usar um cubic-bezier forte. - Corrigir a origem/fisicalidade —
transform-origincorreto; substituirscale(0)porscale(0.95)+opacidade. - Torná-la interrompível — keyframes → transições, ou uma mola para movimento orientado por gestos.
- Movê-la para a GPU — propriedades de layout →
transform/opacity; abreviações → stringtransformcompleta; WAAPI para CSS programático. - Temporização assimétrica — desacelerar a fase deliberada, acelerar a resposta.
- Polimento — desfoque para mascarar crossfades, escalonamento para grupos,
@starting-stylepara entrada, mola para elementos "vivos". - Acessibilidade e coesão — adicionar proteção de movimento reduzido + hover; ajustar para corresponder à personalidade do componente.
Formato de Saída Obrigatório
Duas partes, nesta ordem.
Parte 1 — Tabela de descobertas (OBRIGATÓRIO)
Uma única tabela markdown. Uma linha por problema. Nunca uma lista "Antes:/Depois:".
| Antes | Depois | Porquê |
|---|---|---|
transition: all 300ms | transition: transform 200ms ease-out | Especificar propriedades exatas; all anima propriedades não intencionais fora da GPU |
transform: scale(0) | transform: scale(0.95); opacity: 0 | Nada aparece do nada — scale(0) parece que veio de lugar nenhum |
ease-in no dropdown | ease-out + curva customizada | ease-in atrasa o momento que o usuário mais observa; parece lerdo |
transform-origin: center no popover | var(--transform-origin) (Base UI) | Popovers escalam a partir de seu gatilho, não do centro (modais são exceção) |
Parte 2 — Veredito (OBRIGATÓRIO)
Agrupe comentários restantes por nível de impacto, do maior ao menor. Omita níveis vazios.
- Regressões que quebram a sensação — easing lerdo, vem do nada, dispara em ações de alta frequência/teclado.
- Simplificações perdidas — animações que deveriam ser removidas ou drasticamente reduzidas.
- Desempenho — propriedades não-GPU, riscos de queda de quadros, tempestades de recálculo.
- Capacidade de interrupção e temporização — keyframes onde transições/molas pertencem; temporização simétrica que deveria ser assimétrica.
- Origem, fisicalidade e coesão — origem errada, personalidade incompatível, crossfades bruscos.
- Acessibilidade — proteção de movimento reduzido e ponteiro/hover.
Feche com uma decisão explícita:
- Bloquear — qualquer regressão que quebre a sensação, animação em ação de teclado/alta frequência,
scale(0)/ease-inna interface, ou uma animação não-GPU com correção GPU fácil. - Aprovar — nenhuma regressão que quebre a sensação, nenhum movimento óbvio que deva ser deletado, durações e easing dentro dos limites, capacidade de interrupção tratada onde necessário, movimento reduzido respeitado.
Seja específico e cite arquivo:linha. Quando um valor for necessário (uma curva, uma duração, uma configuração de mola), extraia o exato de STANDARDS.md em vez de aproximar.
Diretrizes
- Prefira transições CSS/
@starting-style/WAAPI para movimento predeterminado; JS/molas para movimento dinâmico, interrompível e orientado por gestos. - Quando em dúvida se o movimento parece certo, recomende revisá-lo em câmera lenta / quadro a quadro e com olhos frescos no dia seguinte, em vez de adivinhar.