Dans cet article :
Comment j’ai ajouté deux blocs dans mon CLAUDE.md pour que Claude Code génère des scripts YouTube filmables en 30 secondes — le profil client enrichi et l’agent [SCRIPTEUR].

Ep1 terminé — j’avais un CLAUDE.md qui connaissait mon business. Problème : quand je lui demandais un script vidéo, il produisait quelque chose de correct mais générique. Le titre aurait pu sortir de n’importe quelle chaîne YouTube IA. J’ai compris pourquoi : l’IA ne savait pas pour qui j’écrivais. Voilà ce que j’ai changé.

Le problème : l’IA écrit pour personne

Le CLAUDE.md d’Ep1 avait trois lignes sur Lucas — mon client idéal. “Solopreneur, débutant IA, veut changer ça.” C’est vague. Quand tu donnes un contexte vague à une IA, tu obtiens un output vague.

J’ai testé en direct dans la vidéo : même commande /video, même sujet, avant et après les deux blocs ajoutés. Le résultat avant était utilisable mais interchangeable. Le résultat après était filmable directement. La seule variable : ce que l’IA savait sur Lucas et sur ma formule vidéo.

Retenir ça, c’est la leçon centrale de cet épisode : la qualité de l’output dépend de la qualité du contexte, pas de la qualité de l’IA.

Bloc 1 — Lucas enrichi

J’ai remplacé les trois lignes par un profil complet. Les parties qui changent vraiment le résultat :

## CLIENT IDÉAL — LUCAS

Solopreneur, freelance ou consultant depuis 2-5 ans.
CA 3 000-8 000€/mois. Maîtrise son métier. Débutant sur l'IA. Le sait. Veut changer ça.

Sa douleur exacte :
Il a essayé. ChatGPT, quelques tutoriels YouTube.
Les "top 10 outils IA" ne lui apprennent rien d'actionnable.
Il commence à se demander si c'est lui le problème.
Ce n'est pas lui. Personne ne lui montre comment faire pour SON cas.

Ce qui le fait rester sur une chaîne :
Terminal ouvert. Commandes qui tournent. Résultat visible.
Entendre "j'ai bloqué 2h sur ce point" — ça valide qu'il n'est pas nul.

Phrases qu'il écrit en commentaires :
"Est-ce que ça marche aussi pour mon cas ?"
"J'ai essayé mais ça ne marche pas pour moi."
"Tu peux faire une vidéo sur [son problème exact] ?"

La ligne clé : “Il commence à se demander si c’est lui le problème.” Lucas ne dit jamais ça directement. Mais c’est ce qu’il ressent après le troisième tutoriel qui ne l’aide pas. Quand l’IA connaît cette douleur cachée, elle écrit pour lui. Pas pour une idée abstraite.

Les phrases de commentaires ne sont pas inventées — elles viennent de vrais commentaires YouTube sous des vidéos IA françaises. Quand l’IA connaît ces phrases, elle peut anticiper la question de Lucas avant qu’il la pose.

Bloc 2 — L’agent [SCRIPTEUR]

Deuxième ajout : un agent dédié à la production de scripts. Il répond à la commande /video et connaît ma formule exacte :

## AGENT [SCRIPTEUR]

Produit la structure et le script de chaque épisode YouTube.
Ne produit jamais de théorie sans démonstration à l'écran.

Structure non négociable (12-15 min) :
0-2 min   : La douleur de Lucas — jamais "dans cette vidéo on va voir"
2-5 min   : Ce qu'on construit — résultat montré d'abord
5-12 min  : Démo en direct — terminal visible, erreurs gardées
12-14 min : Ce qui a galéré + comment résolu
14-15 min : Résumé (3 points max) + CTA newsletter

Règles titre :
Format exact : "J'ai [verbe d'action passé] [résultat concret] — voilà comment"
✓ "J'ai automatisé ma prospection LinkedIn en 30 minutes — voilà comment"
✗ "Comment automatiser LinkedIn avec l'IA"

Le détail qui change tout : j’ai mis des timecodes dans le CLAUDE.md. Pas pour faire joli. Parce que les 30 premières secondes d’une vidéo déterminent si les gens restent — l’algorithme YouTube mesure ça. L’IA doit savoir que les 2 premières minutes parlent de la douleur de Lucas, pas du plan de la vidéo.

La règle “jamais dans cette vidéo on va voir” : c’est contre-intuitif. Ton réflexe naturel quand tu filmes c’est de présenter. Mais Lucas a déjà cliqué — il sait ce que la vidéo va faire. Ce qu’il veut maintenant : savoir si tu comprends son problème.

Ce qui a galéré — et le temps que ça m’a coûté

Blocage 1 — Lucas trop vague. Les premières versions produisaient du contenu correct mais générique. J’ai passé 20 minutes à changer les paramètres de Claude, à reformuler mes prompts. C’était pas ça le problème. Le problème c’était Lucas. Trois lignes insuffisantes. J’ai ajouté les phrases de commentaires réels — ça a changé immédiatement.

Blocage 2 — Les titres au mauvais format. Claude sortait “Comment automatiser X” par défaut — parce que c’est le format le plus fréquent sur Internet. J’ai dû être explicite dans la règle : format exact, exemples oui et exemples non. Plus tu es précis dans les règles, moins tu fais de corrections après.

Ces deux blocages m’ont pris en tout environ 3 heures. Maintenant tu les passes en 5 minutes.

Le résultat en chiffres

Avant ces deux blocs : générer la structure d’un script + un titre utilisable me prenait 2 à 3 heures entre les allers-retours, les corrections de ton, les reformulations de titre.

Après : je tape /video "sujet". Ce qui sort en 30 secondes, je peux le filmer directement. Le titre est au bon format. La structure respecte la formule. Le ton est celui de Lucas, pas celui d’un assistant générique.

Ce n’est pas une question d’IA plus puissante — c’est la même version de Claude. C’est une question de contexte bien construit.

Comment ajouter ces deux blocs à ton CLAUDE.md

  1. Ouvre ton CLAUDE.md existant (ou crée-en un depuis l’Ep1)
  2. Ajoute le bloc CLIENT IDÉAL — remplace Lucas par le nom de ton client à toi, ses vraies douleurs, ses vraies phrases
  3. Ajoute le bloc AGENT [SCRIPTEUR] — remplace la structure et les règles par ton format de contenu
  4. Teste avec /video "ton sujet" — compare le titre avec et sans les blocs
  5. Si le titre n’est pas au bon format, sois plus explicite dans les règles — exemples oui et non inclus

Le CLAUDE.md complet des deux épisodes — Lucas enrichi + agent [SCRIPTEUR] — est disponible gratuitement. Abonne-toi à la newsletter pour le recevoir immédiatement.

Recevoir le CLAUDE.md gratuit →

FAQ

Est-ce que ça marche pour d’autres types de contenu que YouTube ?

Oui. Le même principe s’applique à n’importe quel format : articles de blog, emails, posts LinkedIn, scripts de podcast. Tu crées un agent par format de contenu, chacun avec ses règles spécifiques. La commande change (/article, /email), la logique reste la même.

Comment trouver les vraies phrases de mon client idéal ?

Va dans les commentaires YouTube des chaînes qui s’adressent à ton client. Lis les questions, les frustrations, les formulations exactes. Copie les phrases littéralement — ne les réécris pas. C’est ce langage brut qui rend le contexte efficace pour l’IA.

Combien d’agents peut-on mettre dans un CLAUDE.md ?

Autant que tu veux, mais reste dans les 150-300 lignes au total. Un agent par type de tâche récurrente. Si tu dépasses, Claude commence à traiter le fichier comme de la documentation plutôt que des instructions — la précision baisse.

Faut-il répéter le profil client dans chaque agent ?

Non. Tu définis Lucas une fois dans le CLAUDE.md. Chaque agent y fait référence implicitement — Claude lit tout le fichier avant de répondre. Le [SCRIPTEUR] connaît Lucas même si Lucas n’est pas mentioné dans le bloc agent.


Reçois le CLAUDE.md complet — les deux blocs de cet épisode prêts à coller dans ta forge. Abonne-toi à la newsletter, tu le reçois immédiatement.

Recevoir le CLAUDE.md gratuit →

Prochain épisode : les 5 règles de prompt engineering qu’on vient d’utiliser sans les nommer — je les explique et tu repars avec une méthode applicable ce soir sur n’importe quel outil IA.

JB

Julien Barbaro

DevOps depuis 13 ans, solopreneur depuis Bordeaux. Je construis Systemesia en public — chaque outil est testé en prod avant d'en parler.