Quand engineering a besoin d’une spec, /writing-specs-designs produit un breadboard et un shaping doc pour construire la bonne chose en un sprint. — Claude Skill
Une compétence Claude pour Claude Code par Refound — exécuter /writing-specs-designs dans Claude·Mis à jour le 1 juin 2026
Rédigez breadboards Shape Up, shaping docs et croquis fat-marker.
- Méthode Shape Up de Ryan Singer : breadboarding, fat marker sketches, 10 pièces mobiles ou moins, rabbit holes et no-gos
- Pattern whiteboard low-fi (Christina Wodtke) : dessiner volontairement mal pour inviter les corrections
- Triage prototype-first (Noah Weiss, Tamar Yehoshua) : quand passer au code plutôt qu’aux mocks statiques
- Rigueur pixel-level Nikita Bier pour flows consumer zero-to-one : chaque tap est un miracle
- Audit permanence Tom Conrad : signaler les raccourcis temporaires qui deviendront du legacy permanent
Pour qui
Ce qu'il fait
Votre PRD contient 8 pages de prose et aucun diagramme. /writing-specs-designs le convertit en breadboard Ryan Singer avec 10 pièces mobiles ou moins, affordances nommées et connexions : l’équipe voit « l’électricité dans les murs » en une lecture.
Les designers ont produit 6 explorations Figma et personne ne choisit. /writing-specs-designs applique la règle prototype-first de Noah Weiss, garde les 2 variantes qui méritent du code et définit un build jetable 3 jours pour sentir la différence.
Vous shippez la v1 mobile et chaque tap compte. /writing-specs-designs applique la règle d’ownership pixel de Nikita Bier et mappe chaque tap du flow cœur à la valeur livrée, avec bounce-killers signalés.
Vous êtes PM et dépendez d’un designer pour chaque concept. /writing-specs-designs construit un sketch niveau Balsamiq (méthode Ravi Mehta) en 15 minutes : assez pour débloquer la conversation engineering.
Le CEO a approuvé « ajouter collaboration » et c’est tout. /writing-specs-designs lance un shaping pass : problème, appetite, outline solution, rabbit holes, no-gos et breadboard auquel l’équipe peut s’engager sur 6 semaines.
Fonctionnement
Partagez l’idée feature, le problème et l’appetite (temps que vous acceptez de dépenser)
Identifiez 10 pièces mobiles ou moins : affordances, connexions et comportements système clés
Produisez un fat-marker sketch ou breadboard sans détail UI qui montre le flow
Signalez rabbit holes, no-gos et risques de raccourcis temporaires (audit Tom Conrad)
Recevez un shaping doc : problème, outline solution, breadboard, risques et résumé prêt à pitcher
Exemple
Feature : ajouter des commentaires inline aux graphiques dashboard analytics Problème : les équipes screenshot les graphiques et discutent dans Slack, perdant le contexte Appetite : cycle 4 semaines Contraintes : doit fonctionner sur graphiques embedded dans portails clients
1. Affordance commentaire au hover graphique 2. Panneau thread (slide-in) 3. @mention membres workspace 4. Lien vers état exact du graphique 5. Notification email + in-app 6. État résolu 7. Check permissions sur embeds 8. Badge nombre de commentaires
Hover graphique -> bouton [Ajouter commentaire] -> panneau thread ouvre -> taper + @mention -> publier -> notification envoyée -> destinataire clique deep link -> arrive sur état exact du graphique -> répond inline -> résout
- Collab temps réel (multi-cursor) : NO-GO, pas en 4 semaines - Rich text : NO-GO, texte simple - Réponses threadées : ambigu, rabbit hole - Permissions embed : rabbit hole, spike avant engagement
« Utiliser le picker @mention existant façon Slack » -> ok, réutilisable. « Hard-coder le template email dans l’app » -> deviendra du legacy permanent, flag refactor plus tard. Prêt à pitcher : oui, avec 2 rabbit holes scopés en spike semaine 1.
Métriques améliorées
Compatible avec
Envie d'utiliser Rédaction de specs et designs ?
Choisissez comment commencer.
Installez et exécutez cette compétence localement sur votre ordinateur.
Ouvrez un terminal sur votre ordinateur et collez cette commande :
Cela télécharge la compétence avec tous ses fichiers sur votre ordinateur :
Ajoutez -g à la fin pour le rendre disponible dans tous vos projets.
Démarrez Claude Code, puis tapez la commande :
Writing Specs & Designs
Aidez l’utilisateur à produire une spec que l’équipe peut comprendre, discuter et construire.
Comment aider
- Choisir le niveau de fidélité - Alignement conceptuel low-fi ou guidance d’implémentation high-fi.
- Préférer prototype à polish - Aller vers le prototype fonctionnel quand il clarifie mieux qu’un document statique.
- Montrer les pièces mobiles - Affordances, connexions, comportements système et états clés.
- Voir le long terme - Les raccourcis temporaires deviennent souvent permanents.
Principes clés
Un bon breadboard montre le flux sans se perdre dans l’UI. Un croquis imparfait invite les corrections. Les no-gos et rabbit holes valent autant que la solution, car ils protègent l’appetite.
Sortie attendue
Livrez problème, appetite, moving pieces, breadboard, risques, no-gos, décisions ouvertes et résumé prêt à pitcher.