Chapter 3 · Chapitre 3 · Rédiger un bon brief
3.1 Le modèle de brief complet à copier
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeLe brief, c'est la fiche d'identité de ton site. Sans lui, Claude Code devine. Avec lui, il écrit pour ton métier, ta ville et tes clients.
Pourquoi c'est la pièce maîtresse
Reprends le plombier chauffagiste de Rennes. Si le brief dit que ses clients appellent dans l'urgence, Claude met le téléphone cliquable en haut de chaque page et parle de la zone d'intervention. Si le brief est vide, il écrit « Bienvenue sur notre site » et une liste de services sans âme.
La documentation de Claude Code insiste sur ce point : être précis dès la première demande. Le brief, c'est cette précision, écrite une fois pour toutes. Tu as déjà fait le gros du travail au chapitre 2 : ton objectif et ton inventaire. Le brief les rassemble dans un seul fichier.
Le modèle complet
Dans ton dossier mon-site, crée un fichier brief.md. Colle ce modèle dedans. Remplis avec tes mots. Si tu n'as pas la réponse, écris « à compléter ».
# Brief du site
Remplis avec tes mots. Si tu n'as pas la réponse, écris « à compléter ».
## 1. Activité
- Métier, en une phrase :
- Zone d'intervention (ville, département, en ligne) :
- Statut (micro-entreprise, société, association...) :
## 2. Cible
- Qui sont tes clients types :
- Ce qui les inquiète ou les freine :
- Ce qu'ils cherchent en arrivant sur ton site :
## 3. Offre
- Tes services (un par ligne) :
- Ce qui te distingue :
- Tes preuves réelles (diplômes, années d'expérience, réalisations, avis que tu peux citer avec accord) :
## 4. Ton
- Tutoiement ou vouvoiement :
- Trois adjectifs pour ton style :
- Une ou deux phrases que tu as vraiment écrites (message client, post) :
## 5. Pages souhaitées
- Accueil, Services, À propos, Contact, Mentions légales, Politique de confidentialité
- Autres pages éventuelles :
## 6. Action principale du visiteur
- Appeler, réserver, remplir le formulaire, venir sur place :
## 7. Photos
- Photos disponibles (toi, ton lieu, tes réalisations) :
- Photos manquantes :
## 8. Charte graphique
- Couleurs (codes si tu les as) :
- Polices :
- Logo (fichier SVG ou PNG) :
- Deux sites que tu aimes, et pourquoi :
## 9. Informations légales (pour les mentions légales)
- Statut exact (EI ou micro-entreprise, SARL, SAS, association...) :
- Nom et prénom (avec la mention « EI » si entrepreneur individuel) ou dénomination sociale :
- Forme juridique et capital social (si société) :
- Adresse :
- E-mail et téléphone de contact :
- SIREN ou SIRET, et numéro d'immatriculation (RNE ou RCS) s'il existe :
- Numéro de TVA intracommunautaire (si tu en as un) :
- Profession réglementée ? Ordre ou organisme, titre professionnel :
- Responsable de la publication :
- Hébergeur prévu (nom, adresse, téléphone) :
## 10. Mise en ligne
- Nom de domaine déjà acheté ? Lequel, et chez quel registraire :
- Hébergeur déjà choisi ? Lequel (plateforme statique ou hébergeur mutualisé) :
- Besoin d'une adresse e-mail à ton nom de domaine :
- Comment veux-tu recevoir les messages du formulaire :
## 11. Données et outils
- Outils que tu veux ajouter (statistiques, prise de rendez-vous, newsletter, vidéo intégrée) :
- Durée pendant laquelle tu gardes les messages reçus :
À quoi sert chaque partie
- Activité : métier et zone finissent dans le titre de tes pages. C'est ce que tes clients tapent dans Google.
- Cible : les inquiétudes de tes clients deviennent les réponses de ta page d'accueil. Reprends ton résumé de la leçon 2.1.
- Offre : uniquement des preuves réelles. Un avis client se cite avec l'accord de la personne.
- Ton : tes phrases réelles servent de modèle. Claude imite bien mieux un ton qu'il a sous les yeux.
- Pages et photos : reprends ta check-list d'inventaire de la leçon 2.2.
- Action principale : le bouton qu'on retrouvera sur chaque page.
- Charte : elle évite un site « passe-partout ». On l'applique au chapitre 5.
- Informations légales : elles servent à remplir les mentions légales sans rien inventer (chapitre 7).
- Mise en ligne, données et outils : ils préparent le formulaire, la politique de confidentialité et l'hébergement (chapitres 7 et 9).
Les erreurs à éviter
- Écrire comme une plaquette commerciale. « Solutions innovantes et sur mesure » ne dit rien. Écris comme tu parles à un client.
- Inventer pour remplir. Un « 500 clients satisfaits » sorti de nulle part est trompeur pour tes visiteurs et peut relever des pratiques commerciales trompeuses. Mieux vaut « à compléter ».
- Lister dix actions principales. Choisis-en une.
- Oublier la partie légale. Tu la retrouveras de toute façon au moment des mentions légales. Autant la préparer maintenant.
Si ça coince
- Le modèle te paraît long. Il l'est, volontairement. Tu n'as pas à tout remplir aujourd'hui : les parties 1, 2, 4 et 6 suffisent pour démarrer. Claude t'aide pour le reste dans la leçon suivante.
- Tu ne trouves pas tes « trois adjectifs ». Demande-toi comment tes clients te décrivent : chaleureuse, rapide, minutieux, rassurant...
- Tu n'as aucune phrase écrite à un client. Prends un SMS, un e-mail de devis, une réponse à un avis. Même trois lignes suffisent.
- Les accents ou les guillemets s'affichent mal dans le fichier. Demande à Claude Code d'enregistrer
brief.mden UTF-8 (l'encodage standard qui gère les accents).
À toi de jouer
Crée brief.md, colle le modèle et remplis au moins les parties 1, 2, 4 et 6 (activité, cible, ton, action principale). Pour la partie Ton, va chercher un vrai message que tu as envoyé à un client et colle-le tel quel. Le reste, tu le complèteras avec Claude dans la leçon suivante.
En bref
- Le brief est la fiche d'identité de ton site ; sans lui, Claude devine.
- Onze parties, de l'activité à la mise en ligne ; « à compléter » plutôt qu'une info inventée.
- Tes vraies phrases servent de modèle pour le ton.
- Les parties légales et techniques préparent les chapitres 7 et 9.