Le cahier des charges avant le prompt : un PRD que l'IA comprend
Lire en : English

Sommaire
- Pourquoi écrire un cahier des charges avant le premier prompt ?
- Que doit contenir un PRD que l'IA comprend ?
- Le modèle de PRD à copier
- Un exemple rempli : la carte de fidélité d'une boulangerie
- Où ranger le cahier des charges dans ton outil ?
- Faire écrire le PRD par l'IA, sans la laisser décider
- Les erreurs qui rendent un PRD inutile
- Comment faire vivre le cahier des charges pendant le projet ?
- Questions fréquentes
- Questions fréquentes
- Sources
Un cahier des charges pour l'IA, ou PRD (Product Requirements Document), est un document d'une ou deux pages qui dit ce que l'app doit faire, pour qui, et ce qu'elle ne fera pas. Tu l'écris avant le premier prompt, tu le donnes à l'outil comme contexte permanent, et l'IA arrête d'inventer à ta place. Voici les 8 rubriques qui comptent, un modèle à copier, un exemple rempli et l'endroit où le ranger selon ton outil.
Pourquoi écrire un cahier des charges avant le premier prompt ?
Sans cahier des charges, l'IA comble chaque trou avec un choix par défaut, et tu passes ton temps à corriger des décisions que tu n'as jamais prises. Un prompt décrit une tâche ; le cahier des charges décrit le projet dans lequel cette tâche s'inscrit.
GitHub résume le changement de logique dans son billet de lancement de Spec Kit, son kit open source pour le développement guidé par les spécifications :
We're moving from "code is the source of truth" to "intent is the source of truth.
— GitHub Blog
Concrètement, un bon PRD t'apporte trois choses :
- Des prompts plus courts : le contexte est déjà écrit, tu n'as plus à le répéter.
- Moins de dérive : quand l'IA propose une fonction hors sujet, tu as une référence pour dire non.
- Une définition de « terminé » : tu sais quand une fonction est finie, et tu peux demander à l'IA de vérifier son travail contre le document.
Si tu débutes, commence par le guide complet du vibe coding pour voir où le cahier des charges s'insère dans la démarche.
Que doit contenir un PRD que l'IA comprend ?
Un PRD efficace pour l'IA contient 8 rubriques courtes. Les documentations des outils convergent : Lovable recommande de décrire ce que fait l'application, les profils d'utilisateurs, le schéma de données, les décisions d'architecture, le vocabulaire métier, les contraintes du projet, les règles de design et les exigences de sécurité. GitHub insiste sur les parcours utilisateurs et sur ce à quoi ressemble la réussite.
| Rubrique | Ce que tu écris | Pourquoi l'IA en a besoin |
|---|---|---|
| 1. Problème | Une ou deux phrases sur le problème résolu | Pour arbitrer entre deux solutions |
| 2. Utilisateurs | Chaque profil, ce qu'il veut, ce qu'il peut faire | Pour gérer les droits et les écrans |
| 3. Parcours | Les 2 à 4 scénarios principaux, étape par étape | Pour construire dans le bon ordre |
| 4. Fonctions V1 | La liste numérotée, par priorité | Pour avancer une fonction à la fois |
| 5. Hors périmètre | Ce que la V1 ne fera pas | Pour éviter les ajouts non demandés |
| 6. Données | Les objets (client, commande…) et qui voit quoi | Pour la base de données et la sécurité |
| 7. Design | Style, couleurs, typographie, mobile ou ordinateur | Pour la cohérence entre les écrans |
| 8. Critères de réussite | Ce qui doit marcher pour dire « terminé » | Pour tester et vérifier |
Les rubriques 5 et 6 sont celles que tout le monde oublie, et celles qui évitent le plus de problèmes. Le hors-périmètre empêche l'IA de s'éparpiller. La règle « qui voit quoi » est la base de la sécurité de ton app.
Le modèle de PRD à copier
Copie ce modèle dans un document, remplis chaque rubrique en quelques lignes, et vise une à deux pages au total.
[Nom du projet] — Cahier des charges V1
## 1. Problème
[Une ou deux phrases : quel problème, pour qui, aujourd'hui résolu comment.]
## 2. Utilisateurs
- [Profil 1] : [ce qu'il veut faire] — peut : [actions autorisées]
- [Profil 2] : [ce qu'il veut faire] — peut : [actions autorisées]
## 3. Parcours principaux
1. [Profil] [action 1] → [action 2] → [résultat attendu]
2. ...
## 4. Fonctions de la V1 (par priorité)
1. [Fonction indispensable]
2. [Fonction indispensable]
3. [Fonction utile]
## 5. Hors périmètre V1
- [Ce que l'app ne fera pas]
## 6. Données et accès
- [Objet] : [champs principaux] — visible par : [qui]
- Règle : un utilisateur ne voit jamais les données d'un autre utilisateur.
## 7. Design
[Style en 3 mots, couleurs, priorité mobile ou ordinateur, langue de l'interface.]
## 8. Critères de réussite
- [Scénario testable 1]
- [Scénario testable 2]
## Vocabulaire
- [Terme métier] : [définition]
La rubrique « Vocabulaire » est facultative mais utile dès que ton métier a ses mots. Lovable la recommande sous le nom de terminologie du domaine : si tu dis « prestation » et que l'IA comprend « produit », tes écrans ne parleront pas la langue de tes clients.
Un exemple rempli : la carte de fidélité d'une boulangerie
Voici le même modèle appliqué à un cas concret.
Fidélité Boulangerie — Cahier des charges V1
## 1. Problème
Les cartes de fidélité en carton se perdent. La boulangère veut une carte
sur téléphone : 10 achats = 1 viennoiserie offerte.
## 2. Utilisateurs
- Client : voit ses tampons et sa récompense — peut : créer son compte, afficher son QR code.
- Vendeur : ajoute un tampon — peut : scanner un QR code, valider une récompense.
- Gérante : suit l'activité — peut : voir le nombre de clients et de récompenses du mois.
## 3. Parcours principaux
1. Client : s'inscrit avec son e-mail → voit sa carte vide → montre son QR code en caisse.
2. Vendeur : scanne le QR code → ajoute un tampon → le client voit 1/10.
3. Client au 10e tampon : voit « Récompense disponible » → le vendeur la valide → la carte repart à 0.
## 4. Fonctions de la V1
1. Inscription et connexion du client par e-mail.
2. Carte avec compteur de tampons et QR code.
3. Écran vendeur : scan et ajout d'un tampon.
4. Validation de la récompense.
5. Tableau de bord gérante (2 chiffres).
## 5. Hors périmètre V1
- Paiement, commande en ligne, notifications, plusieurs boutiques.
## 6. Données et accès
- Client : prénom, e-mail, nombre de tampons — visible par : lui-même, vendeurs, gérante.
- Tampon : date, vendeur — visible par : vendeurs et gérante.
- Règle : un client ne voit jamais la carte d'un autre client.
## 7. Design
Chaleureux, simple, gros boutons. Mobile d'abord. Interface en français.
## 8. Critères de réussite
- Un client inscrit voit sa carte à 0/10 en moins de 2 minutes.
- Après 10 scans, la récompense apparaît ; après validation, le compteur revient à 0.
- Un client connecté ne peut pas afficher la carte d'un autre en modifiant l'adresse de la page.
Le dernier critère est un test de sécurité déguisé. C'est exactement le genre de faille qu'on retrouve dans les apps vibe codées mal configurées, et que la checklist sécurité avant de mettre en ligne t'aide à traquer.
Où ranger le cahier des charges dans ton outil ?
Chaque outil a un endroit pour les instructions permanentes, lues à chaque demande. Mets-y une version condensée du PRD, et garde la version complète dans un fichier du projet.
| Outil | Où mettre le PRD | À savoir |
|---|---|---|
| Lovable | Les instructions du projet (Knowledge) | Lovable distingue les règles communes à tout l'espace de travail et le contexte propre à un projet |
| Bolt | Project knowledge | La documentation la réserve aux informations qui s'appliquent toujours au projet ; elle persiste même quand tu réinitialises le contexte |
| Claude Code | Un fichier SPEC.md dans le projet, et les règles durables dans CLAUDE.md | La documentation recommande de garder CLAUDE.md court |
| Cursor, Codex, GitHub Copilot et d'autres agents | Un fichier AGENTS.md à la racine du projet | Format ouvert présenté comme « un README pour les agents » |
Pour aller plus loin sur ces fichiers de contexte, on y consacre un article : CLAUDE.md, AGENTS.md et rules.
Faire écrire le PRD par l'IA, sans la laisser décider
Tu peux faire rédiger ton cahier des charges par l'IA, à condition qu'elle te pose les questions au lieu d'inventer les réponses. L'ingénieur Addy Osmani recommande d'ailleurs de partir d'une conception solide et de faire aider l'IA à écrire la spécification avant de générer le moindre code. La documentation de Claude Code propose exactement ça : demander à l'agent de t'interviewer jusqu'à pouvoir écrire la spécification dans un fichier, puis démarrer une nouvelle session pour construire à partir de ce fichier.
Voici un prompt à utiliser dans n'importe quel assistant ou en mode plan :
Je veux créer [une phrase sur ton idée].
Interviewe-moi pour rédiger un cahier des charges de V1.
Règles :
1. Pose une seule question à la fois, avec des choix proposés quand c'est possible.
2. Couvre : problème, utilisateurs, parcours, fonctions V1, hors périmètre,
données et qui voit quoi, design, critères de réussite.
3. N'invente aucune réponse : si je ne sais pas, note « à décider ».
4. Quand tu as assez d'éléments, rédige le cahier des charges en une à deux pages,
avec des critères de réussite testables.
Ne génère aucun code.
Relis ensuite le résultat ligne à ligne. Tout ce que tu ne comprends pas ou que tu n'as pas décidé doit être reformulé ou supprimé.
Les erreurs qui rendent un PRD inutile
Un PRD raté est souvent trop long, trop technique ou jamais mis à jour.
- Trop long : 15 pages diluent l'essentiel. Lovable signale que dans les conversations très longues et chargées en contexte, ses instructions ne sont pas toujours suivies de façon constante. Court et précis l'emporte.
- Trop technique trop tôt : si tu imposes une base de données sans savoir pourquoi, tu crées des contraintes inutiles. Décris le besoin, laisse le plan proposer la technique, puis valide.
- Pas de hors-périmètre : sans cette rubrique, l'IA ajoute des fonctions « utiles » que tu devras maintenir.
- Des critères flous : « l'app doit être rapide » ne se teste pas. « La liste s'affiche en moins de 2 secondes sur un téléphone » se teste.
- Un document figé : le PRD de la première semaine ne décrit plus l'app de la troisième.
D'autres pièges classiques sont listés dans les 12 erreurs qui font échouer un projet en vibe coding.
Comment faire vivre le cahier des charges pendant le projet ?
Le cahier des charges reste utile si tu le mets à jour après chaque fonction terminée et si tu t'en sers pour vérifier le travail de l'IA.
- Référence-le dans tes prompts : « Implémente la fonction 3 du cahier des charges. »
- Fais vérifier contre lui : la documentation de Claude Code suggère de demander une relecture des modifications par rapport au fichier de spécification, pour vérifier que chaque exigence est implémentée.
- Mets-le à jour : coche les fonctions faites, ajoute les décisions prises en route, déplace les idées nouvelles vers une rubrique « V2 ».
- Sauvegarde-le avec le code : si tu utilises Git, le PRD versionné te dit à quoi correspondait chaque version.
Cette discipline, poussée plus loin, s'appelle le spec-driven development. Et pour écrire les prompts qui s'appuient sur ton PRD, suis la méthode du prompt de vibe coding en 5 étapes.
Questions fréquentes
Questions fréquentes
Quelle est la différence entre un cahier des charges et un prompt ?
Le cahier des charges décrit le projet entier : utilisateurs, fonctions, limites, données et critères de réussite. Il reste stable et sert de référence. Le prompt décrit une tâche précise à un instant donné, comme ajouter une fonction ou corriger un bug. Un bon prompt s'appuie sur le cahier des charges au lieu de répéter tout le contexte à chaque fois.
Quelle longueur doit faire un PRD pour le vibe coding ?
Une à deux pages suffisent pour une première version. L'objectif est que l'IA et toi sachiez ce qui est dedans, ce qui est dehors et comment vérifier que c'est fini. Au-delà, le document devient difficile à tenir à jour et les points essentiels se perdent. Mets une version condensée dans les instructions de l'outil et la version complète dans un fichier.
Faut-il connaître la technique pour écrire un cahier des charges ?
Non. Le cahier des charges décrit ce que l'app doit faire et pour qui, pas comment la coder. Le billet de GitHub sur Spec Kit le dit : la spécification porte sur les parcours utilisateurs et la réussite, la technique vient ensuite dans le plan. Tu peux laisser l'outil proposer les technologies, puis demander qu'il t'explique ses choix.
L'IA peut-elle écrire le cahier des charges à ma place ?
Elle peut le rédiger, mais pas le décider. La bonne méthode consiste à lui demander de t'interviewer, une question à la fois, et de noter « à décider » quand tu n'as pas la réponse. Relis ensuite le document ligne à ligne : tout ce que tu n'as pas choisi toi-même doit être validé ou retiré.
Faut-il refaire le cahier des charges quand le projet change ?
Pas le refaire, le mettre à jour. Après chaque fonction terminée, coche-la, ajoute les décisions prises en route et range les nouvelles idées dans une liste pour la version suivante. Un cahier des charges à jour te permet de reprendre le projet après une pause, et de demander à l'IA de vérifier son travail contre une référence fiable.
Sources
- Spec-driven development with AI: get started with a new open source toolkit — GitHub Blog
- Instructions (Knowledge) — Lovable Docs
- Prompting best practices — Lovable Docs
- Manage project context — Bolt Support
- Best practices for Claude Code — Claude Code Docs
- AGENTS.md — format ouvert pour guider les agents de code
- Vibe coding is not the same as AI-Assisted engineering — Addy Osmani


