Aller au contenu

Catégorie L · Créer avec l'IA · Épreuve 4 sur 8 · 5 min

Écrire un cahier des charges pour une IA

Mis à jour le

Un homme debout dans un atelier sourit en travaillant sur un ordinateur portable posé sur un établi.
Objectif · Rédiger un cahier des charges clair pour un site ou un outil, avec ce qui est hors sujet, et faire avancer l'IA par petites étapes vérifiables.Photo : javier trueba sur Unsplash

Un bon cahier des charges pour une IA dit à qui sert l'outil, ses pages, ce que chaque visiteur peut faire, des exemples réels, les règles d'accès, ce qui est hors sujet et comment vérifier que ça marche. Ensuite, on construit une fonction à la fois, en testant après chaque étape.

  1. 01
  2. 02
  3. 03
  4. 04
  5. 05
  6. 06
  7. 07
  8. 08
  9. 09

Étape 1 sur 9

La liste de courses du projet

Quand une information manque, l'IA ne s'arrête pas : elle invente. Le cahier des charges, c'est la liste de courses de ton projet. Sans liste, tu reviens du magasin avec ce qui te tentait, pas avec ce qu'il te fallait.

Sept rubriques suffisent :

  1. Le but et le public : à quoi sert l'outil, pour qui.
  2. Les pages : accueil, formulaire, tableau…
  3. Les fonctions : ce que chaque visiteur peut faire, avec un verbe (« réserver », « filtrer »).
  4. Des exemples réels : trois vraies fiches, un vrai tarif, une vraie phrase.
  5. Les règles : qui voit quoi, ce qui est enregistré.
  6. Le hors sujet : ce qu'on ne fait pas dans cette version.
  7. Le test final : comment savoir que c'est fini.

La documentation de Claude Code le résume ainsi : les cahiers des charges les plus utiles disent ce qui est hors sujet et se terminent par une vérification de bout en bout, qui prouve que la fonction marche.

Nadia, assistante maternelle, prépare un petit site pour les parents. Relie chaque rubrique à sa ligne.

Touche un élément à gauche, puis celui qui va avec à droite.

Un modèle prêt à copier

Voici le cahier des charges de Nadia. Copie-le et remplace ce qui est entre crochets.

« But : un petit site privé pour [les parents des enfants que je garde à Rennes]. Pages : accueil ; menu de la semaine ; horaires de dépôt et de reprise ; messages. Fonctions : je publie le menu chaque lundi ; chaque parent lit le menu, voit les horaires et m'écrit un message. Exemples : [menu du lundi : carottes râpées, hachis parmentier, compote]. Règles : un compte par famille ; un parent ne voit que ses propres messages ; aucune photo d'enfant. Hors sujet : paiement, facturation, discussion de groupe. Test final : avec deux comptes parents, chacun ne voit que ses messages. S'il manque une information, signale-la au lieu de l'inventer. Pose-moi d'abord tes questions, puis propose un plan en étapes, sans rien construire. »

Les deux dernières phrases viennent de conseils officiels : OpenAI recommande de faire signaler les informations manquantes plutôt que de les laisser combler, et Anthropic propose de se faire interviewer par l'IA avant d'écrire le cahier des charges.

Quelle ligne a sa place dans la rubrique « hors sujet » du cahier des charges de Nadia ?

Avancer par petites étapes

Un cahier des charges complet ne veut pas dire tout construire d'un coup. L'aide de Bolt conseille de poser d'abord la base, puis d'ajouter une fonction à la fois, en testant après chacune :

  • d'abord les pages principales et la navigation ;
  • puis un formulaire simple ;
  • puis l'enregistrement et l'affichage des données ;
  • enfin la recherche, les filtres, les statistiques.

À chaque étape, dis ce qui doit rester intact : « ajoute le filtre par jour, sans toucher aux messages ni aux comptes ». La documentation de Sites, chez OpenAI, conseille la même chose : un changement à la fois, en précisant ce qu'il faut garder, puis tester ce qui a bougé.

Dernier réflexe, proposé par Anthropic : une fois le cahier des charges écrit, repars d'une conversation neuve pour la construction. L'IA y travaille avec un contexte propre et ton document comme seule référence.

Remets dans l'ordre la construction conseillée par l'aide de Bolt.

Touche les étiquettes dans le bon ordre. Touche une étiquette placée pour la retirer.

Vrai ou faux ?

Pour économiser, il vaut mieux demander toutes les fonctions dans un seul énorme message de construction.

Pour éviter que l'IA comble les trous à sa façon, demande-lui de …… les informations manquantes.

Ce que l'IA ne te dira pas

Sur Hacker News, un créateur raconte que l'IA de Bolt a retiré d'elle-même une protection de sécurité de son site, puis a continué ses « réparations » malgré son « non » explicite : 10 millions de jetons partis en changements qu'il n'avait pas demandés. Écris dans ton cahier des charges ce qu'il ne faut jamais toucher, et vérifie chaque changement avant d'en demander un autre.

Source : Hacker News, « Ask HN: Startup launch destroyed by Bolt.new's AI. 10M tokens gone, no response » (décembre 2025)

Sources