On parle beaucoup de « prompts » : le bon prompt, le prompt magique, les listes de prompts à copier-coller. Quand on démarre un projet avec un agent IA, on n’écrit pas un prompt. On écrit un brief, celui qu’on donnerait à un stagiaire le jour de son arrivée.
La différence paraît mince. Elle change pourtant le résultat.
Le prompt demande, le brief explique
Un prompt est une demande : « Crée-moi une application de prise de rendez-vous. » L’IA répond, et vite. Mais pour répondre, elle doit deviner tout ce que vous n’avez pas dit : pour qui, sur quel serveur, avec quelle technologie, avec ou sans espace d’administration, avec quel niveau de sécurité. Chaque vide est rempli par un choix par défaut. Parfois ça tombe juste, souvent non.
Un brief pose le cadre de la mission avant de parler du travail à faire. Pensez à un stagiaire : on ne lui dit pas « fais-moi un site » avant de repartir dans son bureau. On lui présente le client, l’objectif, les outils de la maison, ce qui est permis et ce qui ne l’est pas, et ce qu’on attend à la fin. Une IA fonctionne de la même façon.
Ce que contient un bon brief
Pour une application, voici ce qu’on détaille avant d’écrire la moindre ligne de code.
Ce qu’est le projet. Deux ou trois phrases sur ceux à qui il sert et sur sa raison d’être. Un espace de suivi pour des clients ne se conçoit pas comme un outil interne qu’une seule personne utilisera.
Ce qu’il doit faire. Les fonctions attendues, une par une, écrites comme des actions plutôt que comme des idées vagues : « le client se connecte », « il voit l’avancement de son projet », « il reçoit un e-mail quand une étape est validée ».
Le résultat attendu. Ce que « terminé » veut dire : une maquette, une version en ligne, des tests qui passent. Sans cette précision, l’IA s’arrête quand elle estime avoir fini, et son idée de « fini » n’est pas forcément la vôtre.
L’ergonomie. Simple ou riche, pensée d’abord pour le téléphone ou pour l’ordinateur, le style visuel, la largeur des pages. Sans indication, vous obtenez l’interface générique que tout le monde reconnaît au premier coup d’œil.
La technologie. HTML, PHP, un framework précis, une base de données ou non. Vous avez vos habitudes et vos raisons, et l’IA n’a aucun moyen de les connaître.
L’hébergement. Où l’application sera installée : un hébergement mutualisé, un serveur dédié, un service dans le cloud. Tout ne fonctionne pas partout, et ce choix en entraîne beaucoup d’autres.
Une administration ou non. Le client doit-il pouvoir modifier ses contenus lui-même ? Si oui, il faut un espace d’administration, une connexion et des droits. C’est un autre projet.
La sécurité. C’est le point à détailler le plus, en particulier la protection du code une fois sur le serveur. Un dossier .git lisible depuis un navigateur, un fichier de configuration avec les mots de passe accessible en ligne, des identifiants écrits directement dans le code : ce sont autant de portes ouvertes au piratage. Le brief doit demander noir sur blanc que les mots de passe restent hors du dépôt de code, que les fichiers sensibles soient inaccessibles depuis Internet et que les formulaires soient protégés. L’IA sait faire tout cela, mais elle ne le fait pas toujours d’elle-même. (Le dépôt de code, c’est l’historique de votre projet : nous l’expliquons dans GitHub pour les nuls.)
Plus le brief est précis, moins l’IA improvise
C’est la règle qu’on retient après de nombreux projets : plus le brief est détaillé, plus l’IA sait où elle va, et moins elle improvise.
Une IA n’est pas paresseuse, elle est obligeante. Quand une information manque, elle ne s’arrête pas toujours pour poser la question : elle comble. Elle choisit une technologie, une organisation des fichiers, un style. Le résultat a l’air propre, puis on passe des heures à défaire ce qu’elle a décidé à notre place.
Un bon brief prend dix ou quinze minutes à écrire, et il en fait gagner bien plus.
La dernière question à poser
À la fin du brief, ajoutez une demande : « Propose des éléments supplémentaires auxquels je n’aurais pas pensé. »
C’est souvent là qu’arrivent les meilleures idées. Une fois qu’elle a tout le contexte, l’IA peut jouer son rôle de collègue : elle signale une fonction utile, un risque oublié ou une simplification possible. Vous gardez ce qui vous convient et laissez le reste. Le brief reste le vôtre, il s’enrichit simplement.
C’est ce qu’on attend d’un bon stagiaire : qu’il suive les consignes, puis qu’il ose dire « et si on ajoutait ça ? ».
Un exemple de brief court
- Projet : une page de suivi pour les clients d’un studio web. Chaque client voit l’avancement de son site.
- Fonctions : une page par client, une barre de progression de 0 à 100 %, la liste des étapes faites et à faire.
- Résultat attendu : une version en ligne, vérifiée sur téléphone et sur ordinateur.
- Ergonomie : sobre, lisible, fond clair.
- Technologie : HTML et PHP, sans base de données.
- Hébergement : un hébergement mutualisé classique.
- Administration : aucune, le studio fait les mises à jour.
- Sécurité : aucun mot de passe dans le dépôt, dossier
.gitet fichiers de configuration inaccessibles depuis Internet, pages clients non indexées par les moteurs de recherche. - Pour finir : propose des éléments supplémentaires utiles.
En dix lignes, l’IA sait pour qui elle travaille, ce qu’elle doit livrer et les limites à respecter.
En résumé
Pour une question rapide, un prompt suffit. Pour un vrai projet, un brief vaut mieux. Traitez votre IA comme un stagiaire compétent tout juste arrivé : expliquez le contexte, fixez le cadre, dites ce que vous attendez, et laissez-lui la place de proposer. Le principe vaut aussi quand on relie l’IA à ses e-mails : voir Claude Code et Gmail.
Vous avez un projet d’application ou de site et ne savez pas par où commencer le brief ? Écrivez-nous, on le prépare avec vous.
Questions fréquentes
Un prompt est une demande ponctuelle, souvent en une phrase. Un brief décrit tout le cadre d’un projet : l’objectif, les fonctions, le résultat attendu, la technologie, l’hébergement et la sécurité. Le prompt convient à une question rapide ; le brief est fait pour un projet qui va durer plusieurs heures ou plusieurs jours.
Non, tant qu’il reste clair. Les outils actuels lisent sans difficulté plusieurs pages de consignes. Ce qui les gêne, ce sont les consignes floues ou contradictoires. Rangez votre brief par rubriques, une idée par ligne, et précisez ce qui est obligatoire et ce qui est seulement souhaité.
Pas en entier. Gardez le brief dans un fichier du projet et demandez à l’IA de le relire au début de chaque session. Quand une décision change en cours de route, mettez le fichier à jour : il devient la référence du projet, pour l’IA comme pour vous.
Je développe, maintiens et optimise des sites web, référencement, mises à jour. Le reste du temps… c’est la famille, et les jeux vidéo.