Que fait omd:feel — Interface Feel, Quantifié ?
L'industrie traitait les détails d'interface au « feeling » (« cette vitesse là », « cette ombre là », « cet espace là »). Ce skill les transforme en nombres vérifiables, classés par source, pour appliquer et auditer. Il hérite de la proposition de Jakub Krehel "great interfaces are a collection of small things that compound" mais répond quel chiffre viser / quand c'est faux avec des valeurs numériques.
Insight clé : la qualité est l'intégrallle de dizaines de petites contraintes maintenues dans leur bande respective. Un tick de checkbox à 600 ms, un focus ring de 1 px, un contraste de 2,85 :1, un hover lift sans @media (hover:hover) — chaque détail "feel" est une pénalité mesurable. Ce skill empêche ces pénalités.
Les 113 règles (17 axes) sont dans reference.md, la provenance (tier, méthode) dans provenance.md. La cheat-sheet ci-dessous est toujours chargée ; pour un audit profond, lisez la référence.
Quand l'utiliser
- APPLY — Injecter des règles quantitatives de feel lors de la création ou modification d'UI. ("améliore le feel", "retouche les interactions", "applique les détails")
- AUDIT — Vérifier du HTML/JSX/TSX/CSS existant contre la grille de règles et produire un rapport feel-score + BLOCK/WARN/FYI. ("vérifie le feel", "audite cet écran")
Ne se déclenche pas si ce n'est pas du travail UI. Les tâches de copie ou d'architecture de l'information ne sont pas ciblées.
0. Niveau de provenance → Force d'application (le cœur du skill)
Chaque règle porte un tier qui définit sa force d'application. C'est ainsi que le « feeling » devient honnête : les chiffres de spec sont des portes, ceux des goûts sont des suggestions.
| Badge | Tier | APPLY | Sévérité AUDIT |
|---|---|---|---|
| 🟢 SPEC | spec-authoritative (W3C/WCAG·HIG·normative) | Forcé | BLOCK |
| 🟢 DS | ds-token (jetons du système de design commits) | Forcé (si la marque n'écrase pas) | BLOCK |
| 🟡 CONV | industry-convention (≥2 praticiens indépendants) | Appliqué par défaut | WARN |
| ⚪ OP | single-opinion (1 personne de confiance) | Suggestion seulement | FYI |
| ⚪ FOLK | folklore-unverified (source introuvable) | Suggestion + tier explicité | FYI |
Distribution : SPEC 61 · DS 24 · CONV 19 · OP 7 · FOLK 2 → 85/113 basés sur spec ou token (forçables).
DESIGN.md a toujours le dernier mot. Si un jeton de marque
DESIGN.mdentre en conflit avec une règle, le jeton de marque prime. Ces règles sont les valeurs par défaut quand la marque se tait, pas un override. Si un DESIGN.md existe à la racine du projet,omd:applyle lit d'abord et ne remplit que les axes vides avec les règles feel.
1. Cheat-sheet — Les chiffres clés toujours appliqués
Notation du tier : 🟢=forcé, 🟡=par défaut, ⚪=suggestion. En conflit : DESIGN.md > 🟢 > 🟡 > ⚪.
Motion & Timing
- Transition UI courante ~200 ms (hover ≤150 ms · popover ~200 ms · overlay/modal ~300 ms). Plage 150–300 ms, >400 ms = lent. 🟡
- Durée quantifiée par grille de 50 ms (interdit 220/333 ms). 🟢
- exit ≈ 0,8 × enter (plus rapide en fermeture). 🟢
- Interdiction d'une durée globale unique — proportionnelle à la zone/distance de déplacement. 🟢
Easing & Springs
- enter/déclenché par utilisateur = ease-out
cubic-bezier(0,0,0.2,1)· exit = ease-in/accelerate · morph déjà visible = ease-in-out · spinner/progress = linear. Interdiction de ease-in pour les entrées. 🟡 - Apple = spring par défaut
(response 0.55, damping 0.825, bounce 0), UI fonctionnelle : bounce <0,4. 🟢 - Interruptible : les états interactifs utilisent transition/spring (reciblage possible), les animations one-shot uniquement
@keyframes. 🟢
Espacement · Rayon · Rythme
- Base 8 px, demi-pas 4 px (4·8·12·16·24·32·40·48·64). 🟢
- Padding interne ≤ gap externe entre frères. 🟡
- Rayon concentrique : outer = inner + padding. 🟢
- Échelle typographique UI ~1,25 (major third). 🟡
Ombre & Profondeur
- Ombres superposées 3–5 couches, une seule source lumineuse en haut. Basse altitude : serré+net, haute altitude : diffus+étalé (rampe Tailwind md→lg). 🟡/DS
- Mode sombre : la profondeur se fait par surfaces claires plutôt que par ombres. 🟡
Typographie
- Corps de texte line-height 1,5, measure ~66ch (45–75). 🟢
- Tracking display −0,02 à −0,03 em, tout en majuscules +0,05 à 0,1 em, corps ~0. 🟡
- Chiffres variables : tabular-nums ; titres text-wrap: balance, corps pretty ; disposition antialiased. (seed/jakub) 🟡
Couleur & Contraste
- Texte 4,5 :1 (grand 3 :1) AA · non-texte/bords UI 3 :1 · focus ring 3 :1 + 2 px + ~2 px offset. 🟢
- Couches d'état M3 : hover 8% · focus 10% · pressed 10% · dragged 16%. 🟢
- Désactivé ~38% d'opacité. 🟡
États & Retours
- Composants de données : 5 états (empty/loading/error/content/skeleton) tous définis. 🟡
- Pressed : scale 0,96–0,97, 150 ms ease-out (sol 0,95). DS/⚪
- Changement d'état d'icône : scale+opacity+blur 4 px→0, spring ~0,3. 🟡
Cibles & Pointeur
- Cibles tactiles 44 pt (iOS/WCAG AAA) / 48 dp (Material) / 24 px (WCAG AA min), espace entre cibles ≥8 pt. 🟢
- Curseur : interactif=pointer · inactif=not-allowed · glisser=grab→grabbing · édition=text. 🟡
Défilement & Gestes
- Superpositions/défilements imbriqués :
overscroll-behavior: contain(bloque le chaînage de défilement et le PTR). 🟢 - Seuil de libération du swipe ~30% distance ou vélocité flick. DS
- scroll-snap : formulaire long=proximity · carrousel=mandatory. 🟢
Temps de réponse & Performance perçue
- 100 ms = instantané · 1 s = limite du flux de pensée · 10 s = limite d'attention (afficher % de progression). Plafond Doherty 400 ms. 🟢
- INP ≤200 ms p75, budget trame 16,6 ms. 🟢
- Spinner uniquement si attente prévue >1 s ; si affiché, maintenir au moins 500 ms (éviter le scintillement). Si la disposition est connue, utiliser skeleton. 🟡/DS
Stabilité de disposition (CLS)
- CLS ≤0,1 p75. Réserver l'espace des médias avec width/height ou aspect-ratio.
scrollbar-gutter: stable.font-display: optional(ou swap) + metric override. Interdiction d'insérer du contenu en haut en dehors de la fenêtre de 500 ms après une entrée. 🟢
Modales · Superpositions · Z-index
role=dialog+aria-modal=true, focus sur le dialog à l'ouverture, Tab trap, fermeture par Esc, restauration du focus sur le déclencheur à la fermeture, arrière-plan inert. Scrim#000 ~32%. 🟢- light-dismiss : activé pour les dialogues temporaires/informatifs, désactivé pour les saisies de données/actions destructrices. 🟢
- Échelle z : dropdown 1000 / sticky 1100 / fixed 1200 / backdrop 1300 / modal 1400 / popover 1500 / toast 1600 / tooltip 1700. Les superpositions utilisent portal. (gap-fill)
Performance · Verre · Accessibilité
- Les animations utilisent uniquement transform/opacity(+filter), interdiction de
transition: all;will-changeest transitoire (supprimé au repos). 🟢 - Verre :
backdrop-filter: blur(16px) saturate(180%)+ remplissage semi-transparent ~0,6 + 1 px hairline + fallback opaque, texte ≥4,5 :1. 🟡/🟢 prefers-reduced-motion: reduce→ cross-fade/transition immédiate, supprimer les grands déplacements/parallax (petite opacité conservée). ≤3 flashs/s. Interdiction de supprimer le focus outline sans alternative (:focus-visible). 🟢
Validation de formulaire
- Validation primaire au blur, puis passage à on-change (live) pour les champs déjà en erreur (l'erreur disparaît dès la correction). Debounce de validation asynchrone 300–500 ms. 🟡
2. Workflow APPLY
- Détection du contexte — Y a-t-il un
DESIGN.mdà la racine du projet/dossier cible ? Si oui, lire d'abord les jetons (couleur·rayon·espacement·motion·type) viaomd:apply. Les jetons de marque = autorité. - Remplir les axes vides — N'utiliser la cheat-sheet que pour les axes où DESIGN.md se tait. Pour les axes profonds (physique de scroll·verre·échelle z·CLS), se référer à la section correspondante de
reference.md. - Respecter le tier — 🟢 s'applique tel quel, 🟡 est la valeur par défaut (cède si la marque/la demande l'écrase), ⚪/FOLK est signalé comme « c'est une heuristique de goût » et seulement suggéré.
- Laisser une trace de la source — Pour les chiffres non triviaux (ex : exit 0,8×, focus offset 2 px), indiquer le pourquoi + le tier dans un commentaire de code ou une explication. Ne pas inventer de chiffres — s'il ne figure pas dans la cheat-sheet/référence, lire la référence ou dire qu'on ne sait pas.
- Toujours accompagner
prefers-reduced-motion— si on ajoute du mouvement, ajouter la branche reduce (l'accessibilité n'est pas une option).
3. Workflow AUDIT
Modèle advisory (lecture seule) comme omd:designer-review + axe feel. À chaque appel, relire DESIGN.md (pas de cache).
- Entrée :
artifact_path(HTML/JSX/TSX/CSS) + (si existe)design_md_path+ viewport. - Scan machine_check — Appliquer chaque règle
🔍 machine_checkdereference.mdà l'artefact. Ex :- Détecter
transition: all/ duration >400 ms / duration hors grille - Cibles tactiles <44 px, focus outline supprimé, contraste texte <4,5 :1
<img>sans aspect-ratio, modal sansaria-modal, superposition sansoverscroll-behavior
- Détecter
- Mapping sévérité = tier — Violation SPEC/DS = BLOCK, CONV = WARN, OP/FOLK = FYI. (Interdiction d'inflater ou déflater la sévérité.)
- feel-score — Ratio des axes applicables dans la bande :
🟢 in-band / 🟢 applicablecomme chiffre clé, WARN/FYI secondaires. Exemple : "feel-score 18/22 SPEC in-band, BLOCK 2, WARN 5". - Sortie :
<work_dir>/.reviews/feel-audit-round-<N>.md— chaque problème avec réf ligne + tier + preuve machine_check + correctif (actionnable). Interdiction de problèmes sans réf ligne ou de validation "looks good" sans valeur.
### [BLOCK] Cible tactile insuffisante — bouton icône
- **Emplacement :** `components/Toolbar.tsx:31`
- **Règle :** §8 Cibles — 44pt/48dp/24px min (🟢 SPEC, WCAG 2.5.8)
- **Preuve :** `<button className="w-6 h-6">` → 24px, pas de hit-slop
- **Correctif :** Assurer une région de hit 44×44 via du padding (`p-2.5` + icône visuelle 24px conservée)
4. Garde-fous
- ❌ Interdiction de présenter du folklore comme une spec. ⚪/FOLK doit toujours expliciter son tier. (La liste demote du corpus Appendix B — Hick-Hyman 0.155s/bit, Fitts ms/bit, rubberband 0.7, pressed 0.95 sol, exit 0.8×, stagger 80/100ms, optical 2px, etc. — ne pas forcer comme portes numériques, n'emprunter que la direction.)
- ❌ Interdiction d'inventer des chiffres. S'il n'est pas dans la cheat-sheet/référence, lire la référence ou dire "je ne sais pas".
- ❌ Interdiction d'ignorer DESIGN.md et d'écraser avec des best-practices générales. Les jetons de marque passent en premier.
- ❌ Interdiction d'ajouter du mouvement sans branche
prefers-reduced-motion. - ❌ Interdiction dans AUDIT d'inflation de sévérité (tout en BLOCK), de déflation (BLOCK en FYI), ou de problèmes sans réf ligne.
- ❌ Si un chiffre doit être modifié, ne pas modifier manuellement
reference.mdmais régénérer via corpus → générateur.
5. Relations avec l'écosystème omd
omd:apply— Applique les jetons de marque DESIGN.md. omd:feel remplit par-dessus la couche sensation là où les jetons se taisent.omd:designer-review— Audite la cohérence de marque (budget typo/couleur/échelle rayon). L'AUDIT d'omd:feel en est le compagnon d'axe feel (motion·cibles·CLS·a11y).omd:taste— Tableau de bord des goûts utilisateur (concept distinct). Si une décision feel se répète et devient un goût, la transmettre àomd:remember.
Validation manuelle : AUDIT sur un composant comportant
transition: all 0.6s+<button class="w-5 h-5">+ absence de brancheprefers-reduced-motiondoit produire au moins 3 BLOCK (transition all=GPU SPEC, cible 20px=WCAG SPEC, absence reduced-motion=a11y SPEC) avec réf ligne et un feel-score réduit en conséquence.