MODULE 42 / 72
📝
Écrire une user story et un spec technique : parler à tout le monde
La user story : l'unité de base du produit. Format standard : 'En tant que [qui], je veux [quoi] pour [pourquoi].' Exemple : 'En tant qu'acheteur, je veux recevoir un email de confirmation après ma commande pour être sûr qu'elle a bien été prise en compte.' La user story n'est pas une spec technique — c'est un rappel du contexte humain derrière chaque feature.
Les critères d'acceptance : la définition de 'terminé'. Chaque user story doit avoir des critères d'acceptance clairs. Format : 'Étant donné [contexte], quand [action], alors [résultat attendu].' Exemple : 'Étant donné qu'un utilisateur vient de passer commande, quand le paiement est confirmé par Stripe, alors il reçoit un email dans les 2 minutes avec le récapitulatif.' Ces critères permettent à un dev, un designer, et un testeur de savoir exactement quand la feature est terminée.
Le spec technique no-code : ce qu'il doit contenir. (1) Le contexte et le problème (pas la solution). (2) Les endpoints API nécessaires (méthode, données, réponse attendue). (3) Le modèle de données (tables, champs, relations). (4) Les règles métier (conditions, validations, cas particuliers). (5) Les états d'erreur et leur gestion. (6) Les cas limites identifiés. Ce qui n'appartient pas au spec : les détails d'UI (ça va dans Figma), les choix d'implémentation du dev.
Documenter pour Xano/Supabase. Pour Xano : spécifier les API paths (GET /orders, POST /orders/{id}/cancel), les inputs et outputs de chaque endpoint, les préconditions de sécurité. Pour Supabase : spécifier les tables, les relations (FK), les RLS policies nécessaires, les triggers. Cette documentation est la base de votre conversation avec un dev ou avec vous-même dans 6 mois.
Le cahier des charges vs la spec agile. CdC traditionnel : document exhaustif écrit avant de commencer, long, difficile à mettre à jour. Spec agile : document vivant, mis à jour en continu, centré sur les décisions importantes. Pour un Product Builder : spec agile dans Notion ou Linear, avec des user stories liées aux tâches de développement. Le CdC complet est utile pour des projets avec un prestataire externe — il protège les deux parties.
⚡ ANALOGIE — LE PLAN D'ARCHITECTE
La user story = la demande du client ('je veux un salon lumineux où recevoir des amis'). Le critère d'acceptance = les conditions de réception des travaux ('la pièce fait 25m², 3 fenêtres, prises aux normes'). Le spec technique = le plan d'architecte détaillé (dimensions exactes, matériaux, passages électriques). Le CdC = le contrat avec le maître d'oeuvre. Sans plan d'architecte, chaque artisan interprète à sa façon et le résultat est un désastre. Trop de plan d'architecte avant de valider avec le client, et vous construisez un chef d'oeuvre que personne ne veut.
📐 SCHÉMA
User Story
Critères d'acceptance
Modèle de données
Endpoints API
Règles métier
Cas d'erreur
💬 QUESTION INTERACTIVE
1/5
"Comment écrire un spec qui sera compris par un dev externe que vous n'avez jamais rencontré ?"
🎯 PIÈGE / QUESTION D'ENTRETIEN
Quelle est la différence entre une user story et un use case ?