Skip to content
Floskool

Chapter 2 · Chapitre 2 · Préparer ton projet de guide

2.3 Le brief du guide : le modèle complet

Free lesson 9 minGroup Claude Code & IA

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

Follow for free

Le brief donne à Claude Code tout le contexte qu'il ne peut pas deviner. C'est la différence entre un guide générique et un guide qui te ressemble.

Le modèle à copier dans brief.md

# Brief du guide

Titre : Les 10 étapes pour lancer ton premier projet avec l'IA
Lecteur : entrepreneur ou indépendant qui n'a jamais mené de projet avec l'IA
Problème du lecteur : il teste l'IA mais n'arrive jamais à un résultat fini
Résultat promis : avoir mené un premier projet de bout en bout
Format : PDF A4, 8 pages environ, 2 étapes par page
Ton : direct, bienveillant, tutoiement, phrases courtes, aucun jargon
Contenu obligatoire : un exemple concret par étape (fil rouge : Julie, fleuriste),
  un piège à éviter par étape, une action « À faire » par étape, une checklist finale
Identité visuelle : bleu nuit #0b1832, bleu #2d62d6, sable #f0cd8c, police Poppins
Interdits : chiffres non vérifiés, promesses de résultat garanti, prix
Source de la matière : brouillon.md

Pourquoi chaque ligne compte

  • Lecteur et problème : Claude Code choisit ses exemples et son vocabulaire en fonction de cette ligne. « Débutant » donne des explications simples ; « expert » donne des raccourcis.
  • Résultat promis : il sert de fil conducteur. Chaque chapitre doit rapprocher le lecteur de ce résultat.
  • Format : sans nombre de pages, tu obtiens souvent un document trop long.
  • Contenu obligatoire : c'est ici que tu imposes ce qui rend un guide utile (exemples, pièges, actions).
  • Interdits : ils évitent les dérives classiques des textes générés, comme les statistiques inventées.

Le fil rouge, ton meilleur outil

Un fil rouge est un personnage ou un cas qui revient dans tous les exemples. Dans la démonstration, Julie, fleuriste, veut une page d'accueil pour recevoir des demandes de devis. Chaque étape montre ce que Julie fait concrètement. Le lecteur suit une histoire au lieu d'une liste de conseils abstraits.

Exercice : remplis le modèle pour ton guide. Choisis un fil rouge proche de ton lecteur.