[00:08:35] Elsa

Hello hello, c’est Elsa et Yoann de Hymaïa. On se retrouve pour un nouvel épisode de la formation Claude Code for PM. Aujourd’hui, on va parler d’un sujet qui va vous faire gagner beaucoup de temps : comment donner à Claude un maximum de contexte pour éviter de devoir tout lui redire à chaque nouvelle conversation.

---

[00:25:64] Elsa

C’est parti. Mettons-nous dans un cas d’usage que vous avez peut-être déjà vécu. Moi, en tant que PM, je le vis très régulièrement ces derniers temps.

---

[00:34:39] Elsa

Je reçois un message Slack de mon CEO qui me dit qu’il faudrait vraiment ajouter des features d’IA générative dans notre produit et avoir plein d’idées pour demain 9h. C’est assez urgent.

---

[00:47:33] Yoann

Ça n’arrive jamais.

---

[00:48:02] Elsa

Ça n’arrive jamais, mais c’est déjà arrivé quand même. Qu’est-ce que je vais faire ? Je vais aller taper la balle avec Claude Code, sauf que je vais perdre pas mal de temps à resituer tout mon contexte : dans quelle boîte je travaille, quel est mon parcours, etc. D’où la notion de contexte et à quel point c’est important. C’est ce qu’on va voir aujourd’hui, et c’est ce qu’on a appelé Personal OS : comment enrichir ce contexte personnel pour gagner en productivité sur Claude Code.

---

[01:19:93] Yoann

On va travailler et itérer tout au long des vidéos sur cette notion de Personal OS, en commençant par le premier point : le fameux fichier claude.md. On va créer notre propre claude.md. Avant de commencer, trois choses importantes à comprendre pour qu’on ait le même vocabulaire.

---

[01:38:43] Yoann

On va parler de contexte, de claude.md et d’arborescence. Le contexte, concrètement, c’est tout ce que Claude doit savoir pour t’aider sur telle tâche ou tel projet. Tout ce que tu dois lui fournir, tu le mets dans ce contexte pour qu’il le charge.

---

[01:54:99] Yoann

Où est-ce qu’on le met, ce contexte ? Dans ce qu’on appelle un fichier claude.md. Claude en majuscule, .md. MD pour Markdown, c’est un fichier texte complètement lisible. C’est le fichier qui contient tout le contexte que vous allez lui donner et qui se charge automatiquement à chaque session. C’est le point le plus important : quand on ouvre une session Claude Code et qu’il y a un claude.md dans le dossier, il le charge automatiquement. Dès le départ, il a tout le contexte que vous lui avez donné.

---

[02:24:62] Yoann

On va aussi parler d’arborescence : c’est là où est stocké ton fichier claude.md et les autres fichiers et sous-dossiers. En général, à la racine de votre projet Personal OS, vous aurez un claude.md qui contient tout ce qui est nécessaire. Dans un premier temps, ne vous embêtez pas avec la taille du fichier ou la façon de le découper. Mettez-y un maximum de choses, on verra plus tard comment le réorganiser.

---

[02:52:43] Elsa

Concrètement, dans ce claude.md, on vous recommande de mettre cinq grands éléments : qui vous êtes, des informations sur votre boîte (vous pouvez même mettre l’URL du site web), votre rôle et comment il s’inscrit dans l’entreprise, votre équipe avec les personnes avec qui vous interagissez (et pourquoi pas leur personnalité et votre relation avec eux), et vos rituels : sprint planning, refinement, one-to-one, etc.

---

[03:40:02] Elsa

Le dernier point, très important : la partie style et la façon dont vous voulez travailler avec Claude Code. Est-ce que vous voulez qu’il soit proactif ou qu’il attende que vous veniez vers lui ? Est-ce que vous voulez qu’il vous tutoie, vous vouvoie, vous appelle par un surnom ? Tout ça peut aller dans le style.

---

[04:01:73] Yoann

On va se lancer dans la création de votre premier claude.md. Il y a deux options principales, mais il y en a une qu’on va vraiment privilégier.

La première option, c’est de partir d’un contenu existant : une page Notion qui décrit votre rôle, des infos sur l’entreprise, votre CV. Vous prenez ces éléments, vous les chargez dans une conversation et vous demandez à Claude de générer le claude.md à partir de là. C’est rapide, mais vous risquez de copier des éléments pas forcément nécessaires et vous ne vous mettez pas dans la dynamique de construire le fichier de manière itérative avec Claude.

C’est justement la deuxième option, qu’on recommande : laisser Claude vous interviewer. Dans une session, vous lui dites : « Je veux créer mon claude.md. Pour ça, pose-moi trois à cinq questions auxquelles je vais répondre pour te donner un maximum de contexte sur moi, mon projet, mon entreprise. » Il pose les questions, vous répondez, et il écrit directement le fichier pour vous. Vous pouvez ensuite l’éditer librement puisque c’est un simple fichier texte.

---

[05:17:92] Elsa

C’est parti pour la démo. On va configurer notre claude.md ensemble. Je vous conseille de vous mettre sur votre bureau et de créer un dossier Personal OS. C’est le dossier dans lequel on va travailler tout au long de ces formations. Créez-le une bonne fois pour toutes. Pour le moment, il est vide, c’est normal : on n’a pas encore commencé à configurer notre claude.md.

---

[05:41:20] Elsa

Ensuite, lancez l’application Claude Desktop et c’est parti.

---

[05:46:89] Elsa

Je vous invite à commencer une nouvelle session. La chose la plus importante, c’est de choisir dans quel dossier vous allez travailler, c’est-à-dire quels droits vous donnez à Claude Code. Si je me situe dans le dossier Personal OS, ça veut dire que je donne à Claude Code les droits de lire et créer des fichiers dans ce dossier.

---

[06:07:05] Elsa

Je vais lui dire : « Aide-moi à créer mon fichier contexte claude.md en me posant des questions. »

---

[06:21:99] Elsa

Vous avez même le droit de faire des fautes d’orthographe. Je l’ai fait sciemment pour vous montrer qu’il comprend très bien ce qu’on veut dire.

---

[06:33:96] Elsa

Il me pose plein de questions.

---

[06:53:23] Elsa

« Quel langage ou stack j’utilise principalement ? » Claude Code. Mon seul langage.

---

[07:10:50] Elsa

Il va me poser plein de questions. Je vous recommande de passer 10 à 15 minutes à y répondre. N’hésitez pas à le relancer s’il n’aborde pas certains sujets : « On n’a pas parlé de mon équipe », « On n’a pas parlé de comment je veux travailler. » Reprenez les cinq grandes catégories qu’on a identifiées tout à l’heure et relancez-le dessus.

---

[07:31:37] Elsa

Pour l’exemple, je vais donner assez peu de contexte, mais il va quand même créer le claude.md.

---

[07:45:51] Elsa

Il me confirme que le claude.md a bien été créé. Je vais vérifier. J’ouvre mon dossier Personal OS et je vois bien le fichier claude.md. Comme le disait Yoann, c’est un simple fichier texte que je peux modifier comme je veux. Si je considère que Claude n’a pas bien compris quelque chose, je peux directement l’éditer.

---

[08:10:59] Elsa

Petit truc à vous montrer : si vous cliquez sur le petit toggle en haut à droite, vous pouvez afficher tous les fichiers qui se trouvent dans votre dossier de travail. On voit bien le fichier claude.md, et si je clique dessus, j’ai un aperçu de son contenu.

---

[08:32:81] Elsa

Voilà, mon fichier claude.md est configuré. Il n’est pas parfait, n’hésitez pas à faire le vôtre plus complet. Yoann, je te propose une petite battle. On part d’un cas d’usage réel : trouver cinq idées de jeux ludiques pour animer nos formations d’IA générative. On va voir si le contexte aide ou non. Qu’est-ce que tu lui écris ?

---

[09:04:78] Yoann

« Propose-moi cinq idées d’activités ludiques pour nos formations. »

---

[09:25:95] Yoann

Il m’a répondu directement. Voici cinq idées : des quiz en équipe, un Serious Game, des Escape Rooms pédagogiques, le Bingo des apprentissages, et un hackathon Express. En gros, tout ce qu’on peut voir dans n’importe quelle formation classique. Rien de vraiment différenciant. Tu as mieux ?

---

[09:50:35] Elsa

Oui, j’ai beaucoup mieux. Il me propose des idées vraiment tournées vers l’IA générative, c’est ça la grosse différence. Comme je l’ai mis dans mon claude.md, il sait que je donne des formations d’IA générative, même si je ne l’ai pas reprécisé dans le prompt. Il me propose notamment un Prompt Battle (deux équipes rédigent un prompt pour la même tâche et on compare le résultat en live) ou le Téléphone Arabe de Prompt (on passe un prompt de main en main, chaque participant l’améliore d’une phrase et on observe comment le résultat évolue). Je pense qu’il y a un vainqueur à cette battle.

---

[10:40:74] Yoann

Ouais, c’était un peu gagné d’avance.

---

[10:45:49] Yoann

J’aurais dû expliquer beaucoup plus de choses dans mon prompt initial pour arriver au même niveau de qualité, parce que je n’avais rien précisé sur mon contexte ni sur le type de formation que je donnais.

---

[11:05:74] Elsa

Voilà. Plus vous prenez le temps de compléter votre fichier claude.md, moins vous aurez de réponses génériques et plus elles seront adaptées à votre demande et à votre façon de travailler. Et une fois ce fichier écrit, vous gagnez énormément de temps puisque vous n’avez plus besoin de répéter votre contexte à chaque session. C’est vraiment un investissement pour l’avenir.

---

[11:34:65] Yoann

Si on résume cette vidéo, trois grands apprentissages.

Le fichier claude.md est à la racine de ton projet, dans ton file system, et il est lu automatiquement par Claude à chaque ouverture de session dans ton dossier Personal OS. Pas besoin de lui expliquer où il est.

Dans ce fichier, tu mets tout ce qui est important à savoir sur ton contexte, ton équipe, ton entreprise. Et l’idéal, c’est de laisser Claude t’interviewer plutôt que de partir d’une page blanche : c’est un réflexe général, réfléchir avec Claude et le laisser nous poser des questions plutôt que lui demander d’écrire à l’aveugle.

Dernière chose très importante : ce n’est pas parce que vous avez écrit votre claude.md une fois qu’il est gravé dans le marbre. À chaque conversation où il manque un élément ou où quelque chose sonne faux, dites-lui en fin de session : « Cette information, tu ne l’avais pas, rajoute-la dans le claude.md pour la prochaine fois. » C’est un processus ultra-itératif.

---

[12:43:55] Elsa

Personne n’a de claude.md parfait du premier coup, pas d’inquiétude. Pour la prochaine vidéo, deux choses à faire : setup votre fichier claude.md dans votre dossier Personal OS, et n’hésitez pas à rejouer des prompts que vous avez déjà envoyés sans claude.md pour voir si les réponses sont plus contextualisées et si vos prompts sont devenus plus courts.

---

[13:19:93] Yoann

Nous voici bien armés avec le claude.md et les éléments de contexte absolument nécessaires pour toute session avec Claude. Dans la prochaine vidéo, on va brancher nos différents outils et connecteurs pour commencer à avoir quelque chose de vraiment end-to-end. À la prochaine vidéo.

---

[13:36:58] Elsa

À la prochaine.