Configuration du design
Aperçu
Avant le premier écran, mettez-vous d'accord sur ce qu'est le produit, à qui il s'adresse, comment il doit se ressentir et ce à quoi il ne doit jamais ressembler. Consignez cela dans DESIGN.md, le brief que toute décision de design ultérieure lira en premier. Demandez, n'inventez pas : une marque créée par l'agent est une supposition que la personne devra défaire. Lisez ce qui existe, interviewez la personne une question à la fois, rédigez le brief, arrêtez-vous pour approbation, puis construisez les fondations.
Quand utiliser
- Une tâche de design et aucun
DESIGN.mdà la racine du projet. - "Configurer le design", "définir notre style / marque / directives",
/craft-setup(/craft:craft-setupdans le plugin Claude Code).
Quand NE PAS utiliser
DESIGN.mdexiste et la tâche est un design : utilisezcraft.- Modification d'un seul jeton ou d'une seule directive : utilisez
craft-system.
Étapes
- Lisez d'abord. README, docs, CSS ou jetons existants, le fichier de design, les dossiers de marque, toute ébauche de
DESIGN.md. Consignez ce qu'ils répondent déjà. Si le code a déjà un système de design (un package UI, des fichiers de jetons, une bibliothèque de composants), mentionnez-le avec des comptes et écrivez "Source du système de design :<chemin>" dans la section Marque du brief. À l'étape 6, proposez de l'importer dans l'outil de design au lieu de créer des fondations ; les questions de marque auxquelles il répond sont ignorées. Deux packages UI → demandez lequel est la source avant d'ignorer toute question de marque. Ne posez jamais une question à laquelle ces fichiers répondent. Confirmez-le en une ligne ("Votre README indique pt-BR uniquement et des membres de plus de 60 ans, donc je concevrai pour du texte en 18px et des tapotas en 48px"). - Interviewez, une question par message. Suivez l'entretien dans son ordre : produit, public et voix, ambiance, marque, références, contraintes.
- Proposez 3 à 5 options plus "autre chose" chaque fois que possible.
- Sautez toute question déjà répondue.
- Arrêtez-vous lorsque les réponses sont suffisantes pour concevoir le premier écran. Six bonnes réponses valent mieux que quinze.
- Les références sont obligatoires. Demandez 2 à 5 produits, sites ou images qu'ils aiment. Pour chacun, demandez ce qu'il faut reprendre et ce qu'il faut éviter. S'il s'agit d'un lien ou d'une image que vous pouvez ouvrir, regardez-le et dites ce que vous voyez avant de demander.
- Rédigez
DESIGN.mdà la racine du projet à partir du modèle, avec les huit sections : Produit, Public et voix, Ambiance, Marque, Références, Contraintes, Journal des décisions, Questions ouvertes.- Utilisez leurs mots lorsque vous le pouvez.
- Tout ce que vous avez déduit et qu'ils n'ont pas confirmé va dans les Questions ouvertes, pas dans le brief comme un fait.
- Arrêtez-vous et montrez la
DESIGN.mdà la personne. Modifiez-la jusqu'à ce qu'elle l'approuve. - Fondations.
- Système de design déjà dans le code : proposez l'importation. En cas d'acceptation, SOUS-COMPÉTENCE REQUISE :
craft-sync(importation). Elle affiche un inventaire et demande quels composants dessiner. En cas de refus, consignez " — Importation dans refusée" dans le Journal des décisions. Proposez-le même après un "passer" : il concerne l'outil de design, pas le brief. - Aucun système dans le code : SOUS-COMPÉTENCE REQUISE :
craft-systemen mode création pour les fondations (jetons, typographie, espacement, règles d'interaction). Elle a son propre arrêt d'approbation. - Les jetons et styles existants sont le point de départ : étendez-les, ne les renommez pas et ne les déplacez pas sans demander.
- Système de design déjà dans le code : proposez l'importation. En cas d'acceptation, SOUS-COMPÉTENCE REQUISE :
Si la personne dit "passer" ou "concevez-le simplement"
N'insistez pas. Rédigez un DESIGN.md minimal à partir de ce que vous avez lu et de ce qu'ils ont dit :
- chaque lacune devient une Question ouverte ;
- chaque hypothèse est marquée "(supposé)".
Dites en une ligne quelles hypothèses sont les plus importantes. "Passer" renonce à l'entretien et à l'arrêt d'approbation du brief, jamais à l'étape 6 :
- système de design dans le code → posez quand même la seule question d'importation ("Importer dans maintenant ? Je montrerai ce qu'il y a et vous choisirez les composants"), puis continuez ;
- pas encore de jetons → l'étape des fondations et son arrêt ont toujours lieu, car
craftne peut dessiner qu'avec des pièces du système.
Puis continuez avec la tâche demandée.
Avant de commencer
- Si aucun adaptateur dans
references/adapters/ne correspond à votre outil, faites les mêmes verbes dans votre outil et dites lesquels vous avez mappés manuellement. Sans outil de design du tout, construisez en HTML (html.md). Si vous n'avez qu'une image, dites que les valeurs lues sont des estimations. DESIGN.mdest un fichier Markdown simple dans le dépôt, quel que soit l'outil. Seul le tableau de références optionnel vit dans l'outil de design.
Règles
| Règle | Pourquoi |
|---|---|
| Une question par message, avec options | Un mur de questions est survolé et à moitié répondu |
| Lire avant de demander ; ne jamais demander ce que disent les fichiers | Demander ce qu'il y a dans le README leur dit que vous n'avez pas regardé |
| Pas de marque inventée : les couleurs, polices et ambiances viennent d'eux ou sont marquées "(supposé)" | Une marque inventée est une supposition qu'ils devront défaire écran par écran |
| Les références viennent toujours avec prendre/éviter | "J'aime Stripe" est inutile ; "prendre l'espacement calme, éviter les dégradés" est une règle |
| "Jamais comme" est demandé explicitement | Ce qu'il faut éviter affine le design plus rapidement que ce qu'il faut viser |
| Ne pas reconcevoir les fichiers existants pendant la configuration | La configuration enregistre les décisions ; modifier leur CSS est une tâche de design qu'ils n'ont pas encore demandée |
| Pas d'écrans pendant la configuration | Les écrans viennent de craft, après l'approbation du brief et des fondations |
Terminé lorsque
DESIGN.md est approuvé avec ses huit sections, et les fondations sont réglées : créées et approuvées via craft-system, ou (avec un système dans le code) importées via craft-sync ou l'importation refusée et consignée. Après un "passer" : DESIGN.md est rédigé avec ses hypothèses marquées, les fondations existent (approuvées ou déjà dans le projet), et la tâche originale s'est poursuivie.
Erreurs courantes
| Pensée | Réalité |
|---|---|
| "Je vais choisir une belle palette et des polices, ils pourront changer" | Ils ne peuvent pas changer ce qu'ils ne savaient pas avoir été décidé. Demandez, ou marquez-le "(supposé)". |
| "Pendant que j'y suis, je vais esquisser les écrans principaux" | C'est le travail de craft, après approbation. La configuration se termine au brief et aux fondations. |
| "Laissez-moi poser les six questions à la fois pour gagner du temps" | Une par message, avec options. C'est plus rapide pour eux de répondre. |
| "Leurs jetons sont en désordre, je vais les restructurer" | Étendez-les. La restructuration est un changement séparé et approuvé. |
| "Aucune référence donnée, je vais sauter cette section" | Demandez-les. S'ils n'en ont pas, proposez-en trois qui correspondent à l'ambiance et demandez quoi prendre et éviter de chacune. |