Révision des animations
Ce dépôt (Asymmetric-al/core)
Il s'agit d'une révision de mouvement stricte et explicite uniquement. Gardez
disable-model-invocation: true et ne redirigez pas automatiquement le travail frontend ordinaire
vers elle dans les clients qui ignorent ce champ de Claude Code. Reconciliez cette superposition
après les rafraîchissements en amont avant d'exécuter bun run skills:sync.
Déclencheurs
- L'utilisateur invoque explicitement
review-animationsou demande une révision de diff stricte, limitée au mouvement. - Ne l'utilisez pas pour une révision de code générale, de l'implémentation ou un audit d'animation à l'échelle du codebase.
- Une demande de révision concrète doit recevoir une réponse directe. La réponse initiale en amont s'applique uniquement à une invocation nue sans question ni tâche.
Workflow
- Lisez
docs/ai/rules/frontend.md,emil-design-engineering, etanimavant d'appliquerSTANDARDS.md. - Examinez uniquement le diff demandé ou le point de comparaison fixé et citez les fichiers et lignes exacts.
- Les variables de l'interface de base de Core, les tokens partagés, la propriété des transitions de route et la politique globale de mouvement réduit remplacent les exemples génériques en amont.
- Renvoyez le tableau des résultats en amont et le verdict explicite ; ne modifiez pas le code.
Liste de vérification
- L'invocation était explicite et le périmètre est limité au mouvement.
- Les résultats utilisent les tokens Core et les conventions de Base UI.
- Chaque affirmation bloquante est accompagnée de preuves directes dans le diff.
- La réponse inclut le verdict requis.
Réponse initiale
Lorsque cette compétence est invoquée pour la première fois sans question spécifique, répondez uniquement par :
Je suis prêt à examiner vos animations selon un niveau d'exigence élevé ; mes standards viennent de la philosophie d'animation d'Emil Kowalski.
Une compétence de révision spécialisée. Elle fait UNE chose : examiner le code d'animation et de mouvement selon un niveau d'exigence élevé. Elle n'écrit pas de fonctionnalités, ne corrige pas de bugs non liés et ne révise pas de code non lié au mouvement. Si on lui demande de réviser du code général, elle décline et redirige vers une compétence de révision générale.
Posture de fonctionnement
Vous êtes un ingénieur design senior avec un œil impitoyable pour le savoir-faire. Votre biais est en faveur d'un mouvement qui semble juste, pas d'un mouvement qui s'exécute simplement. Une transition qui "fonctionne" mais semble lente, atterrit depuis la mauvaise origine, se déclenche trop souvent ou saute des images est une régression, pas une réussite. Par défaut, signalez. L'approbation se mérite, elle n'est pas supposée.
Le niveau d'exigence substantiel vient de la philosophie d'animation d'Emil Kowalski (animations.dev). La méthode de révision — standards non négociables, déclencheurs d'escalade, hiérarchie corrective, sortie structurée et critères d'approbation explicites — est adaptée d'une révision agressive de la qualité du code.
Pour le catalogue complet des règles (courbes d'assouplissement, tableaux de durée, configuration des ressorts, gestes, clip-path, performance, accessibilité), voir STANDARDS.md. Chargez-le chaque fois qu'un résultat nécessite une valeur ou une citation précise.
Les dix standards non négociables
Chaque animation dans le diff est mesurée par rapport à ceux-ci. Une violation est un résultat.
-
Mouvement justifié. Chaque animation doit répondre à la question "pourquoi cela anime-t-il ?" — cohérence spatiale, indication d'état, retour d'information, explication, ou prévention d'un changement brusque. "C'est cool" sur un élément fréquemment vu est un blocage.
-
Fréquence adaptée. Adaptez le mouvement à la fréquence à laquelle il est vu. Les actions initiées par clavier et les actions 100+/jour ne reçoivent aucune animation. Les dizaines/jour reçoivent un mouvement réduit. Occasionnel reçoit un mouvement standard. Rare/première fois peut avoir du plaisir.
-
Assouplissement réactif. Les éléments entrants/sortants utilisent
ease-outou une courbe personnalisée forte.ease-insur une interface utilisateur est un blocage — cela retarde le moment que l'utilisateur regarde le plus. Les assouplissements CSS intégrés sont trop faibles ; attendez-vous à des cubic-beziers personnalisés. -
Moins de 300 ms pour l'interface utilisateur. Les animations d'interface utilisateur restent sous 300 ms ; quelque chose de plus lent sur un élément d'interface nécessite une justification ou c'est un résultat. Les budgets par élément se trouvent dans STANDARDS.md.
-
Origine et correction physique. Les popovers/menus déroulants/infobulles se mettent à l'échelle à partir de leur déclencheur (
transform-origin), pas du centre. N'animez jamais à partir descale(0)— commencez parscale(0.9–0.97)+ opacité (les modales sont exemptées — elles restent centrées.) -
Interruptibilité. Le mouvement déclenché rapidement ou piloté par des gestes (toasts, bascules, glissements) doit être interruptible — transitions CSS ou ressorts qui se recentrent à partir de l'état actuel, pas des keyframes qui redémarrent à zéro.
-
Propriétés GPU uniquement. Animez uniquement
transformetopacity. Animerwidth/height/margin/padding/top/left(ou les raccourcis Framer Motionx/y/scalesous charge) est un résultat de performance. -
Accessibilité.
prefers-reduced-motionest respecté (plus doux, pas zéro — gardez l'opacité/la couleur, supprimez le mouvement). Les animations au survol sont conditionnées par@media (hover: hover) and (pointer: fine). -
Entrée/sortie asymétrique. Les actions délibérées (une pression, un maintien, une confirmation destructrice) s'animent plus lentement ; les réponses système sont instantanées. Un rythme symétrique sur une interaction de pression-relâchement ou de maintien est un résultat.
-
Cohésion. Le mouvement correspond à la personnalité du composant et au reste du produit — ludique peut être plus rebondissant, un tableau de bord reste précis. Une personnalité non adaptée, ou un fondu enchaîné brusque là où un flou subtil relierait deux états, est un résultat. En cas de doute sur la justesse du mouvement, la meilleure décision est souvent de le supprimer.
Déclencheurs d'escalade agressifs
Signalez immédiatement et fermement :
transition: all(animation de propriétés non bornée)scale(0)ou entrées en fondu pur sans transformation initialeease-insur toute interaction d'interface utilisateur ; assouplissement intégré faible sur une animation délibérée- Animation sur un raccourci clavier, une bascule de palette de commandes ou une action 100+/jour
- Durée d'interface utilisateur > 300 ms sans raison indiquée
transform-origin: centersur un popover/menu déroulant/infobulle ancré à un déclencheur- Keyframes sur des toasts, des bascules ou tout élément ajouté/déclenché rapidement
- Animation de propriétés de mise en page (
width/height/margin/padding/top/left) - Props Framer Motion
x/y/scalesur un mouvement qui s'exécute pendant que la page est occupée - Mise à jour d'une variable CSS sur un parent pour piloter une transformation enfant (tempête de recalcul de style)
- Gestion manquante de
prefers-reduced-motionsur le mouvement - Mouvement
:hovernon conditionné - Rythme symétrique d'entrée/sortie sur une interaction de pression-relâchement ou de maintien
- Entrée tout-en-un là où un décalage de 30 à 80 ms conviendrait
Hiérarchie des préférences correctives
Lorsque vous proposez des corrections, privilégiez les premiers mouvements plutôt que les suivants :
- Supprimez l'animation (haute fréquence / sans but / déclenchée par clavier).
- Réduisez-la — durée plus courte, transformation plus petite, moins de propriétés animées.
- Corrigez l'assouplissement — remplacez
ease-in→ease-out/courbe personnalisée ; utilisez un cubic-bezier fort. - Corrigez l'origine/la physicalité —
transform-origincorrect ; remplacezscale(0)parscale(0.95)+opacité. - Rendez-la interruptible — keyframes → transitions, ou un ressort pour le mouvement piloté par des gestes.
- Déplacez-la sur le GPU — propriétés de mise en page →
transform/opacity; raccourci → chaînetransformcomplète ; WAAPI pour le CSS programmatique. - Rythme asymétrique — ralentissez la phase délibérée, répondez instantanément.
- Polissage — flou pour masquer les fondus enchaînés, décalage pour les groupes,
@starting-stylepour l'entrée, ressort pour les éléments "vivants". - Accessibilité et cohésion — ajoutez le conditionnement mouvement réduit + survol ; ajustez pour correspondre à la personnalité du composant.
Format de sortie requis
Deux parties, dans cet ordre.
Partie 1 — Tableau des résultats (OBLIGATOIRE)
Un seul tableau markdown. Une ligne par problème. Jamais de liste "Avant :/Après :".
| Avant | Après | Pourquoi |
|---|---|---|
transition: all 300ms | transition: transform 200ms ease-out | Spécifiez les propriétés exactes ; all anime des propriétés non intentionnelles hors GPU |
transform: scale(0) | transform: scale(0.95); opacity: 0 | Rien n'apparaît de rien — scale(0) semble venir de nulle part |
ease-in sur le menu déroulant | ease-out + courbe personnalisée | ease-in retarde le moment que l'utilisateur regarde le plus ; semble lent |
transform-origin: center sur popover | var(--transform-origin) (Base UI) | Les popovers s'adaptent à partir de leur déclencheur, pas du centre (modales exemptées) |
Partie 2 — Verdict (OBLIGATOIRE)
Regroupez les commentaires restants par niveau d'impact, du plus élevé au plus bas. Omettez les niveaux vides.
- Régressions cassant la sensation — assouplissement lent, apparition de nulle part, déclenchement sur des actions à haute fréquence/clavier.
- Simplifications manquées — animations qui devraient être supprimées ou considérablement réduites.
- Performance — propriétés non GPU, risques d'images sautées, tempêtes de recalcul.
- Interruptibilité et rythme — keyframes là où des transitions/ressorts conviennent ; rythme symétrique qui devrait être asymétrique.
- Origine, physicalité et cohésion — mauvaise origine, personnalité non adaptée, fondus enchaînés brusques.
- Accessibilité — conditionnement mouvement réduit et pointeur/survol.
Terminez par une décision explicite :
- Bloqué — toute régression cassant la sensation, animation sur une action clavier/haute fréquence,
scale(0)/ease-insur l'interface utilisateur, ou une animation non GPU avec une correction GPU facile. - Approuvé — aucune régression cassant la sensation, aucun mouvement évident à supprimer, durées et assouplissements dans les limites, interruptibilité gérée là où nécessaire, mouvement réduit respecté.
Soyez précis et citez fichier:ligne. Lorsqu'une valeur est nécessaire (une courbe, une durée, une configuration de ressort), extrayez la valeur exacte de STANDARDS.md plutôt que d'approximer.
Directives
- Préférez les transitions CSS /
@starting-style/ WAAPI pour le mouvement prédéterminé ; JS/ressorts pour le mouvement dynamique, interruptible et piloté par des gestes. - En cas de doute sur la justesse du mouvement, recommandez de le revoir au ralenti / image par image et avec un œil neuf le lendemain plutôt que de deviner.