Skip to content
Floskool

Chapter 3 · Chapitre 3 · Préparer son projet avant de demander un plan

3.1 Écrire un brief de projet en dix minutes

Free lesson 7 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Un brief, c'est un court texte qui décrit ton projet. Il sert à deux choses : t'obliger à clarifier tes idées, et donner à Claude Code le contexte nécessaire pour proposer un plan pertinent. Tu as déjà fait le plus dur à la leçon 1.2 avec les cinq questions de départ : le brief les met simplement par écrit, dans un fichier.

Le modèle de brief

Copie ce modèle dans un fichier BRIEF.md à la racine de ton dossier de projet (le dossier principal, celui que tu ouvres dans Claude Code), puis complète-le. L'extension .md signifie Markdown, un format de texte simple où # marque un titre et - une liste.

# Brief du projet

## Le projet en une phrase
Un site où les clients du salon réservent un créneau sans appeler.

## Pour qui
Clients du salon, surtout sur téléphone, de 20 à 70 ans.

## Ce qui existe déjà
Un compte Instagram, un agenda papier, pas de site ni de nom de domaine.

## Ce que je veux absolument
- Voir les prestations et leur durée
- Réserver un créneau libre
- Recevoir chaque réservation sur mon téléphone

## Ce que je ne veux pas (pour l'instant)
- Pas de paiement en ligne
- Pas de compte client avec mot de passe

## Contraintes
Mise en ligne avant décembre, hébergement simple et peu coûteux.

## Comment je saurai que c'est réussi
Une réservation de test arrive bien sur mon téléphone, et un client peut annuler seul.

Le pas à pas en dix minutes

  1. Deux minutes : écris le projet en une phrase, du point de vue de la personne qui l'utilise (« un client peut… »).
  2. Deux minutes : décris le public et ce qui existe déjà.
  3. Trois minutes : liste ce que tu veux absolument, puis ce que tu ne veux pas. Limite-toi à trois ou quatre éléments par liste.
  4. Deux minutes : note tes contraintes et ton test de réussite.
  5. Une minute : relis à voix haute. Toute phrase vague (« un beau site », « moderne ») doit être remplacée par quelque chose de vérifiable.

Pourquoi un fichier plutôt qu'un long message ?

Un fichier reste dans le projet. Tu peux le compléter au fil des réponses, et Claude peut le relire à chaque nouvelle session. Tu évites ainsi de réexpliquer ton projet à chaque fois.

Il y a un autre avantage : un message se perd dans la conversation, alors qu'un fichier a une seule version à jour. Quand tu changes d'avis (par exemple, tu décides finalement d'accepter un acompte en ligne), tu modifies le brief, et toutes les demandes suivantes partent de la bonne information.

Faire écrire le brief par Claude, à partir de tes réponses

Si tu préfères parler qu'écrire, Claude peut t'aider. En mode Plan, pour qu'il ne crée rien sans ton accord :

/plan Aide-moi à écrire le BRIEF.md de mon projet.
Pose-moi les questions une par une : résultat attendu, public,
ce qui existe déjà, ce que je veux, ce que je ne veux pas,
contraintes, test de réussite.
Quand j'ai répondu à tout, propose le contenu du fichier.

Tu restes l'auteur : Claude reformule, mais les décisions viennent de toi.

La section la plus sous-estimée

« Ce que je ne veux pas » est souvent oubliée. Pourtant, c'est elle qui aurait évité le paiement en ligne non demandé de la vidéo. Claude a tendance à proposer des fonctionnalités utiles en général ; cette section lui dit clairement lesquelles sont hors sujet pour toi, au moins pour la première version.

Si ça coince

  • Ton brief fait plusieurs pages. Coupe. Un brief long noie l'essentiel. Garde le détail (liste complète des prestations, horaires) dans des fichiers séparés, comme en leçon 3.3.
  • Tu ne sais pas quoi mettre dans « ce que je ne veux pas ». Pense à ce qu'un site du même type propose souvent : paiement, compte client, newsletter, avis. Écarte ce dont tu n'as pas besoin tout de suite.
  • Ton test de réussite est flou (« que ça plaise »). Remplace-le par une action concrète que tu peux faire toi-même, comme « une réservation de test arrive sur mon téléphone ».

À retenir

  • Un brief court vaut mieux qu'une longue explication improvisée.
  • La section « ce que je ne veux pas » évite beaucoup d'ajouts inutiles.
  • Chaque phrase vague est remplacée par quelque chose de vérifiable.
  • Le brief vit dans le dossier du projet et s'enrichit avec le temps.