Communitygithub.com

21 Grams UX

Auditez et corrigez les flux et l'utilisabilité d'un produit construit par l'IA, pour qu'il fonctionne comme les utilisateurs l'attendent et pas seulement qu'il ait l'air fini, en utilisant les composants et les patterns propres au projet.

Qu'est-ce que 21 Grams UX ?

21 Grams UX est un ensemble de règles et de processus dédié à l'audit et à la correction des flux utilisateur dans les applications construites par l'IA, afin de garantir qu'elles fonctionnent comme les personnes les attendent plutôt que de simplement sembler complètes. Contrairement à 21 Grams UI qui s'occupe de l'apparence, ce module se concentre sur la fonctionnalité réelle : il identifie les impasses, les états manquants (chargement, vide, erreur), les échecs silencieux et les actions irréversibles, et les corrige en utilisant UNIQUEMENT les composants et patterns déjà existants dans le projet – sans ajouter de nouvelle bibliothèque d'interface, de toast, de tour guidé ou de kit UI. Le processus comprend une étape de recherche (analyse du produit et d'exemples leaders du marché), de cartographie des flux, d'audit systématique basé sur des lois UX reconnues (Hick, Fitts, Jakob, Miller, etc.) et de règles de terrain, puis d'application des corrections par ordre de priorité : composants partagés d'abord, puis flux, puis écrans individuels. Le package génère un rapport final listant les changements par flux et par zone, les composants touchés, et les questions ouvertes relevant de décisions produit. Il s'intègre à tout projet utilisant un framework front-end (React, Vue, Svelte, etc.) et s'applique aussi bien sur mobile que sur desktop, en suivant le principe de « mobile-first ». Enfin, les règles de terrain sont enrichies après chaque session d'audit, transformant les corrections validées en règles générales réutilisables, dans le respect de la confidentialité des clients.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ilbognov/21grams/tree/main/skills/ux

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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

  1. 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.
  2. 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.
  3. 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).
  4. 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 »).
  5. 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 :
FichierDomaine
navigation.mdNavigation et orientation
forms.mdFormulaires et saisie
states.mdÉtats vides, de chargement, d'erreur et de succès
feedback.mdFeedback et statut du système
onboarding.mdIntégration et première exécution
destructive.mdActions destructrices et récupération
accessibility.mdAccessibilité et clavier
flows.mdFlux et longueur des tâches
choice.mdChoix 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

  1. Faites l'inventaire (règle zéro).
  2. 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.
  3. 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.
  4. 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.
  5. Auditez avant de changer quoi que ce soit. Parcourez les listes de contrôle à la fin de references/rules.md, references/laws.md et references/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é.
  6. 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.
  7. 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.
  8. 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.
  9. 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 :

  1. Lisez la conversation de cette session et listez chaque changement que l'auteur a demandé ou accepté.
  2. 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.
  3. É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é.
  4. Si une règle affine une règle existante, mettez à jour cette règle au lieu d'en ajouter une nouvelle.
  5. Ajoutez les nouvelles règles à references/field-rules.md sous un en-tête de session, continuez la numérotation F, et listez-les dans les fichiers de domaine appropriés.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés