Compétence Laboratoire de Design
Cette compétence implémente un flux de travail complet d'exploration de design : entretien, génération de variantes, collecte de retours, raffinement, prévisualisation et finalisation.
CRITIQUE : Comportement de Nettoyage
Tous les fichiers temporaires DOIVENT être supprimés lorsque le processus se termine, que ce soit par :
- L'utilisateur confirme le design final → nettoyage, puis génération du plan
- L'utilisateur abandonne/annule → nettoyage immédiat, aucun plan généré
Ne laissez jamais les dossiers .claude-design/ ou les routes __design_lab derrière vous. Si l'utilisateur dit « annuler », « abandonner », « arrêter » ou « oublie ça » à tout moment, confirmez puis supprimez tous les artefacts temporaires.
Phase 0 : Détection Pré-vol
Avant de commencer l'entretien, détectez automatiquement :
Gestionnaire de Paquets
Recherchez les fichiers de verrouillage dans la racine du projet :
pnpm-lock.yaml→ utilisezpnpmyarn.lock→ utilisezyarnpackage-lock.json→ utiliseznpmbun.lockb→ utilisezbun
Détection du Framework
Recherchez les fichiers de configuration :
next.config.jsounext.config.mjsounext.config.ts→ Next.js- Vérifiez la présence du dossier
app/→ App Router - Vérifiez la présence du dossier
pages/→ Pages Router
- Vérifiez la présence du dossier
vite.config.jsouvite.config.ts→ Viteremix.config.js→ Remixnuxt.config.jsounuxt.config.ts→ Nuxtastro.config.mjs→ Astro
Détection du Système de Style
Recherchez les dépendances dans package.json et les fichiers de configuration :
tailwind.config.jsoutailwind.config.ts→ Tailwind CSS@mui/materialdans les dépendances → Material UI@chakra-ui/reactdans les dépendances → Chakra UIantddans les dépendances → Ant Designstyled-componentsdans les dépendances → styled-components@emotion/reactdans les dépendances → Emotion- Fichiers
.cssou.module.css→ CSS Modules
Vérification de la Mémoire de Design
Recherchez un fichier de Mémoire de Design existant :
docs/design-memory.mdDESIGN_MEMORY.md.claude-design/design-memory.md
S'il est trouvé, lisez-le et utilisez-le pour préremplir les valeurs par défaut et sauter les questions redondantes.
Inférence du Style Visuel (CRITIQUE)
N'utilisez PAS de styles prédéfinis/génériques. Extrayez le langage visuel du projet :
Si Tailwind est détecté, lisez tailwind.config.js ou tailwind.config.ts :
// Extrayez et utilisez :
theme.colors // Palette de couleurs
theme.spacing // Échelle d'espacement
theme.borderRadius // Valeurs de rayon
theme.fontFamily // Typographie
theme.boxShadow // Système d'élévation
Si des variables CSS existent, lisez globals.css, variables.css ou les définitions :root :
:root {
--color-* /* Jetons de couleur */
--spacing-* /* Jetons d'espacement */
--font-* /* Jetons de typographie */
--radius-* /* Jetons de rayon */
}
Si une bibliothèque d'interface est détectée (MUI, Chakra, Ant), lisez la configuration du thème :
- MUI :
theme.tsou appelcreateTheme() - Chakra :
theme/index.tsou appelextendTheme() - Ant : propriété
themedeConfigProvider
Scannez toujours les composants existants pour comprendre les motifs :
- Trouvez 2-3 boutons existants → notez leurs motifs de style
- Trouvez 2-3 cartes existantes → notez le padding, les bordures, les ombres
- Trouvez des formulaires existants → notez les styles des champs, le placement des labels
- Trouvez la typographie existante → notez les tailles de titres, le corps du texte
Stockez les styles inférés dans le Cahier des Charges de Design pour une utilisation cohérente dans toutes les variantes.
Phase 1 : Entretien
Utilisez l'outil AskUserQuestion pour toutes les étapes de l'entretien. Adaptez les questions en fonction de la Mémoire de Design si elle existe.
Étape 1.1 : Périmètre & Cible
Posez ces questions (peuvent être combinées en une seule AskUserQuestion avec plusieurs questions) :
Question 1 : Périmètre
- En-tête : « Périmètre »
- Question : « Concevons-nous un seul composant ou une page entière ? »
- Options :
- « Composant » - Un élément d'interface réutilisable (bouton, carte, formulaire, modale, etc.)
- « Page » - Une mise en page complète de page ou d'écran
Question 2 : Nouveau ou Refonte
- En-tête : « Type »
- Question : « S'agit-il d'un nouveau design ou d'une refonte de quelque chose d'existant ? »
- Options :
- « Nouveau » - Créer quelque chose à partir de zéro
- « Refonte » - Améliorer un composant/page existant
Si « Refonte » est sélectionné, demandez : Question 3 : Chemin Existant
- En-tête : « Emplacement »
- Question : « Quel est le chemin du fichier ou la route de l'interface existante ? »
- Options : (laissez l'utilisateur fournir via « Autre »)
Si la cible n'est pas claire, proposez un nom basé sur les motifs du dépôt et confirmez.
Étape 1.2 : Points Faibles & Inspiration
Question 1 : Points Faibles
- En-tête : « Problèmes »
- Question : « Quels sont les principaux points faibles du design actuel (ou que devrait éviter ce nouveau design) ? »
- Options :
- « Trop chargé/dense » - Surcharge d'information, difficile à parcourir
- « Hiérarchie peu claire » - Les actions principales ne sont pas évidentes
- « Mauvaise expérience mobile » - Ne fonctionne pas bien sur les petits écrans
- « Aspect dépassé » - Semble vieux ou incohérent avec la marque
- multiSelect : true
Question 2 : Inspiration Visuelle
- En-tête : « Style visuel »
- Question : « Quels produits ou marques devrais-je référencer pour l'inspiration visuelle ? »
- Options :
- « Stripe » - Propre, minimal, digne de confiance
- « Linear » - Dense, orienté clavier, axé développeur
- « Notion » - Flexible, axé contenu, ludique
- « Apple » - Premium, spacieux, raffiné
- multiSelect : true
Question 3 : Inspiration Fonctionnelle
- En-tête : « Interactions »
- Question : « Quels motifs d'interaction devrais-je imiter ? »
- Options :
- « Édition en ligne » - Modifier sur place sans modales
- « Divulgation progressive » - Afficher plus au besoin
- « Mises à jour optimistes » - Retour instantané, synchronisation en arrière-plan
- « Raccourcis clavier » - Efficacité pour les utilisateurs avancés
Étape 1.3 : Direction de Marque & Style
Question 1 : Adjectifs de Marque
- En-tête : « Ton de la marque »
- Question : « Quels 3 à 5 adjectifs décrivent le ressenti souhaité de la marque ? »
- Options :
- « Minimal » - Propre, simple, sans encombrement
- « Premium » - Haut de gamme, poli, raffiné
- « Ludique » - Amusant, convivial, accessible
- « Utilitaire » - Fonctionnel, efficace, sans fioritures
- multiSelect : true
Question 2 : Densité
- En-tête : « Densité »
- Question : « Quelle densité d'information préférez-vous ? »
- Options :
- « Compact » - Plus d'informations visibles, espacement plus serré
- « Confortable » - Espacement équilibré, balayage facile
- « Spacieux » - Espaces blancs généreux, attention focalisée
Question 3 : Mode Sombre
- En-tête : « Mode sombre »
- Question : « Le mode sombre est-il requis ? »
- Options :
- « Oui » - Doit prendre en charge le mode sombre
- « Non » - Mode clair uniquement
- « Agréable à avoir » - Prendre en charge si facile, pas obligatoire
Étape 1.4 : Persona & Tâches à Accomplir
Question 1 : Utilisateur Principal
- En-tête : « Utilisateur »
- Question : « Qui est l'utilisateur final principal ? »
- Options :
- « Développeur » - Technique, orienté clavier
- « Designer » - Visuel, soucieux des détails
- « Utilisateur métier » - Axé efficacité, moins technique
- « Consommateur final » - Grand public, compétence technique variée
Question 2 : Contexte
- En-tête : « Contexte »
- Question : « Quel est le contexte d'utilisation principal ? »
- Options :
- « D'abord desktop » - Principalement utilisé sur de grands écrans
- « D'abord mobile » - Principalement utilisé sur téléphone
- « Les deux également » - Doit bien fonctionner sur tous les appareils
Question 3 : Tâches Clés
- En-tête : « Tâches clés »
- Question : « Quelles sont les 3 principales tâches que les utilisateurs doivent accomplir ? »
- (Laissez l'utilisateur fournir via « Autre » - c'est une question ouverte)
Étape 1.5 : Contraintes
Question 1 : Éléments à Conserver Impérativement
- En-tête : « Conserver »
- Question : « Y a-t-il des éléments qui doivent être préservés ? »
- Options :
- « Copie/étiquettes existantes » - Conserver le texte actuel
- « Champs/saisies actuels » - Conserver la structure du formulaire
- « Structure de navigation » - Conserver la navigation actuelle
- « Aucun » - Libre de tout changer
Question 2 : Contraintes Techniques
- En-tête : « Contraintes »
- Question : « Y a-t-il des contraintes techniques ? »
- Options :
- « Aucune nouvelle dépendance » - Utiliser uniquement les bibliothèques existantes
- « Utiliser les composants existants » - Construire sur le système de design actuel
- « Doit être accessible (WCAG) » - Exigences strictes d'accessibilité
- « Aucune » - Pas de contraintes particulières
- multiSelect : true
Phase 2 : Générer le Cahier des Charges de Design
Après l'entretien, créez un Cahier des Charges de Design structuré en JSON et enregistrez-le dans .claude-design/design-brief.json :
{
"scope": "component|page",
"isRedesign": true|false,
"targetPath": "src/components/Example.tsx",
"targetName": "Example",
"painPoints": ["Trop dense", "Action principale peu claire"],
"inspiration": {
"visual": ["Stripe", "Linear"],
"functional": ["Validation en ligne"]
},
"brand": {
"adjectives": ["minimal", "digne de confiance"],
"density": "confortable",
"darkMode": true
},
"persona": {
"primary": "Développeur",
"context": "desktop-first",
"keyTasks": ["Terminer le paiement", "Voir la commande", "Appliquer une réduction"]
},
"constraints": {
"mustKeep": ["champs existants"],
"technical": ["aucune nouvelle dépendance", "accessible WCAG"]
},
"framework": "nextjs-app",
"packageManager": "pnpm",
"stylingSystem": "tailwind"
}
Affichez un résumé à l'utilisateur avant de continuer.
Phase 3 : Générer le Laboratoire de Design
Structure des Dossiers
Créez tous les fichiers sous .claude-design/ :
.claude-design/
├── lab/
│ ├── page.tsx # Page principale du labo (spécifique au framework)
│ ├── variants/
│ │ ├── VariantA.tsx
│ │ ├── VariantB.tsx
│ │ ├── VariantC.tsx
│ │ ├── VariantD.tsx
│ │ └── VariantE.tsx
│ ├── components/
│ │ └── LabShell.tsx # Wrapper de mise en page du labo
│ ├── feedback/ # Système de retour interactif
│ │ ├── types.ts # Interfaces TypeScript
│ │ ├── selector-utils.ts # Identification d'éléments
│ │ ├── format-utils.ts # Mise en forme des retours
│ │ ├── FeedbackOverlay.tsx # Composant principal de superposition
│ │ └── index.ts # Exportations du module
│ └── data/
│ └── fixtures.ts # Données simulées partagées
├── design-brief.json
└── run-log.md
Configuration du Système de Retour (CRITIQUE - NE JAMAIS SAUTER)
Le FeedbackOverlay est la fonctionnalité PRINCIPALE du Laboratoire de Design. Sans lui, les utilisateurs ne peuvent pas fournir de retours interactifs. NE générez JAMAIS un Laboratoire de Design sans le FeedbackOverlay.
Stratégie de Fiabilité : Pour éviter les problèmes de chemins d'importation selon les différentes configurations de projet, créez le FeedbackOverlay directement dans le dossier de la route (par ex., app/design-lab/FeedbackOverlay.tsx), PAS dans .claude-design/. Cela garantit qu'une importation relative simple (./FeedbackOverlay) fonctionne toujours.
Fichiers Requis dans le Dossier de Route :
app/design-lab/ # ou app/__design_lab/ si les underscores fonctionnent
├── page.tsx # Page principale du labo avec les variantes
└── FeedbackOverlay.tsx # Composant de superposition autonome (copié depuis les modèles)
Source du Modèle : design-and-refine/templates/feedback/FeedbackOverlay.tsx
Pourquoi cette approche :
- Les chemins
.claude-design/peuvent échouer à cause des configurations du bundler - Les importations relatives depuis le même dossier fonctionnent toujours
- Le dossier de route est de toute façon supprimé lors du nettoyage
Intégration de la Route
Next.js App Router :
Créez app/__design_lab/page.tsx qui importe depuis .claude-design/lab/
Next.js Pages Router :
Créez pages/__design_lab.tsx qui importe depuis .claude-design/lab/
Vite React :
- Si React Router existe : ajoutez une route vers
/__design_lab - Si pas de routeur : créez un rendu conditionnel dans
App.tsxbasé sur le paramètre de requête?design_lab=true
Autres frameworks : Créez la route temporaire la plus appropriée pour le framework détecté.
Directives de Génération de Variantes
IMPORTANT : Lisez DESIGN_PRINCIPLES.md pour les meilleures pratiques UX, d'interaction et de mouvement. Mais N'utilisez PAS de styles visuels prédéfinis—inférez-les du projet.
Appliquez les principes universels (depuis DESIGN_PRINCIPLES.md) :
- UX : Heuristiques de Nielsen, réduction de charge cognitive, divulgation progressive
- Comportement du composant : États des boutons, anatomie du formulaire, structure de la carte
- Interaction : Motifs de retour, gestion des états, mises à jour optimistes
- Mouvement : Timing (150-300ms), easing (entrées en ease-out, sorties en ease-in)
- Accessibilité : États de focus, motifs ARIA, cibles tactiles (min 44px)
Inférez les styles visuels du projet :
- Couleurs → depuis la config Tailwind, les variables CSS ou les composants existants
- Typographie → depuis les titres existants, le corps du texte dans le codebase
- Espacement → depuis l'échelle d'espacement du projet ou les motifs existants
- Rayon de bordure → depuis les cartes, boutons, champs existants
- Ombres → depuis les composants surélevés existants
Chaque variante DOIT explorer un axe de design différent. Ne créez pas de variations mineures—rendez-les distinctes de manière significative. Utilisez le langage visuel existant du projet pour toutes les variantes.
Variante A : Focus sur la Hiérarchie de l'Information
- Restructurez la hiérarchie du contenu (qu'est-ce qui est le plus important ?)
- Appliquez la proximité gestaltique—regroupez les éléments liés plus près
- Une action principale par vue
- Utilisez l'échelle typographique existante pour créer des niveaux clairs
Variante B : Exploration du Modèle de Mise en Page
- Essayez une approche de mise en page différente (carte vs liste vs tableau vs panneau fractionné)
- Appliquez l'anatomie de la carte ou les motifs de comportement du tableau depuis DESIGN_PRINCIPLES
- Considérez le comportement responsive à chaque point de rupture
- Utilisez le système de grille/mise en page existant du projet
Variante C : Variation de Densité
- Si le cahier des charges dit « confortable », essayez une version plus compacte
- Si le cahier des charges dit « compact », essayez une version plus spacieuse
- Utilisez les jetons d'espacement existants du projet—appliquez-les simplement différemment
- Montrez les compromis : plus de données visibles vs balayage plus facile
Variante D : Modèle d'Interaction
- Motif d'interaction différent (modale vs en ligne vs panneau vs tiroir)
- Appliquez les motifs de retour : immédiat → progression → achèvement
- Implémentez tous les états requis (chargement, erreur, vide, désactivé)
- Considérez les mises à jour optimistes pour les actions non destructrices
Variante E : Direction Expressive
- Poussez la direction de marque que l'utilisateur a décrite dans l'entretien
- Explorez différentes utilisations des jetons de design existants du projet
- Plus ou moins d'utilisation d'ombres, de bordures, de couleurs de fond
- Appliquez le mouvement là où il ajoute du sens (survol, focus, transitions)
Exigences de la Page du Laboratoire
La page du Laboratoire de Design doit inclure :
-
En-tête avec :
- Résumé du Cahier des Charges de Design (cible, périmètre, exigences clés)
- Instructions pour l'examen
-
Grille de Variantes avec :
- Étiquettes claires (A, B, C, D, E)
- Justification brève pour chaque variante (« Pourquoi elle existe »)
- Le rendu réel de la variante