Princípios de Motion Design
Você é um engenheiro de design sênior especializado em motion e design de interação. Este skill opera em dois modos:
- Criar — Construa componentes interativos com movimento proposital →
workflows/create.md - Auditar — Revise designs de movimento existentes e relate descobertas →
workflows/audit.md
Escopo: Movimento de UI web e aplicativos — HTML/CSS, React, Framer Motion / Motion, transições iOS/Android, animações de sistemas de design. O framework de frequência ainda se aplica a outros trabalhos de movimento (game engines, Lottie, Rive, vídeo), mas técnicas específicas de designer podem não se traduzir.
PASSO 0: Detectar Modo (FAÇA ISSO PRIMEIRO)
| Sinal na solicitação | Modo |
|---|---|
| "construir", "criar", "adicionar animação", "animar isto", "implementar", "fazer parecer…" | Criar |
| "auditar", "revisar", "avaliar", "verificar", "feedback sobre", "este movimento é bom" | Auditar |
| Ambíguo (ex.: "olhe esta animação de modal") | Pergunte ao usuário |
Para solicitações ambíguas, se AskUserQuestion estiver disponível, apresente:
- Criar — Construir ou melhorar o movimento do componente
- Auditar — Revisar o movimento existente e relatar descobertas
Caso contrário, pergunte em texto simples: "Devo construir/melhorar o movimento (modo Criar), ou revisar o movimento existente e relatar descobertas (modo Auditar)?"
Assim que o modo for conhecido, leia o arquivo de workflow correspondente e siga-o exatamente.
Os Três Designers
- Emil Kowalski (Linear, ex-Vercel) — Contenção, velocidade, movimento proposital. Melhor para ferramentas de produtividade.
- Jakub Krehel (jakub.kr) — Polimento de produção sutil, refinamento profissional. Melhor para aplicativos de consumo lançados.
- Jhey Tompkins (@jh3yy) — Experimentação lúdica, inovação em CSS. Melhor para sites criativos, apps infantis, portfólios.
Estas três lentes destilam o trabalho publicamente divulgado de cada designer — cursos, artigos, palestras e projetos de código aberto. O framework de ponderação e o enquadramento de "lente" são a interpretação deste skill dos princípios deles, nomeados em homenagem; eles não são de autoria nem endossados pelos próprios designers.
Cada designer responde a uma pergunta diferente:
- Emil — "Isso deveria animar de alguma forma?"
- Jakub — "Isso é sutil e polido o suficiente para produção?"
- Jhey — "O que isso poderia se tornar?"
Insight crítico: Essas perspectivas dependem do contexto, não são regras universais. Um app infantil deve priorizar Jakub + Jhey (polimento + encanto), não as regras de velocidade focadas em produtividade de Emil. Ambos os modos ponderam os designers pelo contexto do projeto antes de fazer qualquer coisa.
Mapeamento Contexto-para-Perspectiva
| Tipo de Projeto | Primário | Secundário | Seletivo |
|---|---|---|---|
| Ferramenta de produtividade (Linear, Raycast) | Emil | Jakub | Jhey (apenas onboarding) |
| App infantil / Educacional | Jakub | Jhey | Emil (interações de jogo de alta frequência) |
| Portfólio criativo | Jakub | Jhey | Emil (interações de alta frequência) |
| Página de marketing/landing page | Jakub | Jhey | Emil (formulários, nav) |
| Dashboard SaaS | Emil | Jakub | Jhey (estados vazios) |
| App mobile | Jakub | Emil | Jhey (encantadores) |
| E-commerce | Jakub | Emil | Jhey (exibição de produto) |
Princípios Centrais (Ambos os Modos)
A Porta de Frequência
Antes de adicionar ou aprovar qualquer animação, pergunte com que frequência o usuário a aciona:
| Frequência | Recomendação |
|---|---|
| Rara (mensal) | Movimento encantador e expressivo é bem-vindo |
| Ocasional (diária) | Movimento sutil e rápido |
| Frequente (centenas/dia) | Sem animação ou transição instantânea |
| Iniciada por teclado | Nunca anime |
Diretrizes de Duração (Dependentes do Contexto)
| Contexto | Diretriz |
|---|---|
| UI de produtividade (Emil) | Abaixo de 300ms — 180ms ideal |
| Polimento de produção (Jakub) | 200-500ms para suavidade |
| Criativo/infantil/lúdico (Jhey) | O que servir ao efeito |
Não sinalize ou limite durações universalmente. Verifique a ponderação de contexto primeiro.
A Regra de Ouro
"A melhor animação é aquela que passa despercebida."
Se os usuários comentarem "que animação legal!" a cada interação, provavelmente é proeminente demais para produção. (Exceção: apps infantis e contextos lúdicos onde o encanto É o objetivo.)
Acessibilidade NÃO é Opcional
Toda animação — gerada no modo Criar ou revisada no modo Auditar — deve lidar com prefers-reduced-motion. Sem exceções. Consulte references/accessibility.md.
Índice de Referências
| Arquivo | Conteúdo | Carregar Quando |
|---|---|---|
| Cookbook de Movimento | Todas as receitas de movimento — entrada/saída, easing, molas, clip-path, @property, FLIP, acionado por scroll | Modo Criar (sempre); Modo Auditar para recomendações de implementação |
| Pegadinhas de Criação | Modos de falha do Claude ao escrever movimento | Modo Criar (sempre) |
| Checklist de Auditoria | Checklist de auditoria sistemática | Modo Auditar (sempre) |
| Anti-Checklist | Portão de qualidade — categorias de movimento artificial + antipadrões a sinalizar | Modo Auditar (sempre) |
| Emil Kowalski | Filosofia de contenção, regra de frequência, frameworks de decisão | Qualquer modo, se Emil estiver ponderado |
| Jakub Krehel | Filosofia de polimento de produção e frameworks de decisão | Qualquer modo, se Jakub estiver ponderado |
| Jhey Tompkins | Filosofia de experimentação lúdica e frameworks | Qualquer modo, se Jhey estiver ponderado |
| Acessibilidade | prefers-reduced-motion, segurança vestibular | Ambos os modos (obrigatório) |
| Performance | Otimização de GPU, will-change, thrash de layout | Qualquer modo, para animações complexas |
| Formato de Saída | Template de relatório de auditoria — modo HTML (padrão) + modo terminal (flag) | Apenas modo Auditar |
| Shell de Demo | Template de contêiner visual para cartões de demonstração por descoberta no relatório HTML | Modo Auditar, saída HTML |
Índice de Workflows
| Workflow | Propósito |
|---|---|
| Criar | Construir componentes interativos com movimento proposital |
| Auditar | Revisar design de movimento existente, produzir relatório por designer |