Chapter 3 · Chapitre 3 · Rédiger un bon brief
3.2 Remplir ton brief avec Claude Code
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeTu n'as pas tout rempli ? Normal. Claude Code peut t'interviewer pour compléter ton brief, une question à la fois. Tu réponds avec les mots de ton métier, il met au propre.
Le vrai brief de l'Atelier Mona
Commençons par regarder ce que Claude Code a reçu pour construire le site de la démo. Voici le contenu du fichier brief.md, transcrit (les tarifs d'exemple sont remplacés par une mention entre crochets) :
Tu me fais un site vitrine simple pour l'Atelier Mona, petite fleuriste à Annecy.
Les services : bouquets du jour, fleurs de mariage, abonnement fleurs pour les bureaux.
Tu mets des tarifs indicatifs (marqués « exemple ») : [trois tarifs d'exemple].
Horaires : mardi-samedi 9h-19h, dimanche 9h-13h, fermé le lundi.
Un formulaire de contact (nom, e-mail, demande, message).
Un encart adresse/plan : 12 rue des Tilleuls, 74000 Annecy (adresse fictive).
Ambiance : douce, verts et crème, lisible sur mobile.
Sept lignes, et pourtant un site cohérent : trois services, trois cartes ; les horaires, un tableau ; « verts et crème », la palette. Un brief court mais précis donne déjà un résultat solide. Comparé au modèle de la leçon 3.1, il manque pourtant :
- la cible : qui sont les clients de Mona, qu'est-ce qui les inquiète ;
- le ton : aucune phrase réelle, donc des textes corrects mais neutres ;
- les preuves : rien, donc le site n'en affiche aucune (et c'est tant mieux, plutôt que d'en inventer) ;
- les photos : aucune, donc des illustrations dessinées en code ;
- le légal et la mise en ligne : rien, donc un pied de page qui affiche « Mentions légales : à compléter ».
Chaque trou se retrouve dans la liste « ce qui demande une intervention humaine » de etapes.md. Pour ton site, comble-les maintenant, avec une interview.
Pourquoi l'interview change tout
Une coiffeuse à domicile à Bordeaux sèche face à la case « Ce qui les inquiète ». Mais quand Claude lui demande « Qu'est-ce que tes clientes te demandent avant de réserver ? », les réponses viennent toutes seules : horaires, zone couverte, matériel apporté.
Pas à pas
- Vérifie que
brief.mdest bien dans ton dossier, même incomplet. - Ouvre Claude Code dans le dossier.
- Colle le prompt ci-dessous.
- Réponds honnêtement. Si tu ne sais pas, dis « à compléter ».
- Relis le brief final avant de valider.
Lis le fichier brief.md. Je veux que tu m'interviewes pour le compléter.
Pose-moi les questions une par une, en commençant par ce qui manque le plus (cible, offre, action principale attendue du visiteur).
Ne propose rien tant que le brief n'est pas complet.
À la fin, réécris brief.md proprement, en sections claires, et reporte l'essentiel dans CLAUDE.md.
N'invente aucune information : si je n'ai pas de réponse, note « à compléter ».
Pourquoi ce prompt marche :
- « Une par une » : tu n'es pas noyé sous un questionnaire.
- « Ne propose rien tant que... » : Claude ne part pas coder trop tôt.
- « N'invente aucune information » : pas de faux chiffres ni de faux avis sur ton site.
- Le report dans CLAUDE.md : l'essentiel du brief sert pour toute la suite, à chaque conversation.
Vérifie que Claude a bien compris
Avant de passer à la génération, fais-lui résumer ton projet. Ce prompt ne crée et ne modifie aucun fichier :
Contexte : je démarre le site vitrine de mon activité de [ton métier] à [ta ville]. Je ne sais pas coder. brief.md et CLAUDE.md sont dans ce dossier.
Objectif : vérifier que tu as bien compris mon projet avant de commencer.
Contraintes : ne crée et ne modifie aucun fichier.
Format attendu : un résumé en 5 lignes (activité, cible, offre, action principale, ton), puis la liste des questions qui manquent.
Validation : j'ai corrigé ton résumé et répondu aux questions avant toute création.
Si le résumé ne te ressemble pas, corrige-le maintenant, pas après cinq pages.
Bonus : t'inspirer de deux sites que tu aimes
Contexte : j'aime ces deux sites : [adresse 1] et [adresse 2] (ou captures jointes).
Objectif : comprendre ce qui me plaît pour l'appliquer à mon site, sans copier.
Contraintes : analyse seulement la structure, les espacements, les couleurs et le ton ; jamais leurs textes, images ou logos.
Format attendu : une liste « ce qui fonctionne / comment l'adapter à mon activité », 6 points maximum.
Validation : je choisis ce que je garde avant que tu ajoutes quoi que ce soit au CLAUDE.md.
Si ça coince
- Tu réponds ce que tu crois qu'il faut répondre. Réponds comme à un client au comptoir, pas comme un manuel de marketing.
- Une info inventée apparaît dans le brief réécrit. Demande de la retirer, puis ajoute au CLAUDE.md : « ne jamais inventer de chiffre, d'avis ou de diplôme ».
- Claude enchaîne les questions trop vite. Rappelle-lui : « une question à la fois ».
- Tu veux copier un concurrent. La structure, oui ; ses textes, images et logos, jamais.
À toi de jouer
Lance l'interview avec le premier prompt. Va jusqu'au bout, même avec des « à compléter ». Puis demande le résumé en 5 lignes et corrige ce qui cloche. Enfin, compare ton brief à celui de l'Atelier Mona : le tien doit contenir au moins une cible, une phrase réelle pour le ton et une action principale. Tu as maintenant un brief complet et un CLAUDE.md qui connaît ton activité.
En bref
- Le brief de l'Atelier Mona tient en 7 lignes précises : un bon point de départ.
- Chaque trou du brief devient une tâche humaine à la fin ; mieux vaut les combler maintenant.
- L'interview, une question à la fois, transforme ce que tu sais en brief utilisable.
- Le résumé en 5 lignes vérifie que Claude a compris, avant toute création.
- Jamais d'information inventée : « à compléter ».