Documenter ton projet pour toi dans six mois

1. À la fin de cette leçon, tu sauras

Expliquer à quoi sert un fichier LISEZMOI et pour qui on l’écrit.
Rédiger avec l’agent un LISEZMOI en trois parties : à quoi ça sert, comment l’utiliser, comment le reprendre.
Vérifier la documentation en la suivant à la lettre.
Ranger ton dossier de projet pour qu’il soit compréhensible sans toi.

2. Pourquoi ça t’intéresse

Claire, comptable dans une petite entreprise, avait fait au printemps un modèle de rapprochement bancaire avec son agent. En novembre, elle en a de nouveau besoin. Elle ouvre le dossier : cinq fichiers aux noms proches, aucune idée de celui qui est le bon, ni de l’ordre des opérations. Elle a perdu une matinée à retrouver ce qu’elle savait déjà. Depuis, chacun de ses projets commence par un fichier qui s’appelle LISEZMOI, et elle le relit avant de toucher à quoi que ce soit.

3. Avant de commencer


Il te faut	Ton dossier de projet, ta fiche projet, ton journal, ton `tests.md` (leçon 3), ton agent ou un chatbot
Coût	Rien de plus que les outils déjà utilisés
Durée	45 minutes à 1 heure

4. Comprendre en 3 minutes

Un LISEZMOI est une lettre à toi-même dans six mois : tu auras tout oublié, sauf ce qui est écrit. C’est un simple fichier texte, posé à la racine du dossier, qu’on ouvre en premier. Dans le monde de l’informatique, on le trouve souvent sous son nom anglais, README.

Image mentale : la notice collée à l’intérieur de la porte du compteur électrique. Personne ne la lit tous les jours, mais le jour de la panne, elle évite d’appeler quelqu’un.

Trois parties suffisent :

Partie	Question à laquelle elle répond	Exemple
À quoi ça sert	Pourquoi ce projet existe, pour qui	« Prépare le compte rendu mensuel de l’association à partir des notes de réunion »
Comment l’utiliser	Quoi faire, dans quel ordre, avec quels fichiers	« 1. Dépose les notes dans le dossier `entree`. 2. … »
Comment le reprendre	Où sont les choses, ce qui est fragile, ce qui reste à faire	« Ne renomme pas `modele.md`. Idées en attente : voir `plus-tard.md` »

Ne confonds pas avec le CLAUDE.md (module 6) : lui parle à l’agent. Le LISEZMOI parle à une personne. Les deux peuvent se citer l’un l’autre.

Et rappelle-toi la méthode : l’agent rédige vite, mais c’est toi qui vérifies, en suivant le texte comme un débutant.

5. Faire ensemble

Étape 1 · Rassembler la matière

Ouvre ton dossier de projet et lance ton agent dedans.
Vérifie que s’y trouvent ta fiche projet, ton plan, ton journal et tests.md.
Note sur une feuille les deux ou trois choses que tu as eu le plus de mal à comprendre ou à retrouver pendant le projet : elles doivent figurer dans le LISEZMOI.

Étape 2 · Faire rédiger un premier jet

Passe en mode plan si tu utilises Claude Code, puis demande :

Lis les fichiers de ce dossier, en particulier la fiche projet,
le journal et tests.md. Propose un fichier LISEZMOI.md en trois
parties : à quoi ça sert, comment l'utiliser (étapes numérotées),
comment le reprendre (où sont les fichiers, ce qui est fragile,
ce qui reste à faire). Le lecteur est moi dans six mois, qui
n'ai plus aucun souvenir du projet. Ajoute ces points que
j'avais du mal à retrouver : [tes deux ou trois difficultés].
Phrases courtes, aucun jargon sans explication.
Montre-moi le texte avant de créer le fichier.

Étape 3 · Relire et corriger

Supprime tout ce qui est vague (« configurer correctement », « selon les besoins »).
Vérifie que chaque fichier cité existe vraiment, avec le bon nom.
Demande à l’agent de signaler ce qu’il a supposé sans l’avoir lu dans tes fichiers.
Une fois d’accord, laisse-le créer LISEZMOI.md.

Piège fréquent : un LISEZMOI qui décrit ce que le projet devait faire, pas ce qu’il fait vraiment. L’agent s’appuie volontiers sur la fiche projet du début. Après les tests et les corrections, la réalité a changé : c’est elle qu’il faut décrire.

Étape 4 · Tester la documentation

Ferme tout. Puis, en lisant seulement le LISEZMOI, refais l’usage normal du projet du début à la fin. Chaque fois que tu hésites, c’est une ligne à ajouter ou à préciser. Si tu peux, donne le LISEZMOI à l’une des personnes de la leçon 3 et regarde-la s’en servir, sans rien dire.

Étape 5 · Ranger le dossier

Demande :

Liste les fichiers de ce dossier et classe-les en trois groupes :
indispensables au projet, utiles à garder pour l'historique,
probablement inutiles. Ne supprime ni ne déplace rien.
Pour les fichiers que tu proposes de ranger, dis pourquoi.
Le dossier concerne : [le nom de ton projet].

Décide toi-même, puis fais une sauvegarde du dossier (module 6) avant de déplacer quoi que ce soit.

6. Faire toi-même

Écris le LISEZMOI de ton projet final avec ton agent, en suivant les étapes 2 à 4.

Consigne précise : le fichier LISEZMOI.md est à la racine du dossier ; il contient les trois parties ; la partie « Comment l’utiliser » est en étapes numérotées ; la partie « Comment le reprendre » contient au moins un point fragile et renvoie à ta liste « plus tard » ; il indique la date de dernière mise à jour.

Résultat attendu : quelqu’un qui découvre ton dossier peut utiliser ton projet en suivant seulement ce fichier.

7. Vérifier

Le LISEZMOI est à la racine du dossier et répond aux trois questions : à quoi ça sert, comment l’utiliser, comment le reprendre.
Chaque fichier ou dossier cité existe, avec exactement ce nom.
Tu as refait l’usage du projet en suivant seulement le texte, sans blocage.
Le texte décrit le projet tel qu’il est après les tests, pas tel qu’il était prévu.
Aucun mot de passe, code d’accès ni donnée personnelle réelle n’apparaît dans le fichier.
La date de dernière mise à jour est écrite.

8. Ce que tu gardes

Dans ton carnet de bord, note le modèle en trois parties : il servira pour tous tes projets. Ajoute une règle : « Je mets à jour le LISEZMOI à chaque changement qui modifie l’usage. » Ton LISEZMOI sera aussi ta meilleure source pour la page de présentation de la leçon suivante.

9. Pour aller plus loin

Ajoute une ligne dans ton CLAUDE.md qui demande à l’agent de lire le LISEZMOI au début de chaque séance et de le tenir à jour.
Fixe-toi un rappel dans six mois : ouvre le dossier, lis seulement le LISEZMOI, et note ce qui manquait.