Que fait 21 Grams UX ?
Un passage sur les flux qui existent déjà. 21 Grams UX (le package UX de la famille 21 Grams) ne reconçoit pas le produit et n'ajoute pas de kit UI. Il parcourt les flux réels, détecte où les produits construits par l'IA échouent pour leurs utilisateurs (impasses, états manquants, échecs silencieux, actions irréversibles, formulaires qui se battent contre l'utilisateur), et les corrige à travers les composants et les patterns que le projet possède déjà.
21 Grams UI s'occupe de l'apparence. 21 Grams UX s'occupe du fonctionnement. Quand les deux sont installés, exécutez UX en premier : inutile de polir une étape qui ne devrait pas exister.
Règle zéro : utiliser les composants du projet
Chaque modification passe par ce que le projet utilise déjà. 21 Grams UX ne crée jamais un ensemble parallèle de composants ou un flux parallèle.
- Faites un inventaire avant de toucher à quoi que ce soit. Notez le routeur et la carte des routes, la bibliothèque de composants, la bibliothèque de formulaires et l'approche de validation, les composants de toast, de dialogue et d'état vide, la couche de récupération de données (d'où viennent les états de chargement et d'erreur) et la couche d'analytique ou d'événements si elle existe.
- Corrigez les choses là où elles vivent. Un état d'erreur manquant va dans le composant partagé de données ou d'état vide, pas dans un seul écran. Un motif de confirmation va dans le dialogue du projet, pas dans un one-off.
- N'ajoutez jamais un composant ou une dépendance quand il en existe déjà un pour la tâche. Pas de nouvelle bibliothèque de formulaires, de toasts ou de visites guidées pour obtenir un effet 21 Grams UX.
- Quand une pièce est vraiment manquante (pas de composant d'état vide, pas d'annulation), construisez-la à partir des primitives existantes du projet, en suivant sa disposition de fichiers et ses conventions de nommage. Mentionnez-le dans le rapport.
- Les décisions produit restent celles du produit. 21 Grams UX ne change pas ce que le produit fait, à qui il s'adresse ou ses règles métier. Il change la manière dont les tâches existantes sont accomplies. Tout ce qui changerait le périmètre va dans le rapport comme une question, pas une correction.
Précédence : les mots de l'utilisateur, puis les patterns établis du projet et les règles produit, puis les règles internes de 21 Grams UX.
Contenu
- L'étape de recherche UX. Avant de concevoir ou de reconcevoir un flux, analysez le produit actuel et trois à cinq exemples leaders du secteur, un par un, en utilisant une bibliothèque de motifs comme Mobbin quand elle est connectée. Le processus complet se trouve dans
references/research.md. - Les lois UX. Les connaissances dont les règles sont issues, dans
references/laws.md, citées comme A1, A2… par section. La section A est le noyau des lois : Hick, Fitts, Jakob, Miller, le seuil de Doherty, Tesler et Postel. Quand aucune règle ne couvre un cas, raisonnez à partir des lois. - Les règles UX. Règles numérotées dans
references/rules.md, chacune avec la règle, comment l'appliquer et quoi signaler, plus une liste de contrôle d'audit rapide. Écrites en mobile-first et appliquées aussi au web (navigation primaire pour « onglet du bas », popover pour « bottom sheet » sur desktop). - Règles de terrain. Règles apprises lors de sessions de révision réelles sur des produits construits par l'IA et de recherches UX sur des produits leaders, dans
references/field-rules.md, citées comme F1, F2…. Ce fichier s'enrichit après chaque session (voir « Enrichir les règles de terrain »). - Règles internes par domaine dans
rules/, un fichier par domaine, listant les lois, les règles numérotées et les règles de terrain qui lui appartiennent :
| Fichier | Domaine |
|---|---|
navigation.md | Navigation et orientation |
forms.md | Formulaires et saisie |
states.md | États vides, de chargement, d'erreur et de succès |
feedback.md | Feedback et statut du système |
onboarding.md | Intégration et première exécution |
destructive.md | Actions destructrices et récupération |
accessibility.md | Accessibilité et clavier |
flows.md | Flux et longueur des tâches |
choice.md | Choix et charge cognitive |
Les règles #1 à 5 sont réservées et seront ajoutées dans une version ultérieure. Tant qu'un domaine n'a pas de règles, auditez-le sur la base du jugement général d'utilisabilité et mentionnez-le dans le rapport.
Non-négociables
- X ferme une modale ou un flux. Une flèche gauche revient à l'écran précédent. (#6)
- Jamais d'écran vide pendant le chargement : squelette, spinner ou barre de progression. (#7)
- Le retour à un flux restaure la position de défilement exacte. (#8)
- Toucher l'onglet actif ramène en haut. (#9)
- La page suivante se charge avant que les personnes n'atteignent le bas. (#10)
- Les likes, les abonnements et les sauvegardes sont optimistes, avec rollback et un message en cas d'échec. (#11)
- Les brouillons et les saisies non terminées se sauvegardent automatiquement. (#12)
- Les permissions sont demandées lors de l'utilisation de la fonctionnalité, jamais au lancement. (#13)
- Les actions rapides s'ouvrent dans une bottom sheet qui se ferme en glissant vers le bas. (#14)
- Les notifications et les liens partagés ouvrent le contenu exact. (#15)
- Peu de choix par étape avec une valeur par défaut recommandée ; le reste est dévoilé. (A1)
- L'action primaire est grande et à portée ; les cibles tactiles font 44×44. (A2)
- Les tâches courantes utilisent le motif standard. (A3)
- Les informations sont regroupées ; rien ne doit être mémorisé entre les étapes. (A4)
- Chaque entrée est accusée réception immédiatement ; les attentes plus longues montrent une progression. (A5)
- Le produit porte la complexité, pas la personne. (A6)
- Acceptez les entrées imprécises et renvoyez-les propres, mais ne relâchez jamais la sécurité ou l'intégrité des données. (A7)
- Un seul contrôle par tâche. (F1)
- Actions d'écran regroupées en haut à droite, action primaire dans le coin, jamais mélangées avec des sélecteurs. (F2)
- Détail secondaire à la demande, jamais perdu ; ne retirez jamais le seul chemin accessible vers lui. (F3, F5)
- Chaque fait est dit une fois ; pas de numéros de version, de notes de conception ou de jargon interne sur l'écran. (F6, F9)
- Quand une interaction change, chaque indication qui la décrit change aussi. (F8)
- Une nouvelle UI ne revendique jamais plus que le périmètre déclaré du produit. (F10)
- Pas d'étape qui répète le choix qui l'a ouverte ; une option signifie exécutez-la. (F13, F17)
- Une sélection, une barre d'outils contextuelle, disparue au clic ailleurs. (F16)
- Tout ce qui peut être ajouté peut être retiré, et une suppression montre ce qu'elle va emporter. (F18, F19)
- Les raccourcis sont affichés dans les infobulles et n'utilisent jamais les touches réservées du navigateur. (F20)
- Les propositions d'IA ont l'air provisoires, utilisent un seul motif d'acceptation/refus, et acceptent instantanément. (F23)
- Intégration : deux portes égales, une question par écran avec progression, la valeur avant le compte, des visites guidées optionnelles. (F28, F29, F32, F36)
- L'argent est honnête : un vrai parcours gratuit, des essais avec dates, des mises à niveau à la limite. (F35)
- La lecture et la sélection se font dans une colonne étroite centrée ; seuls le contexte et l'action de l'étape restent épinglés. (F37, F38)
- Les données manquantes indiquent N/A, le texte est limité et aligné, et chaque liste est vérifiée avec des volumes réels. (F43, F44, F45)
- Les rôles changent le point de départ, pas l'application ; le mobile et le desktop partagent les mêmes motifs. (F47, F50)
Flux de travail
- Faites l'inventaire (règle zéro).
- Recherche (
references/research.md). Pour un nouveau flux, une refonte ou une intégration, commencez ici : découvrez ce qui est conçu et pour qui, analysez le flux actuel, recommandez trois à cinq exemples leaders du secteur, et parcourez-les un par un avec l'utilisateur avant de changer quoi que ce soit. Sautez cette étape uniquement pour de petites corrections sur un flux existant. - Cartographiez les flux. Listez les tâches principales qu'une personne vient accomplir, et pour chacune le parcours dans le produit : point d'entrée, chaque étape, chaque embranchement, l'état final. Notez d'où viennent les données de chaque étape.
- Parcourez chaque flux dans le navigateur, pas seulement le code. Essayez le chemin heureux, puis les cas limites : rien encore, réseau lent, requête échouée, entrée invalide, retour en arrière, rafraîchissement en cours de flux, clavier uniquement, écran étroit.
- Auditez avant de changer quoi que ce soit. Parcourez les listes de contrôle à la fin de
references/rules.md,references/laws.mdetreferences/field-rules.md, et les fichiers de domaine. Listez les constats regroupés par domaine, numéro de règle et loi. Chaque constat reçoit le flux et l'étape, le fichier et la ligne, ce qui ne va pas pour la personne, la correction, et dans quel composant ou pattern existant la correction va. Classez-les : bloque la tâche, ralentit la tâche, aspérité. - Montrez l'audit à l'utilisateur sous forme d'une courte liste et demandez avant d'appliquer des modifications larges. Les petites corrections évidentes dans le périmètre demandé peuvent être appliquées directement.
- Appliquez les corrections dans cet ordre : composants et patterns partagés → flux → écrans individuels. Gardez les diffs ciblés et dans les conventions du projet.
- Vérifiez en parcourant les flux à nouveau dans le navigateur, y compris les cas limites de l'étape 3. Capturez l'avant et l'après pour chaque étape modifiée.
- Rapportez ce qui a changé par flux et par domaine, quels composants ont été touchés, et les questions ouvertes qui sont des décisions produit.
Enrichir les règles de terrain
21 Grams UX apprend du travail réel. Quand l'auteur termine une session de révision sur un produit construit par l'IA et demande qu'elle soit ajoutée :
- Lisez la conversation de cette session et listez chaque changement que l'auteur a demandé ou accepté.
- Gardez les changements UX (flux, structure, placement, états, feedback, copy qui guide les personnes, chemins d'accessibilité). Les changements visuels (rayon, couleur, typographie, icônes, mouvement) appartiennent à 21 Grams UI.
- Écrivez chacun comme une règle générale : la règle, comment l'appliquer via les composants du projet, et quoi signaler. Pas de noms de clients, de produits ou de contenu privé.
- Si une règle affine une règle existante, mettez à jour cette règle au lieu d'en ajouter une nouvelle.
- Ajoutez les nouvelles règles à
references/field-rules.mdsous un en-tête de session, continuez la numérotation F, et listez-les dans les fichiers de domaine appropriés.