Créer deux sous-agents à rôle unique : un relecteur et un documentaliste

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

Créer avec /agents un sous-agent « relecteur » limité aux outils de lecture.
Créer un sous-agent « documentaliste » qui ne fait qu’une chose : tenir le journal des décisions.
Écrire pour chacun une description qui dit son rôle et quand l’appeler.
Décider quand un sous-agent vaut son coût, et quand t’en passer.

2. Pourquoi ça t’intéresse

Karima prépare avec l’agent le dossier de subvention de son club de handball. À la fin de chaque séance, elle demande « relis tout » puis « note ce qu’on a décidé ». Mais l’agent qui vient d’écrire relit avec indulgence, et les décisions se perdent dans une conversation trop longue. Avec deux sous-agents à rôle unique, la relecture se fait à froid, sans rien pouvoir modifier, et le journal est tenu par un spécialiste qui n’écrit que là. Sa conversation principale reste consacrée au dossier.

3. Avant de commencer


Il te faut	Claude Code, ton dossier `atelier-multi-ia` (leçon 4), la leçon sur les sous-agents du module 8
Coût	Ton abonnement à l’agent (vérifie le prix du jour sur claude.com/pricing) ; chaque sous-agent consomme de l’usage en plus
Durée	45 min à 1 h

4. Comprendre en 3 minutes

Un bon sous-agent a un seul rôle, des outils limités à ce rôle, et une description qui dit quand l’appeler.

Au module 8, tu as découvert les sous-agents. Ici, tu t’en sers pour répartir les rôles de la leçon 1 : l’agent principal exécute, le relecteur juge, le documentaliste tient le rôle d’archiviste dans notes/decisions.md.

Image mentale : une petite rédaction. La personne qui écrit l’article ne le relit pas elle-même, et ce n’est pas le relecteur qui tient le registre des décisions. Chacun son poste, chacun ses clés.

Sous-agent	Son unique rôle	Outils	Ce qu’il ne fait jamais
relecteur	Lire un document et rendre une liste de problèmes	Lecture seulement	Modifier un fichier
documentaliste	Ajouter une entrée datée au journal	Lecture et écriture	Toucher à un autre fichier que `notes/decisions.md`

Trois choses à garder en tête :

Contexte séparé. Chaque sous-agent part d’une page blanche : il ne voit pas ta conversation. C’est ce qui rend la relecture plus froide. C’est aussi pourquoi tu dois lui dire précisément quoi lire.
Coût en usage. Chaque mission relit les fichiers nécessaires : cela consomme davantage de ton forfait (vérifie les conditions de ton abonnement sur la page officielle).
La sobriété. Deux sous-agents bien réglés valent mieux que six vagues. Chaque nouveau rôle est une chose de plus à surveiller.

Attention : ce relecteur est un Claude qui relit un Claude. Il apporte un regard neuf, pas un regard différent. Il sert de premier filtre rapide ; pour un document à enjeu, garde la relecture par une autre IA (leçons 3 et 4).

5. Faire ensemble

Étape 1 · Faire rédiger les deux fiches de poste

Lance claude dans atelier-multi-ia, puis :

Je veux deux sous-agents à rôle unique pour ce dossier.
1. « relecteur » : lit un document et rend une liste de problèmes
   classés du plus grave au moins grave, avec l'endroit exact.
   Outils de lecture seulement. Il ne corrige rien.
2. « documentaliste » : ajoute à notes/decisions.md une entrée datée
   (décision, raison, qui l'a prise). Il n'écrit dans aucun autre fichier.
Le livrable est décrit dans brief.md : [ton livrable en quelques mots].
Propose pour chacun une description d'une ou deux phrases qui dit
quand l'appeler, et ses instructions. Ne crée rien encore.

Relis. Une bonne description commence par le rôle et précise le moment : « À utiliser après chaque version d’un document, avant envoi. »

Étape 2 · Créer le relecteur avec /agents

Tape /agents et choisis de créer un nouveau sous-agent, pour ce projet.
Colle la description et les instructions validées.
À l’étape du choix des outils, ne garde que ceux de lecture. Si tu ne sais pas lesquels le sont, demande à l’agent de te les expliquer, ou consulte code.claude.com/docs.
Relis le récapitulatif avant d’enregistrer.

Étape 3 · Créer le documentaliste

Même chemin. Cette fois, il lui faut de quoi lire et écrire. La limite « seulement notes/decisions.md » est dans ses instructions : c’est une consigne, pas un verrou. Tu vérifieras donc ce qu’il touche.

Piège fréquent : donner tous les outils « pour être tranquille ». Un relecteur qui peut écrire finit un jour par « corriger » ton texte sans que tu l’aies demandé. Retire tout ce que le rôle n’exige pas.

Étape 4 · Les lancer sur une vraie tâche

Remplace par un document réel de ton atelier :

Utilise le sous-agent relecteur sur [le brouillon à relire, dans brouillons/].
Rapporte sa liste telle quelle, sans rien corriger.
Ensuite, utilise le sous-agent documentaliste pour noter dans
notes/decisions.md : « Relecture du brouillon, [nombre] problèmes
signalés, décision à prendre par moi. »

Étape 5 · Contrôler les deux sorties

Ouvre le document et vérifie deux problèmes signalés : existent-ils vraiment ?
Ouvre notes/decisions.md : l’entrée est-elle datée, exacte, et seule modification faite ?

6. Faire toi-même

Sur une section de ton livrable, fais tourner un cycle complet : l’agent principal la produit ou l’améliore, le relecteur la juge, tu décides des corrections, le documentaliste note ta décision.

Consigne : avant de lancer, écris en une ligne pourquoi chacun des deux sous-agents est utile ici. Si tu ne trouves pas de raison pour l’un d’eux, ne l’appelle pas.

Résultat attendu : une section améliorée, une liste de problèmes dont tu as vérifié au moins deux, et une entrée de journal qui dit ce que tu as décidé et pourquoi.

7. Vérifier

Les deux sous-agents apparaissent dans /agents.
La description de chacun dit son rôle et le moment où l’appeler.
Le relecteur n’a que des outils de lecture, vérifié dans sa configuration.
Le documentaliste n’a modifié que notes/decisions.md.
Tu as contrôlé toi-même deux points du rapport du relecteur.
Tu sais dire quelle tâche ne mérite pas de sous-agent.

8. Ce que tu gardes

Dans CLAUDE.md et dans notes/equipe.md, ajoute une ligne : « Sous-agents : relecteur (lecture seule, après chaque version), documentaliste (notes/decisions.md uniquement). » Dans ton carnet de bord : « Un rôle, des outils limités, une description claire. Un sous-agent de plus = de l’usage et de l’attention en plus. »

9. Pour aller plus loin

Fais relire le même document par ton relecteur, puis par un second outil avec la grille de la leçon 3 : qui trouve quoi ?
La documentation sur code.claude.com/docs détaille où sont enregistrés les sous-agents et comment les partager avec un projet.