Que fait craft ?
Aperçu
La porte d'entrée pour tout ce qui est visuel. Elle transforme « conçois la page de tarification » en un design terminé et revu. Elle part du brief du projet, couvre tous les états, offre des options uniquement lorsque la direction est ouverte, utilise uniquement les éléments du système de design, et vérifie son propre travail avant de le montrer. Elle appelle les autres compétences de design à des points fixes ; elle ne les remplace pas.
Quand l'utiliser
- « Design / Crée / Maquette / Refonds la <page, écran, flux, élément> »,
/craft(/craft:craftdans le plugin Claude Code). - Plusieurs pages à la fois (« conçois l'onboarding : bienvenue, inscription, vérification »).
Quand NE PAS l'utiliser
- Une petite modification que la personne a décrite exactement (une valeur, un libellé, une taille) : faites-la.
- Uniquement une revue (« qu'est-ce qui cloche là-dedans ? ») :
craft-critique. Uniquement des options :craft-explore.
Avant de commencer
- Si aucun adaptateur dans
references/adapters/ne correspond à votre outil, effectuez les mêmes actions dans votre outil et dites lesquelles vous avez mappées manuellement. Sans outil de design du tout, construisez en HTML (html.md). Si vous ne disposez que d'une image, dites que les valeurs lues sont des estimations.
Les arrêts sont réels
Un arrêt signifie : terminez votre tour par la question et attendez. Vous pouvez toujours le faire, même dans une session unique ou sans tête, où votre message final est la question. Ne décidez jamais d'un arrêt à la place de la personne parce que la session « ne peut pas attendre » ou « pour économiser un aller-retour ». Le décider vous-même transforme une réponse de cinq secondes en des heures de reprise.
Étapes
- Contexte.
- Lisez
DESIGN.mdà la racine du projet. S'il manque, ou n'a pas de section Produit (un enregistrement de synchronisation uniquement) → SOUS-COMPÉTENCE REQUISE :craft-setup, puis revenez ici. - Lisez le système de design (tokens, composants, guide) et les écrans liés à celui-ci.
- Lorsque le brief et le code sont en désaccord (le brief dit turquoise, les tokens disent bleu) : suivez le code, dites-le en une ligne, ajoutez le conflit à
DESIGN.md› Questions ouvertes, et proposez de mettre à jour ce qui est erroné. Ne remplacez jamais les tokens dans le CSS d'une page. - Lorsque le guide de l'outil de design et le code diffèrent et qu'un
design-sync.jsonexiste, ne déclarez pas le guide obsolète. Classez-le avec : code modifié → proposez de rafraîchir le guide avant de dessiner ; guide modifié → c'est le changement de la personne qui attend une exportation, dessinez donc avec et mentionnez l'exportation en attente.
- Lisez
- Périmètre en mots. Listez chaque page ou élément à créer, chacun avec son rôle et sa prochaine action unique.
- Les mots ambigus reçoivent une interprétation clairement énoncée (« page de tarification = la liste de prix de la boulangerie, pas les plans d'abonnement »).
- Arrêtez-vous et confirmez la liste lorsqu'il y a plus d'un élément ou que la demande est vague. Un seul élément clair : continuez.
- Pour chaque élément, dans l'ordre :
- SOUS-COMPÉTENCE REQUISE :
craft-states. Sa liste d'états écrite et son arrêt viennent en premier. - Direction ouverte ? Uniquement lorsque la personne a demandé des idées, ou lorsque deux mises en page structurellement différentes sont plausibles et que ni le brief ni le système ne les départage → SOUS-COMPÉTENCE REQUISE :
craft-exploreavant de dessiner les états. Pour plusieurs pages, demandez lors de l'arrêt du périmètre quelle page (le cas échéant) reçoit des options ; n'exécutez jamais un tour d'options par page par défaut. Les états sont ensuite dessinés dans la direction choisie. Un écran qui suit un modèle existant va directement au dessin. - Dessinez l'état principal, puis les autres états, en utilisant uniquement les éléments et tokens du système. Quelque chose de nouveau (un composant, une couleur, une taille que l'échelle ne possède pas) → SOUS-COMPÉTENCE REQUISE :
craft-system(mode ajout) avant de l'utiliser. Un composant qui existe dans le code mais n'est pas dessiné dans l'outil (« dans le code uniquement » dans l'index) → SOUS-COMPÉTENCE REQUISE :craft-sync(import d'un composant), en dessinant d'abord ce composant uniquement. Si la personne a refusé l'import (voirDESIGN.md), demandez une fois avant d'importer ; si elle dit toujours non, construisez à partir des valeurs du code sur le tableau lui-même et notez-le. Ne dessinez jamais d'imitation, et ne codez jamais en dur une nouvelle valeur dans une page. - SOUS-COMPÉTENCE REQUISE :
craft-critiqueen mode auto-vérification sur chaque tableau : rendez-le, corrigez ce qu'il trouve dans le périmètre de cette tâche, et rendez-le à nouveau.
- SOUS-COMPÉTENCE REQUISE :
- Clôture.
- Montrez le résultat avec le résumé ci-dessous.
- Ajoutez les décisions à
DESIGN.md› Journal des décisions (date, décision, pourquoi). - Déplacez toute question ayant obtenu une réponse hors des Questions ouvertes.
Résumé de clôture (la forme de votre message final)
Réalisé : <pages/éléments> — <où : fichiers ou tableaux>
Décisions : <chacune, une ligne avec son pourquoi> (aussi dans DESIGN.md › Journal des décisions)
Modifications système : <éléments ou tokens ajoutés/modifiés> — impacte : <écrans>
Corrections auto-vérification : <ce que craft-critique a changé avant que vous ne le voyiez>
Questions ouvertes : <ce que la personne doit encore décider>
Règles
| Règle | Pourquoi |
|---|---|
DESIGN.md d'abord, à chaque fois | Sans le brief, chaque écran invente son propre style |
| Périmètre confirmé avant le travail lorsqu'il y a plus d'un élément | Trois pages construites sur une mauvaise lecture, c'est trois pages gaspillées |
Liste des états avant de dessiner (via craft-states) | Le chemin heureux n'est qu'un état parmi d'autres |
| Options uniquement lorsque la direction est ouverte | Des options sur un modèle résolu gaspillent l'attention de la personne |
Uniquement les éléments et tokens du système ; les nouveaux passent par craft-system | Les valeurs codées en dur dans les pages sont là où la dérive commence |
| Le code prime sur un brief obsolète ; notez-le, ne le remplacez pas | Les tokens sont ce qui est livré ; le brief est mis à jour par décision, pas en silence |
| Auto-vérification avant de montrer | La personne doit revoir le design, pas attraper les erreurs |
Les décisions vont dans DESIGN.md | La conception de la session suivante part de là, pas de la mémoire |
Terminé lorsque
Chaque élément du périmètre confirmé a ses états dessinés et auto-vérifiés, toute modification système est passée par craft-system, le résumé de clôture a été donné, et le journal des décisions de DESIGN.md a été mis à jour.
Erreurs courantes
| Pensée | Réalité |
|---|---|
| « Trois pages sont assez claires, je vais juste les construire » | Confirmez d'abord la liste. Cela coûte un message. |
| « Je vais faire des boutons de 52px ici ; le token dit 44, mais ce public a besoin de plus grand » | C'est une décision système. Proposez-la via craft-system, puis utilisez-la partout. |
| « Le brief dit turquoise, donc je vais remplacer le bleu dans le CSS de cette page » | Le code prime. Signalez le conflit et demandez ; ne corrigez jamais les tokens localement. |
| « Je vais montrer, ils me diront ce qui ne va pas » | Exécutez d'abord craft-critique en mode auto-vérification, et dites ce qu'il a corrigé. |
| « Les décisions sont dans mon message, ça suffit » | Les messages défilent. Ajoutez-les à DESIGN.md. |
| « Cette session ne peut pas s'arrêter pour des réponses, donc je vais prendre les décisions moi-même et les lister » | Terminer votre tour par la question est s'arrêter. Faites cela ; ne construisez rien après le premier arrêt ouvert. |
| « Pour économiser un aller-retour, je vais mettre les deux arrêts dans un seul message » | Très bien, si vous vous arrêtez ensuite. Posez les deux questions, ne construisez rien, attendez. |