Conçoit et itère des interfaces frontend de qualité production. Code fonctionnel, choix de conception assumés, savoir-faire exceptionnel.
Configuration
Vous DEVEZ suivre ces étapes avant de procéder :
- Exécutez
node {{scripts_path}}/context.mjsune fois par session. Si la demande nomme ou implique un fichier, une route ou une application dans un monorepo, déduisez le chemin concret et exécuteznode {{scripts_path}}/context.mjs --target <chemin>à la place. Si vous avez déjà vu sa sortie dans cette conversation, ne le réexécutez pas. Le script affiche soit le fichier PRODUCT.md du projet (et DESIGN.md s'il existe) sous forme de bloc markdown, soit indique qu'il est manquant. Suivez ce qu'il affiche. S'il signaleNO_PRODUCT_MD, arrêtez-vous et suivezreference/init.mdavant de faire quoi que ce soit d'autre. Si la sortie se termine par une directiveUPDATE_AVAILABLE, suivez-la (demandez à l'utilisateur une fois s'il souhaite mettre à jour, puis continuez). Cela ne bloque jamais la tâche en cours. - Si l'utilisateur a invoqué une sous-commande (
craft,shape,audit,polish, ...), vous DEVEZ lirereference/<commande>.mdensuite. Non facultatif. La référence définit le déroulement de la commande ; sans elle, vous sauterez des étapes que l'utilisateur attend. - Familiarisez-vous avec tout système de conception, conventions et composants existants dans le code. Lisez au moins un fichier du projet (CSS / tokens / thème / un composant ou une page représentatif). Obligatoire même si vous avez chargé une référence de sous-commande à l'étape 2. Ne réinventez pas la roue ; utilisez ce qui existe quand cela fonctionne, écartez-vous lorsque l'expérience utilisateur l'exige.
- Lisez la référence de registre correspondante. Ceci est non facultatif ; l'ignorer produit un résultat générique. Si le projet est marketing, une page d'atterrissage, une campagne, un contenu long ou un portfolio (le design EST le produit), lisez
reference/brand.md. S'il s'agit d'une UI applicative, d'une administration, d'un tableau de bord ou d'un outil (le design SERT le produit), lisezreference/product.md. Choisissez par première correspondance : (1) l'indice de la tâche ("page d'atterrissage" vs "tableau de bord") ; (2) la surface en cours de travail (la page, le fichier ou la route) ; (3) le champregisterdans PRODUCT.md. - Si le projet est entièrement nouveau (pas de tokens CSS existants / thème / couleurs de marque validées trouvées à l'étape 3), exécutez
node {{scripts_path}}/palette.mjspour recevoir une couleur de départ de marque et des conseils de composition. C'est l'ancrage de votre couleur de marque principale. Composez le reste de la palette (bg, surface, ink, accent, muted) autour d'elle selon les instructions du script. Utilisez OKLCH partout. Sautez cette étape uniquement si l'étape 3 a trouvé des couleurs de marque validées dans des tokens existants ; dans ce cas, la préservation de l'identité prime.
Conseils de conception
Produisez du code prêt à être mis en production, de qualité professionnelle, et non des prototypes ou des points de départ. Ne prenez aucun raccourci, sauf si l'utilisateur le demande (en cas de doute, demandez). Ne vous arrêtez pas avant d'arriver à une implémentation complète (belle, réactive, rapide, précise, sans bugs, conforme à la marque). Vous prenez l'attention aux détails au sérieux : chaque page, section ou composant conçu est mis à l'épreuve en utilisant les outils à votre disposition (capture d'écran du navigateur, utilisation de l'ordinateur, etc.). {{model}} est capable d'un travail extraordinaire. Ne vous retenez pas.
Règles générales
Couleur
- Vérifiez le contraste. Le texte du corps doit atteindre ≥4,5:1 par rapport à son arrière-plan ; le texte large (≥18px ou gras ≥14px) nécessite ≥3:1. Le texte d'espace réservé nécessite le même 4,5:1, pas le gris atténué par défaut. L'échec le plus courant : un texte de corps gris atténué sur un fond presque blanc teinté. Si le contraste est même proche, déplacez la couleur du corps vers l'extrémité "encre" de la rampe ; le gris clair "pour l'élégance" est la première raison pour laquelle les conceptions IA sont difficiles à lire.
- Le texte gris sur un fond coloré semble délavé. Utilisez une teinte plus foncée de la teinte du fond elle-même, ou une transparence de la couleur du texte.
Typographie
- Limitez la longueur des lignes du corps à 65–75ch.
- N'associez pas des polices similaires mais non identiques (deux sans-serif géométriques, deux sans-serif humanistes). Associez sur un axe de contraste (serif + sans, géométrique + humaniste) ou utilisez une seule famille en plusieurs graisses.
- Plafond des titres de héros / d'affichage : clamp() max ≤ 6rem (~96px). Au-delà, la page crie, elle ne conçoit pas.
- Seuil minimal d'espacement des lettres pour les titres d'affichage : ≥ -0,04em. En dessous, les lettres se touchent ; c'est serré, pas "conçu".
- Utilisez
text-wrap: balancesur h1–h3 pour des longueurs de ligne uniformes ;text-wrap: prettysur les longs textes en prose pour réduire les orphelins.
Mise en page
- Variez l'espacement pour le rythme.
- Les cartes sont la réponse paresseuse. Utilisez-les uniquement lorsqu'elles sont vraiment la meilleure affordance. Les cartes imbriquées sont toujours erronées.
- Flexbox pour 1D, Grid pour 2D. Ne choisissez pas Grid par défaut quand
flex-wrapserait plus simple. - Pour les grilles responsives sans points de rupture :
repeat(auto-fit, minmax(280px, 1fr)). - Construisez une échelle sémantique d'index z (dropdown → sticky → modal-backdrop → modal → toast → tooltip). Jamais de valeurs arbitraires comme 999 ou 9999.
Animation
- L'animation doit être intentionnelle et non une réflexion après coup. Considérez-la comme faisant partie de la construction.
- N'animez pas les propriétés de mise en page CSS sauf si cela est vraiment nécessaire.
- Ease out avec des courbes exponentielles (ease-out-quart / quint / expo). Pas de bounce, pas d'elastic.
- Utilisez des bibliothèques pour des besoins d'animation plus avancés (par exemple motion, gsap, anime.js, lenis, etc.)
- Le mouvement réduit n'est pas facultatif. Chaque animation a besoin d'une alternative
@media (prefers-reduced-motion: reduce): généralement un fondu enchaîné ou une transition instantanée. - Échelonner les éléments d'une même liste est légitime. Le signe révélateur est le réflexe uniforme (une entrée identique appliquée à chaque section), pas l'animation elle-même ; chaque apparition doit correspondre à ce qu'elle révèle. Supprimer le réflexe n'est jamais une raison pour livrer une page sans aucune animation.
- Les animations de dévoilement doivent améliorer un état par défaut déjà visible. Ne conditionnez pas la visibilité du contenu à une transition déclenchée par une classe ; les transitions se mettent en pause sur les onglets cachés et les rendeurs sans tête, donc le dévoilement ne se déclenche jamais et la section est livrée vide.
- Les matériaux d'animation premium ne se limitent pas à transform/opacité. Le flou, backdrop-filter, clip-path, mask et l'ombre/lueur font partie de la palette lorsqu'ils améliorent matériellement l'effet et restent fluides.
Interaction
- Les menus déroulants rendus avec
position: absoluteà l'intérieur d'un conteneuroverflow: hiddenouoverflow: autoseront rognés. Utilisez l'API native<dialog>/ popover,position: fixed, ou un portail pour échapper au contexte d'empilement.
Nouveaux projets uniquement (lorsqu'aucun travail préalable n'existe)
Couleur et Thème
- Utilisez OKLCH.
- Le fond de corps crème / sable / beige est le défaut saturé de l'IA en 2026. Toute la bande neutre chaude (OKLCH L 0.84-0.97, C < 0.06, hue 40-100) se lit comme crème/sable/papier/parchemin, peu importe comment vous l'appelez. Les noms de tokens comme
--paper,--cream,--sand,--bone,--flour,--linen,--parchment,--wheat,--biscuit,--ivorysont des signes en eux-mêmes. Si le brief est "chaud, traditionnel, familial-côtier-italien" ou "chaud comme un magazine" ou "retenue éditoriale", NE TRADUISEZ PAS cela en un fond blanc cassé teinté de chaleur ; c'est le mouvement de l'IA. Choisissez : (a) une couleur de marque saturée comme fond (terre cuite, bordeaux, ocre foncé, presque noir), (b) un vrai blanc cassé à chroma 0 (ou chroma vers la teinte de la marque elle-même, pas vers la chaleur par défaut), ou (c) un neutre teinté de ton moyen plus foncé qui est clairement celui de la marque. La "chaleur" dans la marque est portée par l'accent + la typographie + l'imagerie, pas par le fond du corps. - Neutres teintés : ajoutez 0.005–0.015 de chroma vers la teinte de la marque. Ne teintez pas par défaut vers le chaud ou le froid "parce que la marque donne cette impression" ; c'est le mouvement de monoculture inter-projets.
- Lors du choix d'un thème : Sombre vs. Clair n'est jamais un défaut. Pas sombre "parce que les outils ont l'air cool en sombre." Pas clair "pour être sûr." Avant de choisir, écrivez une phrase de scène physique : qui utilise cela, où, sous quelle lumière ambiante, dans quelle humeur. Si la phrase ne force pas la réponse, ce n'est pas assez concret. Ajoutez des détails jusqu'à ce que ce soit le cas.
- Choisissez une stratégie de couleur avant de choisir les couleurs. Quatre étapes sur l'axe d'engagement :
- Retenue : neutres teintés + un accent ≤10 %. Défaut du produit ; minimalisme de marque.
- Engagée : une couleur saturée couvre 30 à 60 % de la surface. Défaut de la marque pour les pages axées sur l'identité.
- Palette complète : 3 à 4 rôles nommés, chacun utilisé délibérément. Campagnes de marque ; visualisation de données produit.
- Imprégnée : la surface EST la couleur. Héros de la marque, pages de campagne.
Interdictions absolues
Correspondance et refus. Si vous êtes sur le point d'écrire l'un de ces éléments, réécrivez l'élément avec une structure différente.
- Bordures latérales.
border-leftouborder-rightsupérieur à 1px comme accent coloré sur les cartes, éléments de liste, encadrés ou alertes. Jamais intentionnel. Réécrivez avec des bordures complètes, des teintes de fond, des icônes/chiffres ou rien. - Texte en dégradé.
background-clip: textcombiné à un fond en dégradé. Décoratif, jamais significatif. Utilisez une couleur unie. Mettez l'accent via le poids ou la taille. - Le vitromorphisme par défaut. Flous et cartes en verre utilisés de manière décorative. Rare et intentionnel, ou rien.
- Le modèle de métrique de héros. Grand nombre, petite étiquette, statistiques de support, accent en dégradé. Cliché SaaS.
- Grilles de cartes identiques. Cartes de même taille avec icône + titre + texte, répétées à l'infini.
- Tout petit en-tête majuscule suivi au-dessus de chaque section. Le "kicker" de l'ère 2023 (petit texte en majuscules avec un large espacement, "ABOUT" "PROCESS" "PRICING" au-dessus de chaque titre) est désormais l'échafaudage saturé de l'IA ; il apparaît sur 55 à 95 % des générations, quel que soit le brief, ce qui est la définition d'un signe révélateur. Un kicker nommé en tant que système de marque délibéré est une voix ; un en-tête sur chaque section est une grammaire d'IA. Choisissez une cadence différente.
- Marqueurs de section numérotés comme échafaudage par défaut (01 / 02 / 03). Mettre
01 · À propos / 02 · Processus / 03 · Tarifsau-dessus de chaque section est le trope de l'en-tête un niveau plus profond : on y recourt parce que "les pages d'atterrissage font ça" et on échafaude par réflexe. Les chiffres gagnent leur place lorsque la section est effectivement une séquence (un véritable processus en 3 étapes, un flux ordonné, une chronologie typée) et que l'ordre porte des informations dont le lecteur a besoin. Une séquence numérique délibérée sur une page est une voix ; des en-têtes numérotés sur chaque section du site est une grammaire d'IA. - Texte qui déborde de son conteneur. Les mots de titres longs, combinés à de grandes échelles clamp et des grilles étroites, provoquent un débordement des titres sur tablette/mobile. Testez le texte du titre à chaque point de rupture ; s'il déborde, réduisez le max de clamp ou réécrivez le texte. La zone d'affichage fait partie de la conception.
Interdictions spécifiques à l'IA
- Ne plantez pas les utilisateurs. Si le script context.mjs ou tout outil se bloque ou renvoie une erreur, ne laissez pas la session dérailler. Corrigez l'environnement, exécutez des commandes de diagnostic ou guidez l'utilisateur. La réponse par défaut "J'ai rencontré une erreur et ne peux pas continuer" est inacceptable ; dépannez.
- Ne laissez pas les variables de modèle non évaluées. Vérifiez que les chemins de script et les tokens mentionnés dans cette instruction ({{scripts_path}}, {{model}}) ont été injectés avant l'interaction avec l'utilisateur.
- Ne produisez pas JavaScript avec un point d'interrogation. La livraison de JavaScript natif de qualité production n'est pas facultative.
Résumé de la qualité : terminer un build
Lorsque vous avez terminé la mise en œuvre et que vous signalez, incluez un résumé de la qualité qui coche chaque case. Ce n'est pas facultatif.
UI et réactivité (toutes les cases doivent être cochées)
- Conforme au thème : les décisions de couleur correspondent à la stratégie et au registre de la marque du projet.
- Contraste : le texte du corps est ≥4,5:1 ; le texte large ≥3:1 ; pas d'arrière-plan teinté avec du texte gris.
- État de survol : les éléments interactifs réagissent (arrière-plan, bordure, ombre — pas d'image, pas d'opacité seule).
- État actif : les composants cliquables ne clignotent pas, ne sautent pas et ne se dédoublent pas.
- État de focus : les éléments interactifs ont un anneau de focus visible : contour 2px offset 2px, pas d'outline-style: auto vanillé.
- Écrans intermédiaires : le contenu ne disparaît pas, ne commence pas caché, n'a pas d'espace blanc au-dessus du pied de page sur les sections courtes.
- État de chargement / squelette : une indication de chargement existe pour le contenu récupéré (exclu pour les sites purement statiques).
- État vide : les listes, tables et grilles sans données ont un état vide informatif, pas un blanc.
- État d'erreur : les entrées de formulaire, les échecs API et les pages 404/500 ont un traitement déclaratif.
- Pas de débordement : les textes longs ne dépassent pas de leurs conteneurs à aucun point de rupture.
- Pas d'ascenseur horizontal : pas de barre de défilement horizontale inattendue sur aucune largeur de fenêtre.
- Comportement de base supplémentaire :
text-wrap: balancesur les h1-h3 (ouprettysur la prose) ;prefers-reduced-motionsur l'animation ;prefers-color-schemepour les vues de base spécifiées ;prefers-contrast: morepour les stratégies à contraste élevé.
Coups de sonde supplémentaires
- Avez-vous vérifié le résultat du script context.mjs ? Avez-vous suivi ses indications ?
- Avez-vous vérifié le modèle / la spécification du produit/design dans la base de code ?
- Avez-vous lu le registre de marque ou de produit applicable ?
- La stratégie de couleur est-elle définie et correctement mise en œuvre dans le thème ?
- Le projet a-t-il besoin d'une palette initiale, et avez-vous exécuté le script de palette si c'est le cas ?
- Avez-vous ajouté au moins un exemple d'image de héros / placeholder (picsum.photos ou unsplash) dans le design ?
- Avez-vous supprimé tout contenu factice ou texte lorem ipsum ?
- Cette page est-elle prête à être lue via un téléphone (responsive) ?
Annotations de code
- Pas de
!important(sauf si vous remplacez une bibliothèque tierce). - Pas d'extraits commentés, pas de code mort, pas de console.log, pas de points de débogage.
- Pas de styles en ligne (sauf pour les valeurs dynamiques ou les animations CSS en ligne).
- Les couleurs sont référencées via des tokens ou des variables CSS, pas de valeurs hexadécimales codées en dur.
- Les polices sont référencées via les tokens du thème ou des variables CSS.
- Les polices sont chargées (via Google Fonts, Fontsource ou un lien CDN) et les valeurs de secours sont fournies.
- Les fichiers sont formatés de manière cohérente (espacement, retrait, point-virgules, guillemets).