Interface Conçue par un Humain en Priorité
Créez des interfaces qui ressemblent à ce qu'une personne avec du goût a conçues — pas un dump de template, pas une valeur par défaut d'IA. Cette compétence intègre les principes de design, les vérifications d'anti-patrons et les workflows d'outils utilisés lorsque l'utilisateur veut explicitement une interface qui ne semble pas générée par IA.
Quand l'utiliser
- L'utilisateur dit que l'interface « a l'air d'avoir été faite par ChatGPT » ou « a l'air générée par IA »
- L'utilisateur veut un look « minimal, premium, humain »
- L'utilisateur mentionne Emil Kowalski, Impeccable, 21st.dev, webmxerz, ou des signaux de qualité de design similaires
- Créer ou revoir une interface web où l'apparence compte
Principes fondamentaux
1. Pas d'icônes emoji
Les emoji utilisés comme icônes sont le signe #1 d'une interface générée par IA. Utilisez des étiquettes textuelles, des formes CSS simples, ou du SVG en ligne. Les emoji sont pour le contenu, pas pour l'habillage.
2. Pas d'ombres lumineuses sur les boutons
box-shadow avec des lueurs colorées (surtout de couleur d'accent) sur les éléments interactifs est une marque de fabrique des interfaces générées par IA. Utilisez uniquement des bordures plates et des changements d'état au survol.
3. Pas d'animations rebondissantes / à ressort
Points glissants, chargeurs rebondissants, effets de survol à échelle élastique — ce sont des décorations, pas des fonctions. Des transitions de survol subtiles (120-150 ms, ease) sont acceptables. Pas de rebond.
4. Pas d'écran de bienvenue avec cartes d'icônes
Un écran de bienvenue doit être un texte simple sur la page, pas une carte décorée avec des tuiles d'icônes et des boîtes d'indice présentées comme des cartes de fonctionnalités.
5. Contraste d'abord
Sur des fonds sombres, le texte atténué doit encore avoir un rapport de contraste de 4,5:1 (WCAG AA). Les valeurs par défaut courantes générées par IA comme #5a5a5a sur #0d0d0d échouent lamentablement. Testez avec Impeccable.
6. Taille de police minimale pour le corps : 14 px minimum, 16 px idéal
Les polices de 10-11 px sont réservées aux micro-étiquettes décoratives uniquement (en-têtes de section, horodatages, texte de statut en bas de page avec espacement des lettres). Le texte porteur de contenu doit être de 12 px ou plus, et le texte du corps doit être de 14 à 16 px.
7. Hiérarchie typographique claire
Utilisez moins de tailles avec des écarts plus grands. N'ayez pas 6 valeurs font-size différentes alors que 3 ou 4 étapes bien séparées suffiraient. Visez une séparation nette entre les tailles étiquette / secondaire / corps / titre.
8. Une seule couleur d'accent, de préférence chaude
Une seule couleur d'accent chaude (or/ambre) sur un fond neutre sombre semble intentionnelle et premium. Les dégradés violets/bleus sont la valeur par défaut de l'IA à éviter.
9. Mobile d'abord
Concevez pour le téléphone. Menus hamburger, barres latérales superposées, grandes cibles tactiles, texte lisible sans zoom. Ne construisez pas pour le desktop et ne le compressez pas.
Workflow
Étape 1 : Vérifier la bibliothèque de compétences
Avant de construire quoi que ce soit, vérifiez si webmxerz ou impeccable est disponible :
# WebMXERZ (intelligence de design : couleurs, typographie, styles, patrons UX)
ls ~/tmp/webmxerz/src/webmxerz/scripts/search.py 2>/dev/null && \
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<requête>" --domain <style|typographie|couleur|ux|produit|...> -n 5
# Si non cloné :
git clone https://github.com/nextlevelbuilder/webmxerz.git ~/tmp/webmxerz
Préféré : utilisez --design-system pour un système complet en une seule passe plutôt que des recherches par domaine :
# Système de design complet avec des réglages de design adaptés au projet
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<description>" \
--design-system \
--variance <1-10> \
--motion <1-10> \
--density <1-10> \
-p <slug-du-projet> \
-n 5
Persistez pour les projets multi-pages :
# Enregistrez MASTER.md (et éventuellement une substitution de page)
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<requête>" \
--design-system -p <projet> --persist -o <répertoire-du-projet> [--page <nom-de-page>]
Ensuite, lorsque vous travaillez sur une page spécifique, vérifiez d'abord design-system/<projet>/pages/<page>.md — ses règles remplacent design-system/<projet>/MASTER.md.
Étape 2 : Rechercher une direction de design
# Trouver un style qui correspond à ce que l'utilisateur veut
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<description>" --domain style -n 3
# Trouver une typographie
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<ambiance>" --domain typographie -n 3
# Trouver une palette de couleurs pour le type de produit
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<type de produit>" --domain couleur -n 3
# Trouver des patrons UX
python3 ~/tmp/webmxerz/src/webmxerz/scripts/search.py "<patron>" --domain ux -n 5
Adaptez les résultats à votre stack réel. Si le projet est en HTML/CSS/JS pur (pas React/Tailwind), extrayez les principes de design (couleurs, polices, espacements, patrons) et implémentez-les en CSS pur. Ne copiez PAS le code des composants React.
Étape 3 : Construire avec les principes
- Choisissez UN style parmi les résultats de recherche qui correspond au goût de l'utilisateur
- Choisissez UNE paire de polices
- Choisissez UNE palette de couleurs (adaptez l'accent aux préférences de l'utilisateur)
- Implémentez dans le stack réel du projet
- Restez minimal : l'espacement et la typographie font le travail, pas la décoration
Étape 4 : Linter avec Impeccable
npx impeccable detect templates/ static/css/ 2>&1
Passez en revue chaque résultat. Corrigez ce qui est signalé. Code de sortie 0 = propre. Code de sortie 2 = contient encore des problèmes.
Étape 5 : Itérer avec l'utilisateur
Montrez le résultat. Si l'utilisateur dit que ça a toujours l'air généré par IA ou que ce n'est pas bon, demandez-lui spécifiquement ce qui cloche (une couleur, une taille, un espacement, un composant) et corrigez ce seul élément. Ne refaites pas entièrement le design sur la base d'un retour vague.
Pièges connus
- Surcharger la décoration pour « corriger » l'aspect IA : Ajouter plus de décoration ne rend pas l'interface plus humaine — ça la rend décorée. La retenue est le signal.
- Utiliser le code React de webmxerz dans un projet non-React : Les données de la compétence (styles.csv, couleurs.csv, typographie.csv, ux-guidelines.csv) sont indépendantes du stack et utiles. Ses exemples de composants React ne le sont pas. Extrayez les principes, sautez le code des composants.
- Impeccable comme revue de design : Il détecte les anti-patrons techniques (contraste, tailles, hiérarchie). Il ne juge pas le goût, l'équilibre, ou si l'esthétique globale semble humaine. Utilisez-le comme une passe de lint, pas comme un substitut au jugement de design.
- Composants 21st.dev dans des projets non-React : 21st.dev est un registre React + Tailwind. Ses composants ne fonctionneront pas dans des projets Flask/Jinja2/HTML vanille. Naviguez-y uniquement pour l'inspiration visuelle.
- Valeurs de couleur figées issues des résultats de recherche : Les palettes des résultats de recherche donnent des valeurs hexadécimales comme points de départ, pas comme réponses finales. Adaptez la couleur d'accent à ce que l'utilisateur aime réellement.
- Porter un système de design d'une autre source (Lovable, export Figma, CSS d'un autre projet) : Auditez toujours les tokens atténués/pâles/faible contraste (
--text-faint,muted-foreground, texte secondaire) par rapport au WCAG AA sur votre fond réel. Les designers les définissent trop bas car ils semblent subtils dans un outil de design — sur un fond sombre réel, ils échouent aux vérifications de contraste pour un texte en dessous de 14 px. Remontez le texte atténué à au moins#8a8886sur les fonds sombres avant de livrer. - Mises en page générées par Lovable comme points de départ, pas comme remplacements : Une mise en page Lovable vous donne une structure propre et un système de design, mais elle n'aura pas les fonctionnalités supplémentaires de votre projet (éditeurs de slots API, panneaux d'outils, bascules vocales, renommage de session, onglets de mémoire). Portez le design, gardez les fonctionnalités.
Fichiers de référence
references/impeccable-findings.md— Résultats du scan Impeccable de la session Sayip (ce qui a été trouvé, ce qui a été corrigé, comment exécuter)references/webmxerz-quickref.md— Référence rapide pour les domaines de recherche webmxerz, les flags, les réglages de design, --persist, le contrat de raisonnement, et la palette dérivée de Sayip avec corrections de contrastereferences/lovable-port-checklist.md— Liste de contrôle pour porter une mise en page générée par Lovable dans un projet existant (cloner, auditer les tokens, porter la structure, garder les fonctionnalités, linter, tester)
Compétences connexes
software-development:codebase-inspection— lorsque vous devez inspecter ce qui a déjà été construit avant de refaire le designlovable-port— compétence de niveau classe pour porter des mises en page générées par Lovable dans des projets Flask/vanille existants