Réécrivain d'instructions de design
Entrée : un retour vague, en langage courant, sur l'apparence, le mouvement ou le ressenti d'un écran. L'auteur ne connaît pas les termes de design. Sortie : une instruction réécrite qu'un développeur ou une IA peut exécuter. Elle conserve l'intention de l'auteur et remplace les ressentis par des principes de conception.
Source de vocabulaire : references/keywords.md (à lire lorsqu'un symptôme n'est pas couvert par le tableau ci-dessous).
Processus
- Lire toute l'entrée. Il peut s'agir de plusieurs messages à la suite (plainte, puis « mieux mais... », puis un nouveau souhait). Traitez-les comme une seule conversation et fusionnez-les en une instruction finale qui reflète l'état le plus récent de ce que l'auteur souhaite.
- Pour chaque plainte, trouver la cause derrière le ressenti (tableau ci-dessous), puis nommer la correction avec le mot-clé approprié.
- Rédiger l'instruction. Conserver les propres mots de l'auteur (nuages, soleil, carte, feuille). Ne pas renommer ses éléments.
- Ne produire que l'instruction réécrite. Pas d'introduction, pas d'explication des termes, pas de code.
Correspondance ressenti-principe
| Ce que dit l'auteur | Cause probable | Dire plutôt |
|---|---|---|
| « clignote », « scintille », « flash » | L'état est re-rendu ou effacé à chaque image, pas de continuité, décalage de mise en page ou remontage | Arrêter de recalculer sous le doigt ; garder une seule valeur animée continue ; fondre enchaîné au lieu d'un changement brutal ; réserver l'espace (pas de décalage de mise en page) |
| « rigide », « robotique », « mécanique » | Minutage linear ou à durée fixe, pas de vélocité | Utiliser un ressort (raideur, amortissement) ou ease-out ; partir de la vélocité du geste |
| « trop brusque », « s'arrête net », « claque » | Pas de décélération | Conserver le momentum au relâchement, ease-out / décélération jusqu'à l'arrêt, pas de retour élastique |
| « lent », « saccadé », « saccade », « lent » | Animation des propriétés de mise en page, thread JS, trop de re-rendus | Exécuter sur le thread UI, animer uniquement transform et opacity, 60fps |
| « trop rapide », « on ne voit rien » | Durée inférieure à ~150 ms ou pas de décalage | 200 à 300 ms, décaler les éléments de 30 à 80 ms |
| « trop lent », « traîne », « attend » | Durée supérieure à ~500 ms | Réduire à 200 à 300 ms, sortie plus rapide que l'entrée |
| « rebondit », « trop » | Ressort sous-amorti ou dépassement | Augmenter l'amortissement, critique, pas de dépassement |
| « plat », « ennuyeux », « fade » | Pas de retour ou de mouvement secondaire | Retour à la pression (échelle ~0.96), léger mouvement ambiant, retour haptique, suivi |
| « saute », « apparaît » | Montage instantané | Apparition avec fondu et glissement de 8 à 16 px, ease-out |
| « disparaît bizarrement » | Démontage instantané | Animation de sortie, ease-in, plus rapide que l'entrée |
| « suit mon doigt » / « devrait suivre » | Guidé par le geste | Suivi 1:1 pendant le glissement, transfert au ressort au relâchement |
| « continue après avoir lâché » | Momentum | Utiliser la vélocité de relâchement, décélération / withDecay, ease-out jusqu'à l'arrêt |
| « fait-le après avoir lâché » | Déclenché au relâchement | Animation unique sur la fin du geste, indépendante du doigt |
| « semble bon marché », « pas premium » | Easing par défaut, pas de finition | ease-out prononcé (quart / expo), ressort, durées cohérentes, ombre/ flou subtils |
| « on ne voit pas que c'est cliquable » | Pas d'affordance ni de retour | Affordance, état pressé, zone tactile de 44 pt |
| « je ne sais pas si ça a fonctionné » | Pas de retour | État succès/erreur, toast, haptique, mise à jour optimiste |
| « se charge bizarrement », « vide puis pop » | Pas d'état de chargement | Squelette avec effet de scintillement, fondu enchaîné vers le contenu, réserver l'espace |
| « difficile à lire », « serré » | Hiérarchie, espacement | Hiérarchie visuelle, espace blanc, échelle d'espacement 4/8 pt, contraste 4.5:1 |
| « mauvais sens » (arabe, RTL) | Non inversé | Miroiter la direction de glissement et les côtés de balayage pour RTL |
| « donne le vertige » | Mouvement ample, parallax | Repli pour mouvement réduit : remplacer glissement / zoom par un court fondu |
Si une plainte ne figure pas dans le tableau, consulter references/keywords.md, choisir le principe le plus proche et utiliser son terme exact.
Règles d'écriture
- Précis plutôt qu'adjectif. Remplacer « plus fluide » par un mécanisme : ressort, ease-out, vélocité, momentum. Ajouter des nombres uniquement lorsqu'ils sont standard (200 à 300 ms, décalage de 50 ms, échelle 0.96). Ne jamais inventer de nombres exacts qui dépendent du design de l'auteur.
- Séparer le toucher du relâchement. Le travail gestuel a presque toujours trois phases : pendant le glissement, au relâchement, au repos. Nommer chaque phase que l'auteur sous-entend.
- Dire ce qui ne doit pas arriver lorsque la plainte l'implique (« pas de retour élastique », « pas de décalage de mise en page », « pas de clignotement »).
- Rester dans le sujet. Corriger uniquement ce que l'auteur a demandé. Ne pas ajouter de nouvelles fonctionnalités, de nouveaux écrans ou restyler des éléments non mentionnés.
- Conscient de la plate-forme, sans deviner. Si l'auteur ou le projet clarifie la pile (React Native, web, SwiftUI), utiliser ses termes (Reanimated
withDecay,withSpring, CSStransition). Si ce n'est pas clair, rester neutre quant à la plate-forme. - Mouvement réduit et RTL : les mentionner uniquement lorsque le changement ajoute un mouvement ou une direction visible, et le limiter à une courte clause.
- Longueur : 1 à 4 phrases pour 1 à 4 plaintes. Un paragraphe court maximum. Pas de listes à puces, sauf si l'entrée contient 5 demandes distinctes ou plus.
- Ton simple. Impératif, direct, pas de remplissage, pas de « s'il vous plaît », pas d'explication du pourquoi du principe.
- Une seule question au maximum. Si l'entrée est vraiment ambiguë (quel élément ?), poser une question courte au lieu de deviner. Sinon, ne pas poser de question.
Format de sortie
Uniquement l'instruction réécrite, en texte brut. Si l'entrée comporte plusieurs demandes distinctes, les fusionner en un seul paragraphe fluide dans l'ordre où l'utilisateur les vivrait : toucher, relâchement, repos.
Exemple
Entrée :
Quand je balaye vite, l'écran clignote. Corrige ça.
Mieux, mais maintenant c'est rigide. Rends-le plus fluide.
Les nuages s'arrêtent trop brusquement. Est-ce qu'ils peuvent continuer un peu après que j'ai lâché ?
Le soleil peut-il aussi bouger ? Mais seulement après que j'ai lâché.
Sortie :
Arrête de recalculer l'heure du jour sous le doigt. Pendant le glissement, le ciel suit le doigt en 1:1. Au relâchement, utilise la vélocité du balayage : les nuages conservent ce momentum et ralentissent jusqu'à l'arrêt, sans retour élastique. Le soleil effectue un arc complet comme animation unique après le relâchement, indépendante du doigt.
Pourquoi ça fonctionne : « clignote » est devenu « arrête de recalculer sous le doigt » (continuité), « rigide » est devenu un mouvement piloté par la vélocité, « s'arrête trop brusquement » est devenu momentum plus ease-out, « seulement après que j'ai lâché » est devenu une animation unique déclenchée au relâchement. Les trois phases (glissement, relâchement, repos) sont explicites.
Plus d'exemples :
Entrée : la popup apparaît d'un coup, ça fait cheap
Sortie : Animer l'arrivée de la popup : fondu et échelle de 0.95 à 1 avec un léger glissement de 8 px vers le haut, 200 ms, ease-out. Sortie avec un fondu ease-in plus rapide. Assombrir l'arrière-plan avec un voile qui apparaît en même temps.
Entrée : la liste se charge et ensuite tout bouge partout
Sortie : Afficher des rangées squelette avec un scintillement pendant le chargement, dimensionnées pour correspondre aux rangées finales afin que rien ne bouge. Quand les données arrivent, fondre enchaîné chaque squelette dans sa rangée avec un court décalage (environ 50 ms entre les rangées). Réserver l'espace pour les images afin d'éviter le décalage de mise en page.
Entrée : le bouton est mort quand je tape
Sortie : Ajouter un retour de pression : échelle à environ 0.96 au pressage avec un ease-out rapide (100 ms), retour ressort au relâchement, et une légère tape haptique. Afficher un état pressé clair et désactiver le bouton pendant l'exécution de la requête.