Faire équipe avec Claude Code et un second agent dans le même dossier

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

Ajouter un second agent de code dans le même dossier que Claude Code, sans désordre.
Donner aux deux agents les mêmes règles grâce à CLAUDE.md et AGENTS.md.
Organiser le travail : Claude Code écrit, le second agent relit sans modifier.
Appliquer la règle du stylo unique et protéger ton dossier par un point de sauvegarde.

2. Pourquoi ça t’intéresse

Julien, professeur de technologie, construit avec Claude Code un petit outil qui génère les fiches de séance de ses élèves (module 10). Un soir, il lance un second agent dans le même dossier pour « corriger un détail » pendant que Claude Code travaille encore. Les deux modifient le même fichier : le résultat ne fonctionne plus, et Julien ne sait pas lequel a fait quoi. Il recommence avec un point de sauvegarde et des règles communes : Claude Code écrit, le second agent relit seulement. Au premier passage, le relecteur repère une séance plus longue que l’heure de cours.

3. Avant de commencer


Il te faut	Claude Code, ton dossier `atelier-multi-ia` avec `brouillons/v2.md` (leçon 3), les points de sauvegarde du module 5, et si tu le souhaites un second agent comme Codex (l’agent de code d’OpenAI)
Coût	Ton abonnement à l’agent (claude.com/pricing) ; pour le second agent, vérifie les conditions d’accès sur sa page officielle (chatgpt.com/pricing pour Codex)
Durée	75 à 90 minutes

4. Comprendre en 3 minutes

Deux agents dans un même dossier, c’est deux personnes dans une même cuisine : il faut les mêmes consignes, des rôles clairs, et un seul cuisinier au fourneau à la fois.

Trois règles font tout fonctionner :

Règle	Concrètement
Mêmes consignes	Claude Code lit `CLAUDE.md`, Codex lit `AGENTS.md`, tous deux à la racine du dossier. Les deux fichiers disent la même chose, ou `AGENTS.md` renvoie à `CLAUDE.md` en reprenant les règles essentielles.
Un seul stylo	Un seul agent modifie les fichiers. L’autre lit et commente. Jamais deux agents qui écrivent dans les mêmes fichiers en même temps.
Filet de sécurité	Un point de sauvegarde avant chaque intervention du second agent, pour voir ce qui a changé et pouvoir revenir en arrière.

L’avantage sur un chatbot : le second agent lit lui-même le brief, le plan, les décisions et le livrable. Plus de copier-coller, et un regard sur l’ensemble.

Pour Codex, aucune commande ici : l’outil évolue vite. Pour l’installer, le lancer dans un dossier et régler ce qu’il a le droit de faire, suis la documentation officielle (developers.openai.com/codex). Si l’outil propose un fonctionnement où il ne fait que lire, ou demande ton accord avant chaque modification, choisis-le pour le rôle de relecteur.

Pas de second abonnement ? Une seconde session de Claude Code en mode plan, ou le sous-agent relecteur du module 8, peut tenir le rôle : regard moins différent, méthode identique.

5. Faire ensemble

Étape 1 · Poser le point de sauvegarde

Lance claude dans atelier-multi-ia :

Crée un point de sauvegarde de tout le dossier avec le message « Avant second agent ». Si ce dossier n'a pas encore de points de sauvegarde, explique-moi ce que tu vas faire avant de commencer.

Étape 2 · Écrire les consignes communes

Complète CLAUDE.md avec une section « Travail à plusieurs agents » : Claude Code est le seul à modifier les fichiers ; tout autre agent lit et commente sans rien modifier ; aucun fichier de sources n'est jamais modifié ; on travaille sur [ton livrable].
Puis crée AGENTS.md à la racine : il reprend mot pour mot les règles de cette section et indique que le reste des consignes se trouve dans CLAUDE.md.
Montre-moi les deux textes avant de les écrire.

Relis : une règle absente d’un des deux fichiers est un futur conflit.

Étape 3 · Claude Code propose un plan

Appuie sur Maj+Tab jusqu’au mode plan, puis :

Lis brouillons/v2.md, notes/decisions.md et brief.md. Propose le plan pour transformer la v2 en version finale dans livrables/, en [nombre] étapes au plus. Ne modifie rien.

Quand le plan te convient, quitte le mode plan et demande à Claude Code de l’enregistrer dans notes/plan-final.md, sans toucher à rien d’autre. Puis laisse-le en attente : ne lui donne plus de tâche.

Étape 4 · Le second agent relit sans modifier

Lance ton second agent dans le même dossier, en suivant sa documentation. Vérifie d’abord qu’il a lu ses consignes :

Avant tout, résume en trois lignes les règles de AGENTS.md qui te concernent.

S’il ne mentionne pas l’interdiction de modifier, arrête-le et corrige AGENTS.md. Sinon :

Tu es relecteur. Ne modifie aucun fichier. Lis brief.md, notes/plan-final.md et brouillons/v2.md, puis applique la grille de relecture critique : exactitude, complétude, adéquation à [le destinataire], clarté, cohérence, risques. Donne une liste de remarques classées par gravité, avec leur emplacement.

Copie sa réponse dans relectures/relecture-plan.md, puis ferme sa session.

Étape 5 · Trier, exécuter, contrôler

Trie les remarques (juste, discutable, faux) comme à la leçon 3.
Dans Claude Code : « Mets à jour notes/plan-final.md avec les remarques que j’ai classées justes dans relectures/relecture-plan.md, puis exécute le plan étape par étape. »
Demande-lui de te montrer ce qui a changé depuis le point de sauvegarde « Avant second agent ».
Si tout est bon, nouveau point de sauvegarde : « Version finale relue ».

6. Faire toi-même

Fais un second cycle complet sur ton livrable, en inversant ce qui est relu : cette fois, le second agent relit livrables/ (le résultat final), toujours sans rien modifier. Si ton livrable est un petit outil ou une page web, demande-lui en plus de repérer les cas où il ne fonctionnerait pas.

Résultat attendu : un livrable final dans livrables/, deux fichiers de relecture triés, trois points de sauvegarde, et dans notes/decisions.md une ligne par cycle.

7. Vérifier

CLAUDE.md et AGENTS.md contiennent les mêmes règles de travail à plusieurs.
Le second agent a restitué ses consignes avant de commencer.
Il n’a modifié aucun fichier : je l’ai constaté en demandant à Claude Code ce qui a changé depuis le dernier point de sauvegarde.
À aucun moment deux agents n’ont travaillé sur les mêmes fichiers en même temps.
Chaque remarque du relecteur a été triée par moi avant d’être appliquée.
Mon historique contient un point de sauvegarde avant et après chaque intervention.

Piège fréquent : laisser les deux agents ouverts « pour gagner du temps » et leur donner chacun une tâche d’écriture. Ils ne se voient pas travailler et s’écrasent l’un l’autre. Un seul stylo à la fois ; l’autre agent attend ou relit.

8. Ce que tu gardes

Ton AGENTS.md, ton CLAUDE.md mis à jour, et dans ton carnet : « Point de sauvegarde, consignes communes, un seul stylo, le second agent relit, je trie, je tranche. » C’est la méthode du module 1 jouée à plusieurs : Dire, Discuter, Faire, Vérifier, Noter.

9. Pour aller plus loin

Échange les rôles sur un autre projet : le second agent écrit, Claude Code relit. Compare les remarques.
Consulte régulièrement code.claude.com/docs et developers.openai.com/codex : les agents évoluent, ta répartition des rôles aussi.