O que motion-review: o portal do gosto faz?
Linters pegam código quebrado. Este skill pega gosto. Postura padrão: sinalize primeiro; a aprovação é conquistada. Uma peça que "parece boa" pontua 3, e 3 não é entregue.
Como executar
- Execute como um subagente limpo quando possível. Dê a ele: este arquivo, a pasta do projeto e o briefing. Não diga o quão difícil foi a construção.
- O revisor nunca edita a composição. Ele escreve
review.mdna pasta do projeto e retorna o veredito. - Olhe para os pixels, não apenas para o código. Cada pontuação deve apontar para um timestamp, quadro ou seletor.
- Um revisor por peça. Dois revisores executando ao mesmo tempo escrevem o mesmo
review.mde seus vereditos entram em conflito. Cada rodada termina com uma linhaverdict:; o chamador consultareview.mdpor ela. Re-revisões vão para o mesmo revisor; inicie um substituto apenas sereview.mdnão mostrar uma nova rodada após uma longa espera, anote o cancelamento emreview.md, e faça o substituto ler o histórico primeiro. Se as rodadas entrarem em conflito, a última escrita emreview.mdé autoritativa.
Procedimento
Execute cada etapa. Comandos assumem um projeto HyperFrames (npx hyperframes …); para outras pilhas use o equivalente (Remotion: npx remotion still para quadros, npx remotion render para a tira).
-
Estrutura.
npx hyperframes check .Qualquer erro é um Bloqueio. Leia também os avisos. Sua auditoria de contraste é o portal de contraste. Texto decorativo nunca destinado a ser lido (fantasmas borrados, clones de rastro fantasma, lascas se dissolvendo, preenchimento de embaralhamento) é excluído comdata-layout-ignoreem cada nó; nunca o use para ocultar cópia real. -
Mapa de movimento. Leia o código da linha do tempo (ou o mapa de animação, se seus skills HyperFrames incluirem
animation-map.mjs). Anote:- zonas mortas de 1 s ou mais sem nada se movendo;
- movimentos espaciais mais curtos que 0.2 s (rápido demais para ler) ou mais longos que 2 s (à deriva);
- escalonamentos irregulares ou mecânicos;
- elementos que saem do quadro ou colidem acidentalmente.
Movimento conduzido por um objeto proxy/setter (câmera personalizada, three.js, contadores) é invisível para mapas baseados em tweens; use tiras de quadros (etapa 5) para esses movimentos.
-
Folha de contato. Do storyboard ou lista de batidas, anote os tempos das cenas e costuras. Instantâneo:
- quadro 0, o momento herói e o quadro final;
- 25 / 50 / 75 % de cada cena;
- cada costura em −2 quadros, 0 e +2 quadros.
npx hyperframes snapshot --at <t1,t2,…>. Passe tempos de quadro exatos (t = frame / fps, por exemplo, quadro 316 a 30 fps →10.5333);--atnão captura instantâneos, então um tempo arredondado mostra uma pose intermediária que o render nunca contém.snapshotdeixa imagens PNG obsoletas de execuções anteriores, então mova o diretório antigosnapshots/para o lado antes de cada execução (por exemplo,node -e "require('fs').renameSync('snapshots','snapshots-'+Date.now())") em vez de deletar com um globrm;--attambém pode adicionar um quadro extra que você não pediu, então ignore os extras. Abra as imagens e olhe. Aplique zoom no tipo apenas em momentos em que o elemento está visível (aplicar zoom em um elemento oculto pode travar). -
Prova de profundidade. Para câmera ou movimentos de herói,
npx hyperframes keyframes --ghost --angle. Planos se separando ao longo de z significam profundidade real; tudo se escalando junto significa profundidade falsa. Espaçamento uniforme de fantasmas em um movimento de herói significa easing linear, o que falha. Se--ghostnão puder ser executado, faça uma cópia de rascunho e dê ao pai do mundo uma câmera de prova (empurre para trás + inclinação + guinada, por exemplotranslateZ(-900px) rotateX(-28deg) rotateY(64deg); apenas guinada coloca a câmera dentro de cenas profundas), tire instantâneos de 4 a 6 tempos de quadro ao longo do movimento e sobreponha-os (ffmpeg … -filter_complex blend=all_mode=lighten). Construa esta cebola manualmente para perspectiva aninhada (snapshot --angle sideachata) e para câmeras de projeção JS (3D projetado em um SVG/canvas): troque uma câmera lateral na função de projeção na cópia de rascunho. -
Assistir em tempo real. Se um render existir:
- faça uma tira:
ffmpeg -i renders/video.mp4 -vf fps=6,scale=360:-1,tile=6x4 strip.jpg; - verifique a duração e o primeiro e último quadros com
ffprobe; - se houver áudio, verifique cada batida contra a planilha de referência (±1 quadro) e pico verdadeiro ≤ −1 dBTP no arquivo AAC final (
ffmpeg -i … -af ebur128=peak=true -f null -); - overlays
.webmtransparentes:ffprobemostra VP9-alpha comoyuv420p; verifique alfa decodificando com-c:v libvpx-vp9antes de-i(o stream lêyuva420p) ou a tagALPHA_MODE=1.
- faça uma tira:
-
Leitura de código. Grep na composição por:
ease:(liste cada ease usado) e durações;- entradas apenas com opacidade e pequenos deslocamentos
y:(20–40 px); Math.random/Date.now(não determinístico);back.out|elastic|bounce,yoyo,repeat: -1;- linear ou
power1em movimentos espaciais; eases fora da lista permitida (mg.*,power3.out,expo.out,power3.in,power4.out,power2.inOut,none, uma mola cozida); - tweens concorrentes compartilhando um ease (ok apenas como um grupo travado: um tween multi-alvo ou uma linha do tempo filha com
defaults; um proxy orientado por setter conta uma vez, pelo ease em seu tween); - uma subida de máscara de linha borrada começando abaixo de
yPercent 130(o borrão vaza para a máscara); - fontes proibidas;
- granulação, vinheta ou desfoque de movimento ausentes.
-
Pontue as 9 dimensões (âncoras abaixo), 1–5, cada uma com uma razão de uma linha vinculada a um tempo ou quadro.
-
Barra de artesanato (12 itens, passa/falha; tabela abaixo).
-
Escaneamento anti-slop (lista dos 15 principais abaixo). Registre os IDs.
-
Licenças. Cada ativo não original (fonte, SFX, música, imagem, código de terceiros) tem uma fonte e uma licença compatível por escrito. Fontes: OFL ou similar. Código: MIT ou Apache com cabeçalhos mantidos. Qualquer coisa desconhecida: sinalize.
Âncoras da rubrica (pontuação 1–5)
| Dimensão | 1 | 3 | 5 |
|---|---|---|---|
| Conceito | Nenhuma ideia; texto sobre fundos; qualquer marca poderia ser trocada | Ideia clara em uma frase; o movimento a apoia em algumas cenas | Uma ideia forte do início ao fim com um momento surpreendente e próprio que você pode descrever em uma frase |
| Composição | Tudo centralizado, tamanhos uniformes, bagunça ou vazio sem intenção | Grade, um herói por quadro, espaço negativo decente | Cada still é de nível de pôster: cortes deliberados, camadas de profundidade, espaço negativo; layouts evoluem |
| Tipografia | Fonte de sistema ou genérica, tracking padrão, blocos inteiros desbotando | Unidade de divisão correta (linha/palavra/caractere), revelações mascaradas, legível | Tipo é a animação: eixos variáveis, layout cinético, brincadeira de corte/escala, ritmo impecável |
| Temporização e easing | Eases lineares ou padrão, durações uniformes, sem pausas | Eases personalizados em movimentos de herói, durações variam, pausas legíveis | Velocidade assimétrica, overshoot de bom gosto, pausas que parecem inevitáveis quadro a quadro |
| Coreografia | Tudo se move junto ou em um escalonamento uniforme | Herói lidera, apoios seguem com deslocamentos, sobreposição presente | Conduzida: um gesto flui para o próximo, movimento secundário reage ao primário |
| Transições | Crossfades ou cortes não relacionados | Máscaras/wipes projetados, no ritmo | Uma câmera/ideia contínua; memorável, nunca gratuita |
| Profundidade e textura | Vetores planos em um fundo plano ou gradiente blob, quadro estático | Deriva/empurrão de câmera, 2+ planos de profundidade, alguma granulação ou luz | 3D real ou 2.5D convincente, iluminação conta a história, textura unifica sem se exibir |
| Sincronização de som | Silencioso ou áudio não relacionado | Cortes principais caem nos ritmos | Imagem e som compostos juntos; silêncio usado como acento; mixagem limpa |
| Acabamento | Bugs, tremulação, estalos, aliasing, ativos não carregados | Limpo, consistente, quadro final projetado | Entregável de estúdio; cada quadro escrutinado; quadro final mantido e resolvido |
Pontuações 2 e 4 ficam entre as âncoras. Para pontuar 4:
- Temporização: paleta de eases por função, "saída rápida, assentamento longo" chegadas, aceleração de saídas.
- Coreografia: antecipação, acompanhamento e escalonamentos suavizados ou baseados em distância.
- Transições: pelo menos um match cut ou morph, e cortes na velocidade máxima com desfoque.
- Profundidade: paralaxe de 3 planos e desfoque de movimento em movimentos rápidos.
- Composição: contraste de escala de pelo menos 5×.
Uma peça silenciosa, sem SFX, que se declara silenciosa no briefing pontua Sincronização de som em seus silêncios e ritmo visual; não puna uma escolha deliberada.
Portões rígidos (qualquer um = Bloqueio)
checkfalha, o render é não determinístico, ou uma busca mostra um glitch.- Texto que você não pode ler:
- pausa menor que 0.5 s + 0.3 s por palavra;
- contraste abaixo de 4.5:1;
- texto cruzando a área segura.
- Flash de fonte, ativo ausente, quadro quebrado ou vazio em uma costura, ou um pop no primeiro ou último quadro.
- 3 ou mais hits anti-slop sem uma justificativa por escrito.
- Ease linear ou padrão em um movimento espacial de herói.
- Um item da barra de artesanato ausente sem uma renúncia por escrito no briefing.
- Mais de 3 flashes por segundo.
- Um ativo de terceiros sem fonte ou licença registrada.
Barra de artesanato (12 itens)
- Conceito. Uma ideia em uma frase e um momento de assinatura em ~40% do tempo de execução.
- Still herói. Um quadro herói projetado (Composição ≥ 4, pelo menos 3 camadas de profundidade).
- Câmera. Pelo menos um movimento real de câmera ou profundidade, comprovado pela verificação fantasma ou de ângulo lateral.
- Eases personalizados. Pelo menos 3 caracteres de ease distintos, e nenhum dois tweens concorrentes compartilhando um por acidente.
- Sem fade-up padrão. Nenhum
opacidade 0→1+y 20–40→0em qualquer lugar. - Costuras nomeadas. Costuras são nomeadas e combinadas em velocidade; no máximo um crossfade simples.
- Desfoque de movimento em 1–3 batidas rápidas (nunca em texto enquanto está sendo lido).
- Passada de textura. Granulação, vinheta e gradientes radiais (motivados pela luz).
- Evento de luz. Pelo menos um: um sweep, brilho, banda de varredura, bloom ou vazamento.
- Som. Sincronização de som se houver áudio; caso contrário, a peça é declarada silenciosa.
- Ritmo.
- A batida do storyboard mais lenta é pelo menos 3× a mais rápida (batidas são linhas do storyboard, não sub-tweens).
- Em todos os tweens, duração máxima/mínima é pelo menos 4.
- O still final segura por pelo menos 0.8 s.
- O último quadro funciona como uma miniatura.
- Barra da rubrica atendida (veja Barra de envio).
Anti-slop top 15
| id | Sinal | Correção |
|---|---|---|
| S1 | Cada elemento aparece e desliza para cima 20–40 px | Entrada por função: máscaras/divisões para texto, escala-do-ponto para formas, carregado pela câmera para cenas |
| S2 | Durações idênticas (tudo 0.5 s / 1 s) | Duração a partir da distância e massa; chegadas de herói 0.8–1.5 s, saídas ~30% mais rápidas |
| S3 | Ease padrão (power1, CSS ease, ease-in-out) ou linear em movimentos espaciais | Eases personalizados nomeados; assimétrico "saída rápida, assentamento longo" |
| S4 | Escalonamento uniforme de 0.1 s | Escalonamento suavizado a partir de uma origem significativa (centro, ponto focal, ordem de leitura) |
| S5 | Tudo se move ao mesmo tempo, mesma velocidade | Um líder; apoios seguem 2–8 quadros depois com menos amplitude |
| S6 | Sem pausas: entra, depois sai direto | Pausa de leitura ≥ 0.5 s + 0.3 s/palavra |
| S7 | Paradas mortas: chega e congela | Assentamento longo, micro deriva durante a pausa |
| S8 | Elástico/back/bounce em tudo | No máximo um overshoot por peça, ≤ 6%, apenas em transformações |
| S9 | Pulsações "respiratórias" ociosas (yoyo de escala/opacidade) | Imobilidade, ou um ambiente motivado, ou uma deriva de câmera com uma pose final |
| S10 | Movimentos rápidos sem desfoque de movimento | Desfoque de obturador ou direcional nas 1–3 batidas mais rápidas |
| S11 | Pilha centralizada: título / subtítulo / botão | Grade assimétrica, tipo ancorado na borda, 30–50% de espaço negativo |
| S12 | Quadro estático, sem câmera | Empurrão, deriva, planos de paralaxe, close-ups nos ritmos |
| S13 | "Slides": cena desaparece, próxima aparece | Costuras motivadas: match cut, momentum, máscara, morph |
| S14 | Bolhas roxo-azul / rosa-laranja, glassmorphism, neon em tudo | Gradientes que se comportam como luz de uma fonte; 2–3 matizes + neutros, acento ≤ 10% |
| S15 | Inter/Roboto/Poppins regular como "o design"; emoji ou ícones de estoque | Face display expressiva, tracking apertado, contraste de peso; marcas personalizadas ou nenhuma |
Também observe:
- máquina de escrever + cursor como a ideia toda;
- números de contagem genéricos;
- cópia Lorem-like ("desbloqueie o futuro de…");
- um final que apenas para ou desaparece;
- uma curva de energia plana sem clímax;
- movimento que caberia em qualquer mensagem.
Barra de envio
- APROVADO: média ≥ 4.0, nenhuma dimensão abaixo de 3, zero portões rígidos.
- POLIR: média 3.5–3.9, ou uma dimensão em 3. Lista de correções, depois re-revisão.
- REFORMULAR: média abaixo de 3.5. Volte ao conceito e styleframes; polir não vai salvar.
Formato review.md
piece: <nome> · reviewed: <data> · render: <caminho ou nenhum>
conceito: N — … composição: N — … tipografia: N — …
temporização_easing: N — … coreografia: N — … transições: N — …
profundidade_textura: N — … sincronização_som: N — … acabamento: N — …
média: N.N
portões_rígidos: [ … ]
barra_artesanato: [1 ✓, 2 ✗ (motivo), …]
hits_anti_slop: [S1, S7, …]
veredito: APROVADO | POLIR | REFORMULAR → rota de correções para: conceito | composição | construção de movimento
folha_contato: <caminho>
Em seguida, uma tabela Antes | Depois | Porquê. Ordene por alavancagem (impacto ÷ esforço), e faça cada "Depois" um valor exato:
| # | Onde (t / quadro / seletor) | Antes | Depois | Porquê |
|---|---|---|---|---|
| 1 | 3.40–3.90 s #title | opacidade + y 30, power2.out 0.5 s | dividir em linhas, revelar máscara, ease de assentamento cubic-bezier(0,.65,.51,.99) 0.9 s, linhas +4 quadros | fade-up padrão (S1); sem assentamento (S7) |
Ordem de correção: deletar → reduzir → corrigir easing → corrigir composição/origem → retemporizar → adicionar profundidade/desfoque/textura → polir. Nunca escreva "tornar mais dinâmico"; sempre dê uma receita com números.
Re-revisão
Re-revisões vão de volta ao mesmo revisor. Após correções, re-exeute a etapa 1, etapa 3 (regiões alteradas e suas costuras) e etapa 7. Qualquer retemporização re-executa check: suas amostras de contraste se movem com a temporização. Mantenha as pontuações antigas em review.md para que a melhoria seja visível, e termine cada rodada com sua própria linha verdict:. Pare após 3 loops de polimento; se a média ainda estiver abaixo de 4.0, retorne REFORMULAR.
Parte dos skills gratuitos mograf (MIT). Para o pipeline completo do estúdio, veja mograf.si. Cada peça na biblioteca vem com seu prompt, skills, fonte e cópia.