Deux agents de code, un projet complexe : comment répartir le travail (retours d'expérience d'un calculateur Jeep de 1994)

Claude Code et Codex ont rétro-ingénieré l'ordinateur moteur d'une Jeep de 1994 avec un Arduino à 3 dollars. Voici le schéma réutilisable qui se cache derrière : trois façons de répartir un projet complexe entre deux agents de programmation, la manière dont ils se transmettent le contexte, et...

Ryan Mitchell

Ryan Mitchell

18 novembre 2026

Deux agents de code, un projet complexe : comment répartir le travail (retours d'expérience d'un calculateur Jeep de 1994)

Réponse rapide : pour répartir un projet difficile entre deux agents de codage, donnez à chaque agent un rôle qui produit quelque chose que l’autre peut vérifier : l’un explore et consigne ce qu’il a appris, l’autre construit à partir de cette documentation, ou bien les deux tentent la même étape et vous comparez les résultats. Conservez le contexte partagé dans un seul fichier que les deux agents lisent, et faites précéder toute action touchant le monde réel d’une approbation humaine.

Le Jeep Cherokee 1994 d’un développeur n’a pas de port OBD2, la prise de diagnostic standard des voitures plus récentes, et selon ses mots « aucun outil de diagnostic compatible ». Rien ne pouvait lire son calculateur moteur (l’ECU). Il a câblé un Arduino Nano à 3 $ sur la prise de diagnostic et a confié le travail à deux agents de codage, Claude Code et Codex. La vidéo de ce projet a recueilli 450 points et plus de 230 commentaires sur Hacker News ce mois-ci.

La partie utile pour votre équipe, c’est la manière dont un projet difficile et inconnu a été mené à bien par deux agents différents et un humain vigilant. Ce guide transforme cela en un modèle réutilisable et montre où Sharkly prend le relais lorsque les deux agents dépassent le stade de deux onglets de terminal.

Ce que le projet Jeep ECU révèle sur l’utilisation de deux agents de codage

Voici ce que dit la source, et rien de plus. Dans la description de la vidéo, l’auteur explique qu’en environ une semaine, les agents ont « lu le calculateur en direct, enregistré mes trajets, copié l’intégralité de son programme et exécuté leur propre code à l’intérieur ». La liste des chapitres crédite Claude d’avoir déterminé le câblage et d’avoir lancé le test de la pompe à carburant, et Codex d’avoir exécuté du code à l’intérieur du calculateur. Un chapitre s’intitule « The night drive: the tool was wrong » (la route de nuit : l’outil se trompait).

Le dépôt xj-scanner qui en a résulté est l’artefact le plus intéressant. Trois détails se détachent :

  1. Un seul fichier d’instructions partagé. AGENTS.md est le point d’entrée pour « tout agent travaillant dans ce dépôt ». CLAUDE.md est une simple ligne qui renvoie vers lui, de sorte que Claude Code et Codex lisent les mêmes règles.
  2. Des connaissances consignées par écrit. Le dossier docs/ contient le brochage de la prise, le protocole et chaque paramètre avec son facteur d’échelle, si bien que l’agent suivant part de ce que le précédent a appris.
  3. Des arrêts obligatoires pour un humain. Les règles précisent que la lecture est sans danger, mais que l’effacement des codes défaut, la réinitialisation des adaptations carburant et les tests d’actionneurs qui « actionnent du matériel réel » requièrent chacun l’accord préalable de la personne.

La vidéo ne publie pas de répartition formelle du travail, donc considérez la répartition ci-dessous comme un modèle déduit du résultat, et non comme la transcription de ses sessions.

Quand un projet difficile nécessite deux agents de codage

Utilisez deux agents lorsque le travail présente un coût élevé en cas d’erreur commise avec assurance. La rétro-ingénierie, les migrations, les protocoles inconnus et le débogage sans documentation entrent tous dans cette catégorie. Un second agent reposant sur un modèle différent vous apporte un regard indépendant, et le désaccord entre eux est un signal exploitable.

Passez votre tour sur le second agent lorsque la tâche est petite et bien spécifiée. La documentation Sharkly sur les Crews fait la même remarque à propos de la coordination en général : attribuez les petits travaux bien définis à un seul Agent, et ne constituez une équipe que lorsque quelqu’un doit interpréter l’objectif et combiner les résultats.

Trois façons de répartir un projet entre agents de codage

Choisissez un modèle par phase, pas par projet. La découverte, la construction et les tests à risque en conditions réelles appellent chacun une répartition différente.

Modèle Agent A Agent B Quand l’utiliser
Explorateur et constructeur Investigue, consigne ses découvertes dans un fichier Construit à partir de ces découvertes Le domaine est inconnu et la documentation est pauvre
Deux tentatives indépendantes Résout l’étape seul Résout la même étape seul Une réponse erronée est coûteuse et difficile à repérer
Constructeur et relecteur Écrit la modification La vérifie face à la spécification et aux données La modification est claire mais le risque est élevé

Explorateur et constructeur : qui écrit la carte ?

Le produit de l’explorateur est un document, pas du code. Dans xj-scanner, c’est le dossier docs/ : le connecteur mesuré cavité par cavité, le protocole, le tableau des paramètres. Le constructeur travaille à partir de ce fichier et n’a jamais à redécouvrir le brochage. Si le constructeur tombe sur une contradiction, il met à jour le document, afin que la carte reste la source unique de vérité.

Deux tentatives indépendantes : comment les comparer ?

Donnez aux deux agents le même prompt et les mêmes entrées, sans que l’un voie la réponse de l’autre. Comparez ensuite les sorties sur des données fiables. Pour un décodeur de protocole, cela signifie alimenter les deux avec le même journal capturé et comparer les valeurs décodées. Nous détaillons une configuration équitable pour cela dans Claude Code vs Codex sur le même bug.

Constructeur et relecteur : que vérifie le relecteur ?

Le relecteur confronte les affirmations aux preuves, pas au style. « L’adaptation carburant indique +40 % » est une affirmation ; le relecteur demande si la formule d’échelle est correcte avant que quiconque n’agisse en conséquence. Les règles de xj-scanner intègrent cela : « Une lecture qui paraît aberrante peut être une particularité d’échelle. » Notre guide sur les Crews à modèles mixtes avec un relecteur dédié approfondit l’association d’un exécutant moins coûteux avec un relecteur plus puissant.

Comment deux agents de codage se transmettent le contexte

Les agents ne partagent pas leur mémoire ; la transmission doit donc s’appuyer sur des fichiers et des enregistrements de tâches. Quatre éléments portent l’essentiel de la charge :

  • Un fichier d’instructions lu par les deux agents. AGENTS.md est le format ouvert que Codex lit ; Claude Code lit CLAUDE.md, et sa documentation sur la mémoire décrit l’importation d’autres fichiers. Un CLAUDE.md d’une ligne qui pointe vers AGENTS.md permet de maintenir les deux sur les mêmes règles.
  • Un document de découvertes par domaine. Les brochages, protocoles et particularités vont dans docs/, pas dans un historique de conversation qui disparaît.
  • Des journaux comme preuves partagées. xj-scanner enregistre chaque trajet dans pc/logs/ en CSV, si bien que l’un ou l’autre agent peut analyser la même exécution.
  • Une note de transmission par étape. Ce qui a été tenté, ce qui a fonctionné, ce qui reste non vérifié, et la commande suivante.

Une note de transmission peut être aussi brève que ceci (valeurs illustratives, pas issues du dépôt du Jeep) :

## Handoff: SCI read of live sensor data
- Done: Nano bridge sketch flashed, DEMO mode passes on the laptop side
- Confirmed: cavities 2 (ground), 3, 4 measured with key ON
- Unverified: fuel trim scaling; reading looks high on idle
- Next: Codex decodes pc/logs/xj_2026-11-03.csv with both scaling formulas
- Needs a human: any actuator test or code erase

Pour d’autres formats, consultez nos modèles de transmission entre agents de codage et le guide sur la conservation du contexte lors du passage d’un agent de codage à l’autre.

Où l’humain vérifie le résultat

Placez une personne à chaque étape difficile à annuler, et nulle part ailleurs. Les règles de xj-scanner sont un modèle exemplaire :

  1. Avant toute intervention physique. « Ne jamais laisser quoi que ce soit être connecté à une cavité 12 V. » La personne mesure d’abord chaque cavité.
  2. Avant toute commande destructive. Effacer les codes efface aussi les données carburant apprises ; l’agent demande donc et explique.
  3. Avant de se fier à un diagnostic. « Ne devinez pas un diagnostic. Rapportez ce que montrent les données, et ce qu’elles ne montrent pas. »
  4. Après une surprise. Le chapitre de la route de nuit indique que l’outil se trompait ; les données du monde réel constituent la vérification qu’aucun agent ne peut contourner.

La même règle vaut pour une équipe logicielle. Les fusions vers main, les migrations de schéma, et tout ce qui envoie des e-mails ou dépense de l’argent doivent passer par un humain. Tout le reste peut circuler entre les agents. Si la relecture est déjà votre goulot d’étranglement, lisez concevoir la relecture pour des agents en parallèle.

Mettre en œuvre une répartition à deux agents dans Sharkly

Dans un terminal, la répartition reste dans votre tête : quel onglet exécute quel agent, et qui vous attend. Sharkly la transfère sur une tâche.

Vous connectez un Computer, et Sharkly détecte sur lui les outils d’agents comme des Runtimes, par exemple Claude Code et Codex. Vous créez un Agent pour chaque rôle. Puis vous construisez un Crew : un Agent leader, plus les Agents explorateur, constructeur ou relecteur, et les People qui approuvent.

Assignez la tâche au Crew, et l’exécution démarre par le leader, conformément à la documentation des Crews. Le leader lit la tâche et les instructions du Crew, mentionne les Agents membres dont il a besoin, et ces membres travaillent sur la même tâche et publient leurs résultats dans son chat. Le leader les combine. Vos descriptions de rôles deviennent des instructions du Crew : quand solliciter le relecteur, comment fusionner deux tentatives, et quand une personne décide.

Deux détails importent pour ce modèle. Le travail sur dépôt peut utiliser un git worktree distinct pour chaque exécution, afin que deux agents tentant la même étape ne s’écrasent pas mutuellement (documentation d’exécution des tâches). Et chaque exécution possède un état dans le journal d’exécution de la tâche, ce qui vous permet de voir quel agent est en file, en cours ou terminé sans ouvrir de terminaux.

Alternatives à un Crew à deux agents

Vous avez d’autres options, dont certaines conviennent mieux :

  • Un agent, deux passes. Demandez au même agent de construire, puis de relire dans une session vierge. Moins coûteux, mais le même modèle a tendance à répéter ses propres angles morts.
  • Deux terminaux, un dépôt partagé. Cela convient pour un projet de week-end comme le Jeep. Cela devient difficile à suivre dès qu’il y a plusieurs tâches et un coéquipier. Voir faire tourner Claude Code et Codex ensemble sur un même code base.
  • Agents en parallèle sur des tâches distinctes. Utile pour le débit, pas pour la vérification mutuelle. Méfiez-vous du cas où deux agents modifient le même fichier.

Conclusion

Le projet Jeep a fonctionné parce que les connaissances vivaient dans des fichiers, que les deux agents lisaient les mêmes règles, et qu’un humain se tenait devant chaque action à risque. Copiez ces trois habitudes et deux agents de codage deviennent un contrôle mutuel plutôt que deux sources de suppositions assurées.

Prochaine étape : choisissez une tâche difficile cette semaine, rédigez ses règles AGENTS.md et sa note de transmission, et exécutez-la comme un Crew dans Sharkly avec un Agent relecteur et une personne pour l’approbation.

FAQ

Claude Code et Codex peuvent-ils travailler sur le même projet ?

Oui. Les deux lisent les fichiers d’instructions du dépôt : Codex lit AGENTS.md, et Claude Code lit CLAUDE.md, qui peut pointer vers AGENTS.md. Attribuez-leur un worktree séparé ou une étape distincte pour qu’ils ne modifient pas les mêmes fichiers en même temps.

Comment les agents de codage partagent-ils le contexte ?

Par des fichiers et des enregistrements de tâches, pas par la mémoire. Conservez les règles dans AGENTS.md, les découvertes dans un dossier de documentation, les données brutes dans les journaux, et une courte note de transmission par étape.

Où un humain doit-il approuver le travail des agents ?

Avant tout ce qui est difficile à annuler : actions sur le matériel, commandes destructives, fusions vers main, migrations, et tout ce qui envoie des messages ou dépense de l’argent. Laissez le reste circuler entre les agents.

Claude Code et Codex ont-ils fait la rétro-ingénierie du Jeep ECU tout seuls ?

Non. Le développeur a effectué le câblage, les mesures et la conduite, et les règles du dépôt exigent l’accord de la personne avant toute commande à risque. Les agents ont lu le calculateur, enregistré les trajets, copié son programme et exécuté du code à l’intérieur.

Faut-il une plateforme pour faire tourner deux agents de codage ?

Non. Deux terminaux et un dépôt partagé suffisent pour un seul projet. Une plateforme commence à se justifier lorsque plusieurs tâches, coéquipiers et approbations sont en cours, et que vous avez besoin d’un enregistrement unique de qui a fait quoi.

À explorer aussi

Guide GPT-6.2 Codex : comment utiliser Astra et Sol pour le codage

Guide GPT-6.2 Codex : comment utiliser Astra et Sol pour le codage

Configuration de GPT-6.2 Codex : quand choisir Astra ou Sol, comment basculer avec /model ou config.toml, quel niveau d'effort de raisonnement adopter au départ, et comment répartir les agents Codex d'une équipe.

18 novembre 2026

Le code généré par l'IA doit-il être open source ? Ce que cela change pour les équipes qui livrent avec des agents

Le code généré par l'IA doit-il être open source ? Ce que cela change pour les équipes qui livrent avec des agents

Un post sur Hacker News soutient que tout le code généré par l'IA devrait être open source. Voici l'argumentaire, les contre-arguments, l'état du droit d'auteur aux États-Unis et au Royaume-Uni, ainsi que le suivi de provenance dont toute équipe qui livre du code avec des agents de programmation...

18 novembre 2026

ChatGPT pour les entreprises : ce que ça change pour les petites équipes

ChatGPT pour les entreprises : ce que ça change pour les petites équipes

ChatGPT pour les entreprises, expliqué aux petites équipes : à quoi servent Business Hub et Business Agents, ce qu'OpenAI annonce comme tarif, et qui assure la maintenance hebdomadaire.

17 novembre 2026