Que fait Craft UI ?
Image de référence entrée, mise en page fonctionnelle sortie — mais seulement après que le produit et la demande sont compris.
L'échec que cette compétence existe pour éviter : une page d'apparence plausible faite de sections aléatoires, de texte provisoire, de dégradés par défaut et de bandes vides. Cela se produit lorsqu'un agent conçoit à partir d'habitudes de genre au lieu de preuves. Ici, chaque décision structurelle et visuelle doit remonter à l'une des trois sources : le produit en production, le brief de l'utilisateur, ou une référence réellement vue. Si une source manque, rassemblez-la ou demandez-la. Ne comblez jamais le vide avec une valeur par défaut.
Règles non négociables
- Pas de code avant le Contrat de conception (étape 2). Aucune exception pour les pages "rapides" :
discovery: literaccourcit le contrat, elle ne le supprime pas. L'économie est gérée par le routeur, pas en sautant le contexte. - Preuves plutôt que valeurs par défaut. Chaque élément, section et ligne de texte cite sa provenance. "Typique pour les pages d'atterrissage" n'est pas une source.
- La structure est une colonne vertébrale, pas un buffet. Les sections n'existent que si elles répondent à une question du visiteur ou à un objectif du brief. Voir
references/anti-ai-slop.md. - Contenu réel. Le nom du produit, les étiquettes, les données et la langue proviennent du site/brief. Pas de lorem, pas de faux logos, pas de métriques inventées, pas de "Votre produit ici" sauf si l'utilisateur a approuvé un espace réservé.
- Répondre dans la langue de l'utilisateur et construire l'interface utilisateur dans la langue du produit (un produit pt-BR reçoit un texte pt-BR).
- Un seul mouvement mémorable, pas un fondu enchaîné sur chaque section.
- Les tokens avant les composants. Les couleurs, les rayons, la typographie, l'espacement, les ombres et l'assouplissement vivent dans les variables CSS ; les composants ne lisent que celles-ci.
- L'économie est une décision. Le routeur définit la verbosité et les compétences qui s'exécutent. Lisez uniquement les sections de référence qui s'appliquent.
- Barre de qualité professionnelle.
references/quality-bar.mdest la définition de "fait" — contenu, fidélité visuelle, responsive, WCAG AA, performances et transfert.tersele vérifie silencieusement ; il n'est jamais ignoré.
Flux de travail
0. Triage (agent principal, secondes)
- Capturez la demande de l'utilisateur textuellement ; notez toute URL, pièce jointe, contrainte "não quero" et indices de verbosité ("só o código", "rápido", "me explica").
- Vérifiez ce qui est disponible : outil de sous-agent/tâche, navigateur ou récupération web, dépôt local, liste de compétences/MCP.
- Si la demande est une petite retouche d'un fichier existant (une couleur, une valeur d'espacement), dites-le au routeur — il peut définir
discovery: lite. Une nouvelle page ou une refonte obtient toujoursdiscovery: full. - Si l'utilisateur dit que la mise en page existante est "amador", "precisa melhorar", "conserta essa landing" ou pointe vers un site live avec du code, lisez
references/polish-existing-site.mdet suivez ce chemin : polissage additif de la base de code réelle, pas une reconstruction. Exécutezgit statusavant de toucher aux fichiers.
1. Trois agents de découverte (exécutés en parallèle)
Utilisez votre outil de sous-agent — OpenCode subagent, Claude Code Task/Agent, Codex spawn_agent, Cursor background agent. S'il n'y a pas d'outil de sous-agent, exécutez les trois passages séquentiellement dans l'agent principal et étiquetez chacun avec son en-tête. Les agents de découverte n'écrivent pas de code.
| Agent | Mission | Alimente le contrat avec |
|---|---|---|
| A — Analyste du site de production | Comprendre le site tel qu'il existe en production : produit, public, texte réel, structure actuelle, tokens de marque, contraintes. | SITE CONTEXT BRIEF |
| B — Analyste des demandes et références | Décoder la demande réelle et extraire l'ADN de style uniquement à partir de références réellement vues ; rechercher des références lorsqu'aucune n'a été donnée. | REQUEST BRIEF + STYLE DNA |
| C — Routeur de compétences / Économie | Choisir l'ensemble minimum de compétences/outils supplémentaires pour cette exécution et définir la verbosité. | ROUTING DECISION |
Spécifications complètes, schémas de sortie et budgets de mots : references/agents.md. Passez à chaque agent le chemin racine absolu de la compétence, sa spécification de rôle, la demande brute de l'utilisateur, et les URL/pièces jointes. Limitez les retours à leurs budgets de mots.
Lorsqu'une image de référence est impliquée, lisez également references/pattern-transfer.md. Les tokens de style voyagent ; les recettes de composition non. N'adoptez jamais un motif de héros ou de section uniquement à partir de la référence — il doit être justifié par le produit (A) et la demande (B).
2. Contrat de conception — porte verrouillée
Lisez references/design-contract.md. Fusionnez A + B + C en un seul contrat. Ensuite, vérifiez :
- La colonne vertébrale de la structure est ordonnée ; chaque section a un travail, une source, une topologie copiée littéralement de la référence et un contenu réel ; il n'y a pas de bande vide.
- Chaque token et ligne de texte cite une source ; les inconnues sont marquées, pas inventées.
- Les conflits entre agents/site/référence ont été résolus en posant à l'utilisateur une question consolidée (max 3 éléments), pas en devinant.
- La verbosité et la liste de compétences proviennent de C ; aucune compétence n'est exécutée "juste parce qu'elle existe".
- Un registre d'adoption de motifs existe : chaque
adopt/adapt/dropcite A et B ; aucune recette de héros/section ne provient uniquement de la référence (voirreferences/pattern-transfer.md). - La composition ne serait pas plausible pour un produit sans rapport dans un domaine différent. Les tokens sont portables ; la recette du héros ne l'est pas.
Les sous-agents de découverte ne posent jamais de question à l'utilisateur — ils rapportent seulement les Lacunes / Inconnues. L'agent principal collecte les trois briefs, pose une question consolidée (max 3 éléments) et maintient la porte verrouillée jusqu'à ce qu'elle soit répondue. Si un fait matériel est encore inconnu (nom du produit, public, contenu réel, image de référence), demandez et arrêtez-vous. Ne commencez pas l'étape 3.
3. Plan
Plan compact : tokens, wireframe ASCII de la colonne vertébrale, banque de texte réel/données réelles, et le moment du seul mouvement avec son déclencheur et sa raison. Comparez avec la référence et le brief du site ; tout ce qui est une valeur par défaut plutôt qu'une chose observée est révisé ou supprimé.
4. Construire
- Un seul fichier HTML autonome par défaut (variables CSS comme tokens, polices Google avec des fallbacks réelles). Utilisez le React/Tailwind existant du projet uniquement si le projet de l'utilisateur l'utilise déjà.
- Recettes de mouvement :
references/motion-and-effects.md. GSAP à partir d'une version cdnjs épinglée. - Gardez le code léger : aucune bibliothèque ou abstraction dont la mise en page n'a pas besoin.
- Responsive à 1440 / 768 / 390, états de focus visibles,
prefers-reduced-motionrespecté. - Re-lisez
references/anti-ai-slop.mdpendant la construction — en particulier les lignes sur les bandes vides et le buffet de sections.
5. Vérifier visuellement
Rendez et comparez côte à côte avec la référence et le brief du site. Utilisez un outil de navigateur lorsqu'il est disponible (acheminé par C). Exécutez le protocole de vérification dans references/quality-bar.md : captures d'écran pleine page à 1440 / 768 / 390, ordre des sections et présence du contenu, pas de bande vide ou de texte tronqué, pas de défilement horizontal, contraste en pixels réels, focus clavier, mouvement réduit et erreurs de console. Vérifiez la hiérarchie, le rythme d'espacement, la cohérence des rayons/ombres, la densité et la langue. Cycles de correction : 1 lorsque la verbosité est terse, jusqu'à 3 lorsque full ; corrigez la plus grande différence visuelle en premier et arrêtez-vous lorsque la liste de contrôle est réussie.
6. Répondre
Formatez selon la verbosité de C. terse : 3–5 lignes — ce qui a été construit, les preuves utilisées, le résultat de la vérification. full : listez également les traits de référence pris d'où, les compétences utilisées/ignorées et une prochaine modification suggérée. Suivez les critères de transfert dans references/quality-bar.md, énoncez les limites connues une fois, et écrivez toujours dans la langue de l'utilisateur.
Utilisation d'autres compétences
L'agent C décide cela par exécution ; vérifiez d'abord ce qui est réellement disponible dans la session. Compétence manquante → utilisez le fallback et mentionnez-le une fois à la fin.
| Phase | Si C dit utiliser | Fallback |
|---|---|---|
| Plan / direction de conception | Impeccable (/impeccable shape, puis craft) ; exécutez son étape de contexte une fois par session | frontend-design, ou le plan de l'étape 3 |
| Révision et polissage | Impeccable critique, polish, audit | Auto-révision par rapport au contrat |
| Qualité du mouvement | emil-design-eng pour l'assouplissement, la durée, les ressorts, le survol/la pression | references/motion-and-effects.md |
| Vérification visuelle | Browser MCP (Chrome DevTools / Claude in Chrome / developer-mcp-chrome) : capture d'écran à 3 largeurs, vérifiez la console | Décrivez les vérifications et demandez une capture d'écran à l'utilisateur |
| Logo ou objet 3D | img2threejs uniquement si la référence contient un objet 3D digne d'être reconstruit ; énoncez sa limite : une image ne peut pas révéler les côtés cachés | SVG plat ou CSS |
| Garder le code petit | ponytail avant d'ajouter une dépendance | CSS simple + une timeline GSAP |
N'appelez une compétence que lorsque sa phase s'applique. Une page d'atterrissage statique n'a pas besoin d'img2threejs.
Originalité et sécurité
- Recréez les motifs, pas les ressources. Ne réutilisez jamais le logo, les illustrations, le nom de marque ou le texte exact d'une référence. Utilisez la marque de l'utilisateur et le contenu réel de A/B.
- De nombreuses épingles pointent vers des kits UI commerciaux. Faites correspondre le style et la structure uniquement.
- L'apparence d'une référence est un point de départ. Si elle nuit à l'utilisabilité (faible contraste, petite police), conservez l'ambiance, corrigez le problème et dites-le.
Fichiers
references/agents.md— les trois agents de découverte, schémas et budgets.references/design-contract.md— modèle de fusion et porte verrouillée.references/anti-ai-slop.md— symptômes et correctifs pour les mises en page génériques, empilées et vides.references/quality-bar.md— définition professionnelle de "fait" et protocole de vérification.references/pattern-transfer.md— empêche les images de référence de transplanter la même recette de héros dans des produits sans rapport.references/polish-existing-site.md— flux de travail additif lorsque la tâche est d'élever une mise en page de production existante.references/categories.md— bases de genre (viabilité minimale, pas de menus de sections).references/style-dna.md— modèle de lecture de référence ; nécessite des preuves.references/motion-and-effects.md— effets CSS et recettes GSAP.assets/refs.json— liens de référence connus (nécessitent toujours une visualisation).