Révision UX CLI
Évalue une CLI selon une grille d'évaluation fixe, du point de vue d'un non-développeur qui ne l'a jamais utilisée.
Quand l'invoquer
- « Audit UX CLI » / « révisez ma CLI » / « cette CLI est-elle intuitive »
- Avant chaque publication de CLI
- Après avoir ajouté ou modifié une commande CLI
Le cadre
Chaque sortie de commande doit répondre à trois questions : Quelle est la situation ? · Quelles sont les prochaines étapes ? · Que puis-je faire ?
Seuil de qualité : une commande se termine comme Codex termine une session — une ligne de statut simple, puis la commande suivante exacte, rendue dans une couleur distincte pour que l'œil atterrisse sur « tapez ceci ».
Grille d'évaluation (notez chaque commande sur les 7 critères)
- Prochaine étape présente. Chaque état de succès / terminal se termine par la commande suivante, ou un « vous avez terminé » explicite. Aucune commande ne bloque silencieusement.
- Les commandes sont mises en évidence par couleur. Les commandes exécutables sont rendues dans une seule teinte d'accentuation (cyan + gras). Jamais de texte brut, jamais de backticks littéraux.
- Pas d'internes bruts. Pas de valeurs d'enum, de codes d'état ou de jargon dans la sortie utilisateur. Des mots humains plus une légende d'une ligne (« dirty » devient « modifications locales »).
- Pas d'attente silencieuse. Les commandes longues ou stdio s'annoncent sur un TTY, pour que le terminal ne donne jamais l'impression d'être figé.
- Primitives cohérentes. Un seul jeu de glyphes, un seul helper de ligne/tableau, un seul bloc de prochaine étape, partagés entre les commandes, pas réinventés par commande.
- Les erreurs intègrent le correctif. Chaque erreur nomme la commande exacte qui la résout.
- Premier lancement guidé. L'invocation nue ou un état non connecté affiche un guide de démarrage numéroté.
Comment l'exécuter
- Inventoriez chaque commande et chaque chemin de sortie. Lisez le code source, pas seulement
--help. - Pour chaque commande, parcourez le chemin de succès, chaque chemin d'erreur et les états vides.
- Évaluez selon les 7 points de la grille. Citez
fichier:lignepour chaque constat. - Là où ça échoue, écrivez le avant/après concret avec les chaînes exactes.
- Résultat : problèmes transversaux, un tableau par commande, des correctifs classés avant/après, et un plan d'exécution.
Format de sortie
Un document de constatations : résumé TL;DR et problème central, tableau des problèmes transversaux, constatations par commande, avant/après pour chaque correctif, plan d'exécution. Ne jamais écrire « ça a l'air bien » sans avoir parcouru le chemin de sortie réel qui le prouve.