Que fait do-design ?
Les chemins sont relatifs au dossier de ce skill ; P est la racine du projet. Les scripts sont du
Python 3.8+ de la bibliothèque standard. Exécutez le script avant de raisonner sur tout ce qu'il mesure,
citez sa sortie, et ne déduisez ou n'estimez jamais ce qu'il rapporte.
Modèle
- Le
DESIGN.mddu projet (le document) est contraignant et prime sur ce skill. En cas de conflit, le document gagne ; dites-le. - Chaque règle porte sa raison. Une règle sans raison est supprimée la première fois qu'elle gêne.
- Des preuves avant les valeurs par défaut. Un bref brief ("faites-le nouveau" + un logo) est une raison de rechercher, pas de recourir à l'apparence habituelle ou d'inventer des faits. Pas de source, pas d'affirmation : marquez l'écart ou demandez.
- Chargez paresseusement. Seulement les fichiers que le tableau des commandes nomme. Des couches supplémentaires "pour être complet" sont un échec de méthode.
- La convention est la valeur par défaut, pas l'échec. Le mode décide à quel point s'en écarter.
Modes : indiquez une ligne au début de chaque commande
| Mode | Le visiteur est | Pousser |
|---|---|---|
| Persuader | en train de décider et d'agir | fort : un modèle est un échec |
| Opérer | en train d'accomplir une tâche | retenue : la convention est une fonctionnalité |
| Lire | en train de comprendre quelque chose | moyen : le confort de lecture prime |
| Expérience | à l'intérieur de l'œuvre elle-même | fort : l'artefact mène |
Choisissez par surface, pas par produit : la page d'accueil d'un outil de développement est Persuader, son écran de configuration Opérer.
Commandes : chargez un fichier de commande, plus ce que ses lignes nomment
| Commande | Quand l'utiliser | Charger aussi | Risque |
|---|---|---|---|
do-design-review | "est-ce que ça correspond au document ?" Le moins cher, exécutez-le le plus | le DESIGN.md du projet | - |
do-audit | "à quel point est-ce bon ?" Score + constats classés | references/critique-rubric.md, references/slop-catalog.md, les couches 00-05 que le périmètre touche | - |
do-design-new | "construire X" : conventionnel, compétent, conforme au document | layers/00, les 1-3 couches que la tâche touche ; layers/06 quand le brief est mince ou orienté client | faible |
do-design-renew | "refaire cette apparence" : nouveau monde, même vérité produit | layers/00, layers/06 | moyen |
do-crazy | "quelque chose que personne dans ce secteur ne ferait" | layers/00, layers/06 | élevé, par conception |
Couches : 00-craft-floor (tous les modes) · 01-couleur · 02-typographie · 03-espace-disposition ·
04-mouvement-états · 05-voix · 06-recherche. Rédiger un document : templates/DESIGN.md,
examples/01-two-papers.md, references/interview.md.
Scripts (tous acceptent --json)
| Exécution | Donne |
|---|---|
scripts/check-design.py --root P | l'écart par rapport au bloc de jetons du document. Code de sortie 0 propre, 1 écart, 2 pas de document/jetons. --init ébauche les jetons à partir du code |
scripts/audit.py scan P | les signes sources (ID comme dans le catalogue slop), les lacunes d'accessibilité et de surface navigateur, l'inventaire de valeur |
scripts/audit.py copy P | les signes de prose et de microcopie, le rythme des phrases, les marqueurs de lacune non comblés |
scripts/audit.py contrast FG BG / --paper P/DESIGN.md | les ratios WCAG |
scripts/audit.py score H L S C T U D | le score pondéré, la bande, la liste de travail |
scripts/render-audit.py URL-or-file [--shots DIR] [--inject-css FILE] | la page peinte à 1280/768/390 : chevauchement, défilement latéral, rognage, contraste peint, cibles tactiles, visibilité du focus. --inject-css mesure une correction CSS sur la page déployée avant de déployer. Nécessite Chrome/Chromium |
| `scripts/research.py suggest | profile |
bash scripts/install-guardrails.sh P | DESIGN.md à partir du modèle, le bloc AGENTS.md/CLAUDE.md, le vérificateur |
Les captures d'écran coûtent beaucoup plus de contexte que la sortie du script : ne les prenez que pour ce qui nécessite des yeux (hiérarchie, distinction, composition), uniquement la zone d'affichage, d'abord à 390. Les scripts peuvent aussi se tromper : avant de signaler un P0 qui semble invraisemblable, confirmez-le une fois (une capture d'écran ciblée ou la géométrie de l'élément), et corrigez le script si c'était un faux positif.
Définitions partagées
Test d'échange. Remplacez le nom du produit par celui d'un concurrent. Si rien ne se casse, la page ne dit rien sur ce produit : non choisi, pas laid. Corrigez-le dans la copie, le visuel et un détail de signature, jamais en ajoutant de la décoration.
Direction, cinq lignes. Écrite avant de construire, montrée, puis attendez un oui (si on vous dit "faites-le", énoncez l'hypothèse en une ligne et allez-y) :
Produit : ce qu'il fait, pour qui, une phrase simple
Caractère : 2-3 mots concrets (jamais propre, moderne, élégant, minimal, premium)
Monde : le lieu ou le matériau auquel il appartient ; définit la teinte neutre, l'accent, l'imagerie
Moments : 1-2 endroits où l'écran devient riche
Signature : un détail que seul ce produit a, utilisé de manière cohérente
Marqueur de lacune. [nombre nécessaire], [source nécessaire], [photo nécessaire] là où un fait ou
un bien manque. audit.py copy liste ceux qui sont encore ouverts ; aucun ne peut être livré.
Notation : chaque commande d'évaluation se termine par celle-ci
| # | Champ | Question | P |
|---|---|---|---|
| 1 | Hiérarchie | La chose la plus importante peut-elle être nommée en 2 secondes ? | 3 |
| 2 | Lisibilité | Contraste, taille, mesure, copie réelle à chaque largeur | 3 |
| 3 | Système | Une palette, une échelle, une logique de rayon, un langage de mouvement | 2 |
| 4 | Facture | Alignement, rythme des espacements, états, surfaces navigateur | 2 |
| 5 | Vérité du contenu | Données réelles, copie spécifique, aucune affirmation inventée | 3 |
| 6 | Utilisabilité | La tâche se termine ; les affordances sont évidentes ; les erreurs sont récupérables | 3 |
| 7 | Distinction | Passe-t-il le test d'échange ? | 2 |
Notez chaque champ de 0 à 4 (4 = vraiment excellent, pas "correct") et calculez avec audit.py score.
Bandes : 85+ Fort, livrez et corrigez uniquement les P0 · 70-84 Solide, livrez après les P1 nommés ·
50-69 Faible, une vraie révision d'abord · <50 Échec, la direction est erronée : reconstruisez (do-design-renew).
Notez le rendu, pas la source. Un champ que vous n'avez pas pu vérifier est u : il marque 0 et se lit
non vérifié, jamais une estimation. La distinction obtient 4 seulement si vous pouvez nommer ce qui fait
que c'est celui de ce produit. Les trois pires champs sont la liste de travail, une action chacun.
Sévérité : P0 bloque la livraison (cassé, illisible, interdiction formelle), signalez tous · P1 endommage
la confiance, top 5 · P2 facture, top 5 · P3 polissage, listez seulement.
Format du constat : [Pn] emplacement - ce qui ne va pas - correction ; les constats de script conservent leur ID.
Pas de document
Dites "Pas de DESIGN.md : la garde-fou n'a rien à appliquer." Proposez de l'écrire (modèle +
entretien), ou une rétro-ingénierie à partir du code (check-design.py --init + entretien §Rétro-ingénierie) : la v1.0 est
ce qui est livré, les anciennes valeurs vont dans legacy: (comptées, pas échouées), les lacunes dans la liste des écarts du document.
Les archives et démos restent en dehors de chaque analyse via skip: dans le bloc de jetons (ou --skip a,b),
par dossier ou fichier. Grep pour les importations avant de sauter : les dossiers d'archives contiennent souvent des parties actives.
N'inventez jamais de document pour que le vérificateur passe.
Non-négociables
- Ne cassez jamais du code fonctionnel. Les props, l'état, le routage, les gestionnaires et l'accessibilité survivent ; la copie conserve son sens.
- Le brief gagne. Une marque, police ou couleur énoncée l'emporte sur le goût, même sur une liste de refus. Écrivez-la dans le document (
allow:dans le bloc de jetons désactive intentionnellement une règle du vérificateur ou un ID d'audit). - N'inventez jamais de faits, d'actifs ou de sources. Supprimez une affirmation vague ; ne la remplacez jamais par un spécifique inventé. Utilisez un marqueur de lacune.
- Gardez la voix de l'auteur. Supprimez les habitudes de machine, conservez les bizarreries de la personne.
- Densité, pas présence. Agissez sur des clusters (3+ signes P0/P1 distincts), jamais sur un dégradé ou un tiret em. Un résultat propre est valide ; ne fabriquez jamais de constats.
- Corrigez, n'accusez jamais. Ne dites jamais "cela semble généré par IA" ; nommez ce qui n'est pas choisi et quoi faire à la place.
- Lecture seule sauf demande pour les critiques et audits.