Communitygithub.com

prototype-first

Affiche des options de design sous forme de prototypes et obtient une sélection avant de construire quoi que ce soit. À utiliser pour un nouvel écran, un nouveau flux, une refonte, un site web ou une page d'atterrissage, toute demande de « montre-moi des options » ou « peux-tu prototyper », et toute question UX ayant plus d'une réponse raisonnable. Couvre également la manière de construire à partir d'un prototype sélectionné.

Qu'est-ce que prototype-first ?

Cette compétence « prototype-first » est conçue pour les agents IA (comme Claude Code, Cursor, Codex) et leurs utilisateurs. Son objectif central est d'éviter le gaspillage de développement en forçant une décision de design basée sur un prototype avant d'écrire le moindre code de production. Elle s'applique à tout scénario où plusieurs réponses de design sont possibles, comme un nouvel écran, un flux ou une page web. La compétence impose un flux de travail strict en plusieurs phases : analyse des références, création de variantes de prototypes (2 à 4), présentation pour validation, et construction à partir du prototype choisi. Elle interdit catégoriquement toute pull request (PR) de prototype, toute construction avant validation, et l'utilisation de termes de prototype (comme « variante B ») dans le code final. Les prototypes doivent être créés avec des données réalistes, dans le contexte réel de l'application (composants, tokens, modes clair/sombre), et avec un niveau de finition adapté à la question posée (visuelle ou fonctionnelle). L'utilisateur est guidé par des règles de validation claires, et la compétence capture également la raison du choix pour améliorer les futures itérations.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xa3k5/skills/tree/main/skills/prototype-first

Demander à votre IA préférée

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

Documentation

Prototyper d'abord

Je suis designer. Je juge un travail en le regardant et en cliquant dessus, pas en lisant un plan. Un prototype coûte des minutes. Construire la mauvaise chose coûte une pile de PR et une journée de relecture.

Cette compétence ne fait qu'une chose : obtenir une sélection de design de ma part avant que du code ne soit écrit. Elle n'ouvre jamais de PR pour un prototype, ne livre jamais un prototype comme produit, et ne construit jamais une direction que je n'ai pas choisie.

Règles strictes

  1. N'ouvrez jamais de PR pour un prototype, pas même un brouillon. Les PR sont pour le code destiné à atterrir sur main. Une PR de prototype ajoute du bruit de relecture et d'IC pour quelque chose qui sera jeté.
  2. Arrêtez-vous après chaque tour. Envoyez les variantes dans le format ci-dessous, puis attendez ma réponse. Ne commencez pas à construire « le choix le plus probable » pendant que je regarde. Si je choisis autre chose, ce travail est du gaspillage et je dois de toute façon le relire.
  3. Le prototype choisi est le cahier des charges. La construction doit lui ressembler. Les retours ultérieurs ne modifient que ce que je nomme. Je compare la construction à l'image que j'ai choisie, donc toute dérive est interprétée comme une erreur, pas comme une amélioration.
  4. Les étiquettes de prototype restent dans les fichiers de prototype. « B2 », « direction A » et les surnoms de variantes n'apparaissent jamais dans le code, les tokens, les commits, les PR ou les issues. Ils n'avaient de sens que pendant la sélection. Dans la base de code, ce sont du bruit que quelqu'un devra décoder plus tard.
  5. Regardez les références en tant qu'images. Lorsque je nomme des sites ou applications de référence, regardez leurs captures d'écran. Une recherche en texte seul perd toutes les qualités visuelles qui rendaient la référence bonne, et le résultat semble générique.

Ceci devrait-il être un prototype ?

Est-ce que le changement a une réponse évidente (une valeur d'espacement, une étiquette, un token de couleur) ?
├── Oui → Construisez-le et dites ce qui a changé. Sauter le prototype est un bon résultat.
└── Non
    ├── Nouvel écran, nouveau flux, refonte, ou 2+ réponses raisonnables ?
    │   └── Oui → Prototype.
    │       ├── Besoin de vraies données, vraie navigation ou comportement natif ?
    │       │   └── Oui → Branche jetable `proto/<sujet>` à partir de main
    │       └── Non → Fichier HTML autonome, partagé dans le chat ou le fil de l'issue
    └── Incertain → Demandez en une ligne : « prototyper ceci ou simplement le construire ? »

Ne cachez jamais un prototype à l'intérieur du produit derrière une route /lab ou un drapeau de développement.

Flux de travail

Phase 1 : Références et questions

  1. Collectez des captures d'écran de chaque référence que j'ai nommée. Découpez les longues pages en sections.
  2. Écrivez des observations concrètes pour chacune : le type, le traitement des titres, comment le produit est montré, comment la mise en page est structurée et le moment qui se démarque. Dites pourquoi chacune fonctionne.
  3. Questionnez la demande. Si ce que j'ai demandé est une UX faible, dites-le et dites pourquoi. Pensez du côté de l'utilisateur final, pas du correctif littéral que j'ai décrit.
  4. Posez-moi quelques questions courtes et numérotées sur ce que vous ne pouvez pas déduire, comme le type, la densité, le ton et ce qu'il faut conserver de la version actuelle.

Terminé quand : chaque référence a des observations écrites, et j'ai répondu à vos questions ou vous n'en aviez pas.

Phase 2 : Construire les variantes

  • Montrez 2 à 4 variantes, étiquetées A, B, C et D. Une variante ne m'apprend rien sur mon goût. Plus de quatre est du bruit.
  • Au moins une variante est votre propre meilleure idée si vous avez contesté en Phase 1. Placez-la à côté de celle que j'ai demandée.
  • Maquettez en contexte. Montrez la fenêtre ou la section entière, pas un composant flottant sur une page blanche.
  • Utilisez le design réel. Utilisez les tokens, types et composants actuels de l'application. Montrez les modes clair et sombre si l'application a les deux.
  • Utilisez des données réalistes. Des noms, chiffres et longueurs de texte qui ont l'air réels. Jamais de lorem ipsum, et jamais de données de personnes ou de lieux réels.
  • Rendez les flux cliquables. Pour tout ce qui a des étapes ou des états, construisez un fichier HTML avec un sélecteur de scénario, un basculement clair/sombre, des interactions fonctionnelles et une note en mots simples sur ce que chaque état signifie.
  • Faites correspondre le niveau de finition à la question. Pour une direction visuelle, cela ressemble au produit fini, car l'apparence est ce que je juge. Pour un flux, cela ressemble à l'application et fonctionne, et la finition de détail peut attendre, car je juge si je me perds.

Terminé quand : chaque variante est maquettée en contexte avec des tokens réels et des données réalistes, et chaque flux est cliquable.

Phase 3 : Envoyer le tour et s'arrêter

Envoyez le tour dans le format sous « Format de sortie requis ». Puis arrêtez-vous.

Terminé quand : le tour est envoyé. Rien d'autre ne se produit jusqu'à ce que je réponde.

Phase 4 : Lire ma sélection

Je disÇa signifieVous faites
« C »Construire C tel que montréAller en Phase 5
« D, mais 1,5px pas 3px »D avec exactement ce changementChanger uniquement cela, puis Phase 5
« Les boutons de A, la barre de recherche de C »Un mélangePrendre chaque partie nommée de la variante dont je l'ai nommée. La partie que je dis aimer le plus domine. Ne dérivez pas vers la variante la plus facile à construire.
« J'aime B mais je veux le tester »Une sélection provisoireConstruire B, et garder le finaliste jusqu'à ce que j'aie essayé B dans la vraie application ou sur l'appareil
Retour sur une varianteItérerMontrer le tour suivant de cette variante uniquement, retour à la Phase 3
« Je ne comprends pas ce prototype »Arrêter le prototypageConstruire la vraie chose dans une PR
« Aucun de ceux-ci »Vous avez manqué mon intentionRevenez aux références et à mes mots. Ne faites pas une quatrième version de la même idée.

Demandez pourquoi quand je ne le dis pas. Si je choisis sans donner de raison, posez une question courte : « Qu'est-ce qui a fait gagner B ? » Enregistrez ma réponse avec la décision. Un choix sans sa raison n'apprend rien au prochain agent sur mon goût.

Terminé quand : vous savez quelle variante, ou quel mélange de parties, construire, et pourquoi.

Phase 5 : Construire à partir du choix

  • Expliquez à la personne qui construit le lien vers le prototype et les valeurs exactes : couleurs, tailles, espacements et type. Personne ne reconstruit de mémoire.
  • Décrivez le design par ce qu'il est (« tableau dense, pastilles d'état, rail gauche »), jamais par son étiquette.
  • Appliquez les retours généraux ultérieurs (« trop chargé », « pas de hiérarchie ») uniquement là où j'ai pointé. Ce n'est pas une permission de supprimer des choses que j'ai aimées dans le prototype. Avant de supprimer ou de modifier un élément du prototype, nommez-le et demandez.

Terminé quand : la construction correspond au choix, et aucune étiquette de prototype n'apparaît dans le code, les commits, la PR ou les issues.

Format de sortie requis

Chaque tour ressemble à ceci :

**Où le voir :** <lien ou pièce jointe>, ou `git checkout proto/<sujet> && <commande d'exécution>`

| Variante | Pari sur | Compromis |
| --- | --- | --- |
| A | <une ligne : l'idée que cette variante teste> | <ce qu'elle abandonne> |
| B | ... | ... |

**Ce sur quoi j'ai contesté :** <une ou deux lignes, ou « rien »>

Répondez par une lettre, un mélange (`le x de A, le y de C`), ou `aucun`.

Tenez-vous-en à cela. Le prototype fait l'explication.

Variantes d'invocation

InvocationComportement
/prototype-firstFlux complet depuis la Phase 1, s'arrête après la Phase 3
/prototype-first <variante>Itérer sur une variante du dernier tour, retour à la Phase 3
/prototype-first compareUn prototype avec un basculement MAINTENANT / PROPOSÉ par rapport à l'UI actuelle

Skills associés