Communitygithub.com

craft-setup

Utilisez cette compétence lorsqu'une demande de conception ou de création d'une page, d'un écran ou d'un élément commence dans un projet sans DESIGN.md à sa racine, lorsque la personne demande de configurer, définir ou démarrer le design, le style, la marque ou les directives d'un produit, ou exécute /craft-setup (/craft:craft-setup dans le plugin Claude Code).

Qu'est-ce que craft-setup ?

La compétence **craft-setup** est conçue pour initialiser le processus de conception dans un projet logiciel en l'absence d'un document `DESIGN.md`. Elle guide l'agent et l'utilisateur à travers une série d'étapes structurées : lecture des ressources existantes, entretien ciblé (une question par message), collecte de références visuelles, rédaction du brief dans `DESIGN.md`, validation, puis mise en place des fondations (système de design, tokens, typographie, etc.). L'objectif est de s'assurer que toutes les décisions de conception sont documentées et approuvées avant de passer à la réalisation des écrans. La compétence prend en charge plusieurs outils de conception (via des adaptateurs) et permet soit d'importer un système de design existant depuis le code, soit d'en créer un nouveau via la sous-compétence `craft-system`. Elle évite les suppositions en marquant clairement les inférences non confirmées comme des questions ouvertes. Platforms supportées : Claude Code, Cursor, Codex, et tout outil compatible avec un adaptateur.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/craft/tree/HEAD/skills/craft-setup

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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-setup dans le plugin Claude Code).

Quand NE PAS utiliser

  • DESIGN.md existe et la tâche est un design : utilisez craft.
  • Modification d'un seul jeton ou d'une seule directive : utilisez craft-system.

Étapes

  1. 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").
  2. 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.
  3. 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.
  4. 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.
  5. Arrêtez-vous et montrez la DESIGN.md à la personne. Modifiez-la jusqu'à ce qu'elle l'approuve.
  6. 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-system en 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.

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 craft ne 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.md est 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èglePourquoi
Une question par message, avec optionsUn mur de questions est survolé et à moitié répondu
Lire avant de demander ; ne jamais demander ce que disent les fichiersDemander 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é explicitementCe qu'il faut éviter affine le design plus rapidement que ce qu'il faut viser
Ne pas reconcevoir les fichiers existants pendant la configurationLa 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 configurationLes é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éeRé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.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills associés