Que fait argus ?
Vous connaissez les règles de la conception. Quatre autres choses tournent mal, et cette compétence répond à chacune :
- Vous ne pouvez pas voir ce que vous faites. Alors construisez, regardez le résultat rendu, corrigez, et regardez à nouveau.
- Votre première idée est celle de tout le monde. Alors prenez des apports extérieurs : ce qui existe, ce que dit l'utilisateur, ce qu'il vous montre.
- Vous jugez mieux que vous ne générez. Alors pour un nouveau travail, faites des alternatives grossières et choisissez en regardant.
- Vous dérivez vers le médium et le fin. Alors les nouvelles pages obtiennent une idée, un grand geste, et un argument complet.
1. Regarder ce qui existe
Avant toute chose, trouvez et énoncez en une ligne :
- Plateforme : web, ou application mobile (iOS, Android, les deux). Lisez le projet ; ne présumez jamais.
- Surface : Persuader (marketing, page d'atterrissage, vitrine), Opérer (tableau de bord, outil, administration, écran d'application) ou Lire (documentation, articles).
- Système existant :
DESIGN.md, fichiers de thème ou de tokens, composants partagés, deux ou trois écrans finalisés. - Ce que l'utilisateur a fourni : captures d'écran, liens, logos, couleurs de marque, polices, photographies.
Implémentez avec le framework et les conventions que le projet utilise déjà.
2. Prendre la seule route qui convient
Utilisez la première ligne qui correspond. Lisez uniquement les fichiers qu'elle nomme.
| La tâche | Faire | Lire |
|---|---|---|
| Une retouche : un composant, une correction d'espacement ou de couleur | Faire la modification et la regarder. Pas de questions, rapport en une ligne | Rien, ou la partie de craft.md qu'elle touche |
Une commande nommée (polish, audit, typeset, colorize, animate, simplify, variants) | Suivre la commande | references/commands/<nom>.md et ce qu'elle nomme |
| "Examine ceci" ou "critique ceci" | Rapporter, ne rien modifier | review.md, laws.md, verify.md |
| "Rends ça plus beau", "ça fait générique", sur quelque chose qui existe | Trouver ce qui ne va pas, puis corriger dans le style existant | extend.md section 3, puis commands/polish.md ; pour une faiblesse claire, la commande correspondante |
| Nouvel écran ou composant dans un projet qui a déjà un style | Étendre. Pas de travail directionnel, pas de questions | extend.md ; plus product.md pour les surfaces Opérer, mobile.md pour le natif |
| Nouvelle surface Opérer sans rien sur quoi s'appuyer | Demander si le brief est ouvert, puis construire | ask.md, product.md, craft.md ; mobile.md si natif |
| Nouvelle surface Persuader ou Lire sans rien sur quoi s'appuyer | Demander si le brief est ouvert, puis le flux complet | ask.md, create.md (qui inclut structures.md et ingredients.md), web.md ou mobile.md ; photos.md si les images vendent ou si des photos ont été fournies |
| Une refonte explicitement demandée par l'utilisateur | Traiter comme un nouveau travail, en conservant le contenu et le comportement | La ligne de nouveau travail correspondante, plus extend.md section 1 pour inventorier ce qui doit survivre |
Chaque route qui construit quelque chose se termine par la boucle ci-dessous, avec slips.md et verify.md. Les retouches n'ont besoin que d'un regard.
Modifier l'identité d'un produit existant nécessite une demande explicite. Sans cela, "fais-le ressortir" signifie un meilleur travail dans le style actuel.
3. Demander (nouveau travail seulement)
Lorsque le brief laisse ouvert pour qui c'est, comment cela devrait se sentir, ou ce que l'utilisateur a à montrer, demandez avant de concevoir : un tour, au maximum quatre questions sur le produit, chacune pouvant être ignorée, aucune sur les polices ou les couleurs. Pour une nouvelle page, demandez aussi autour de quoi le premier écran devrait être construit (trois approches que vous proposez pour ce sujet) et combien de directions ils veulent voir côte à côte (1, 3 ou 5 ; 3 recommandé). ask.md les contient. Ignorez les questions que le brief ou DESIGN.md répond déjà.
Si personne n'est là pour répondre, énoncez chaque hypothèse et continuez. N'attendez jamais dans une boucle.
4. La boucle
- Construire la première version réelle.
- Regarder. Rendez-la et capturez-la à 320, 390 et 1440 de large (pour le natif, sur un simulateur ou appareil de taille téléphone). Avant de relire le code, notez ce qui est visible.
- Vérifier par rapport à
slips.md. Exécutez les scripts qui s'appliquent (voirverify.md). - L'utiliser. Appuyez sur le bouton principal, remplissez le formulaire, naviguez au tab, trouvez la navigation en largeur téléphone.
- Corriger ce que vous avez trouvé et regardez à nouveau. Deux tours, puis rapportez ce qui reste.
Si rien ne peut être rendu, dites-le, vérifiez la source à la place, et ne considérez pas le travail comme vérifié. Pour un travail substantiel (une page ou un écran entier) où des sous-agents existent, remettez les captures d'écran à un nouveau relecteur qui n'a pas vu votre raisonnement ; ses corrections comptent comme l'un des deux tours.
Règles qui s'appliquent toujours
- Qui a le dernier mot : une instruction explicite de l'utilisateur ; puis le système existant ; puis les réponses et références de l'utilisateur ; puis la direction que vous avez écrite ; puis les nombres et listes de cette compétence. Les minimums d'accessibilité ne sont pas remplacés par le goût, le vôtre ou celui de cette compétence. Quelque chose que l'utilisateur a demandé n'est jamais signalé comme un défaut.
- Contenu honnête. Pas de lorem ipsum, et pas de preuves inventées : témoignages, clients, logos, évaluations, chiffres d'utilisation. Les faits dont une page a besoin (un prix, des conditions d'essai) peuvent être des substituts plausibles, marqués dans un commentaire de code et listés dans le rapport. Les exemples de données dans une démo, un catalogue ou un tableau de bord sont les bienvenus quand ils sont spécifiques, et sont étiquetés comme exemple une fois à l'écran.
- Le restylage ne change jamais le comportement. Conservez les noms de champs, ids, liens, gestionnaires, actions de formulaire, hooks de test et attributs d'accessibilité.
- Construisez les états qui peuvent arriver, et tous ceux-là. Pressé et désactivé toujours ; survol et focus clavier partout où il y a un pointeur ou un clavier. Chargement, vide et erreur partout où quelque chose de réel se charge, peut être vide ou peut échouer. Ne construisez jamais un appel réseau juste pour avoir un état de chargement.
- Minimums d'accessibilité : contraste du texte 4,5:1 ; focus clavier visible ; contrôles d'au moins 24px, et 44pt / 48dp sur écrans tactiles ; un chemin avec mouvement réduit ; rien de perdu lorsque le texte est agrandi.
craft.mdcontient les nombres etlaws.mdla norme exacte. - Vérifié signifie regardé.
Rapport
Trouvé : plateforme, surface, système existant, ce que l'utilisateur a fourni
Direction : une phrase (nouveau travail), ou ce qui a été réutilisé et ce qui a été ajouté (extension)
Regardé : ce qui a été rendu, à quelles largeurs, ce qui a été utilisé manuellement
Corrigé : ce que la boucle a attrapé
Supposé : faits de substitution et exemples de données, par type, ou "aucun"
Ouvert : ce qui n'est pas fait ou pas vérifié, et tout ce qu'un guide dit de signaler
Limitez-vous à ces lignes. Une retouche a droit à une ligne.
Fichiers
| Fichier | Contient |
|---|---|
ask.md | Le tour de questions |
create.md | Nouveau travail Persuader et Lire : l'idée, le grand geste, les alternatives grossières, la direction |
structures.md | Structures de page entre lesquelles choisir, afin que les alternatives diffèrent par la forme et pas seulement par la couleur |
ingredients.md | Les rôles de tokens que chaque direction remplit, et les options pour la couleur, la typographie, la forme et l'espace |
extend.md | Travailler dans un style existant |
product.md | Surfaces Opérer : tableaux de bord, outils, écrans d'application |
photos.md | Pages dirigées par des photographies |
web.md, mobile.md | Ce qui va où sur une page web ou un écran de téléphone |
slips.md | Erreurs réellement commises, par surface. Vérifié à chaque regard |
verify.md | Comment capturer, vérifier et examiner ; les scripts d'aide |
craft.md | Chaque nombre : typographie, couleur, espace, mouvement, cibles |
laws.md | Ce que les lois de l'UX justifient et ne justifient pas ; mythes |
tells.md | Défauts courants de conception générée |
review.md, design-md.md | Format de critique ; enregistrement des décisions |
Tout se trouve dans references/.
Chaque chemin dans cette compétence (references/..., scripts/..., assets/...) est relatif au dossier qui contient ce fichier, pas au projet de l'utilisateur. Dans Claude Code, ce dossier est ${CLAUDE_SKILL_DIR}. Lors de l'exécution d'un script, utilisez son chemin complet, par exemple node "<dossier de cette compétence>/scripts/lint.js" <cible>.