Lire ce que fait l'agent avant de dire oui

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

Reconnaître les grands types d’actions affichées par l’agent : lire, modifier, créer, lancer une commande.
Lire une différence avant/après sans te perdre.
Demander à l’agent d’expliquer en mots simples ce qu’il va faire, avant de valider.
Utiliser le mode plan pour tout voir venir.

2. Pourquoi ça t’intéresse

Fatou demande à l’agent de « mettre à jour la liste des bénévoles » de son association. Le terminal se remplit de lignes : un fichier lu, un autre, puis un bloc avec des lignes rouges et vertes et une question. Elle s’apprête à appuyer sur Entrée par réflexe, puis s’arrête. En lisant, elle voit que l’agent va supprimer trois personnes qu’il croit en double, alors que ce sont deux sœurs et leur père. Elle refuse, explique, et l’agent corrige.

3. Avant de commencer


Il te faut	Claude Code installé, ton dossier `formation-ia` avec au moins un fichier (leçons 3 à 5), des points de sauvegarde si possible
Coût	Celui de ton abonnement : vérifie le prix du jour sur claude.com/pricing
Durée	30 à 45 minutes

4. Comprendre en 3 minutes

Tout ce que l’agent fait s’affiche à l’écran. Ton travail n’est pas de tout comprendre, mais de ne jamais valider ce que tu n’as pas compris.

Image mentale : le devis d’un artisan. Pas besoin d’être plombier pour lire « je remplace ce joint » et demander « pourquoi ? ».

Ce que tu verras, quel que soit l’affichage exact de ta version :

Ce qui s’affiche	Ce que ça veut dire	Ce que tu fais
Un fichier lu	L’agent consulte un fichier pour comprendre	Tu vérifies que c’est bien un fichier du dossier prévu
Un nouveau fichier proposé	Son nom et son contenu	Tu lis le nom, l’endroit, le contenu
Une modification proposée	Une différence avant/après	Tu regardes ce qui disparaît et ce qui apparaît
Une commande proposée	Une instruction pour le terminal	Tu demandes ce qu’elle fait si tu ne sais pas

La différence avant/après (en anglais, « diff ») montre seulement les lignes qui changent, avec quelques lignes autour pour situer. Les lignes retirées sont en général marquées d’un signe moins, souvent en rouge. Les lignes ajoutées, d’un signe plus, souvent en vert. Une ligne modifiée apparaît donc deux fois : l’ancienne, puis la nouvelle.

Les commandes ressemblent à des mots anglais abrégés. Certaines ne font que lire, d’autres déplacent, renomment ou suppriment. Dans le doute, tu demandes.

5. Faire ensemble

Étape 1 · Faire annoncer le plan en mots simples

Lance claude dans formation-ia, puis :

Je voudrais [ta tâche, par exemple : ajouter une rubrique « Contacts utiles » à programme-sortie.md].
Avant de faire quoi que ce soit, explique-moi en mots simples :
1. Quels fichiers tu vas lire.
2. Quels fichiers tu vas modifier ou créer.
3. Si tu as besoin de lancer une commande, laquelle et pourquoi.
Attends mon accord.

Compare son annonce avec ce que tu attendais. Corrige si besoin : « ne touche pas à ce fichier-là ».

Étape 2 · Lire une modification ligne à ligne

Donne ton accord. Quand la proposition de modification s’affiche, ne réponds pas tout de suite :

Repère le nom du fichier en haut du bloc.
Lis les lignes retirées : est-ce que tu acceptes de les perdre ?
Lis les lignes ajoutées : est-ce exactement ce que tu as demandé, rien de plus ?

Étape 3 · Faire traduire une modification en français

Si le bloc est long ou confus, refuse pour l’instant et écris :

Avant que je décide : résume en trois phrases simples ce que cette modification change, ce qu'elle supprime, et ce qui reste identique.

Puis redemande la même modification et accepte une fois, si l’explication te convient.

Étape 4 · Questionner une commande

Montre-moi la liste des points de sauvegarde de ce dossier.

L’agent va sans doute proposer une commande git. Avant d’accepter, demande :

Explique-moi cette commande mot par mot, en français simple. Est-ce qu'elle lit seulement, ou est-ce qu'elle peut modifier ou supprimer quelque chose ?

Étape 5 · Essayer le mode plan

Appuie sur Maj+Tab jusqu’à voir le mode plan s’afficher. Dans ce mode, l’agent prépare et explique sans toucher aux fichiers. Donne-lui une tâche, lis son plan, puis repasse dans le mode habituel avec Maj+Tab pour l’exécuter.

6. Faire toi-même

Choisis une vraie modification d’un fichier de formation-ia : réorganiser ton carnet de bord par rubriques, mettre à jour une liste de contacts d’association, corriger une recette, compléter regles-securite.md.

Demande le plan en mots simples (étape 1).
Lis chaque proposition : fichier, lignes retirées, lignes ajoutées.
Refuse au moins une proposition pour demander une explication.
À la fin, demande à l’agent un résumé de tout ce qu’il a fait pendant la session, et compare-le avec ce que tu as vu passer.

Résultat attendu : un fichier modifié comme tu le voulais, et dans ton carnet une courte liste des actions de l’agent que tu sais maintenant reconnaître.

7. Vérifier

J’ai obtenu un plan en mots simples avant la première action.
Je sais dire, sur une proposition, quelles lignes disparaissent et lesquelles apparaissent.
J’ai refusé au moins une fois pour demander une explication.
J’ai fait expliquer une commande et je sais si elle lisait ou modifiait.
J’ai essayé le mode plan avec Maj+Tab.
Le résumé de fin de session correspond à ce que j’ai vu.

Piège fréquent : la fatigue de validation. Après dix demandes d’autorisation, on appuie sur Entrée sans lire. Si tu sens que tu valides par réflexe, fais une pause, ou demande à l’agent de regrouper ses actions et de t’annoncer le plan d’abord.

8. Ce que tu gardes

Dans ton carnet de bord, une rubrique « Lire l’agent » :

Les quatre types d’actions (lire, créer, modifier, commande) et ce que tu vérifies pour chacun.
La demande de l’étape 1 et celle de l’étape 3.
La règle : « Je ne valide jamais ce que je ne sais pas expliquer. »

9. Pour aller plus loin

Avant chaque tâche importante, combine mode plan et point de sauvegarde (leçon 5).
La documentation officielle (code.claude.com/docs) décrit l’interface et les modes : parcours-la pour mettre des noms sur ce que tu vois.