Construire : sessions parallèles et sous-agents

Objectifs

À l’issue de cette leçon, vous serez capable de :

• Mener plusieurs tâches de front avec des sessions Claude Code parallèles, chacune dans son worktree
• Confier les tâches récurrentes à des sous-agents définis dans le dépôt

Ce qui change

Traditionnellement, un ingénieur mène une tâche à la fois et passe une bonne partie de sa semaine à attendre des builds, des tests et des revues. Changer de tâche pendant l’attente est possible, mais si épuisant que peu s’y risquent.

Dans un cycle AI-native, un ingénieur pilote plusieurs flux à la fois :

• une session parallèle est une instance complète de Claude Code, qui travaille sur une tâche distincte dans son propre worktree Git ; les sessions ne savent rien les unes des autres, et seul l’ingénieur qui les pilote les relie ;
• un sous-agent travaille à l’intérieur d’une session, avec sa propre fenêtre de contexte et des outils limités ; il convient aux tâches qui reviennent d’un changement à l’autre, comme vérifier que l’application fonctionne.

Les sessions parallèles augmentent le nombre de tâches en cours ; les sous-agents gardent chaque session concentrée. Le travail de l’ingénieur devient le pilotage et la relecture.

Pour démarrer

• Prérequis : le CLAUDE.md (toutes les sessions le lisent) ; la boucle de vérification (leçon 8) aide, car une session qui vérifie elle-même son travail demande moins de supervision.
• Infrastructure : un dépôt Git, car l’isolation vient des worktrees, et des réglages de permissions qui évitent aux sessions d’attendre une autorisation pour les commandes que l’organisation juge sûres.

Mise en œuvre

1. Partez du plan (leçon 4) pour repérer ce qui est indépendant. Les tâches qui touchent les mêmes fichiers restent dans une seule session, l’une après l’autre.
2. Lancez une session par tâche indépendante, chacune dans son worktree, par exemple claude --worktree authentification dans un terminal et claude --worktree limite-debit dans un autre. Un worktree est une copie de travail distincte sur sa propre branche : les sessions ne se marchent pas sur les fichiers.
3. Commencez avec deux ou trois sessions. Le plafond réel est le nombre de flux qu’une personne peut relire correctement : n’en ajoutez que si la relecture suit.
4. Définissez les sous-agents récurrents dans .claude/agents/, chacun avec un nom, une description de quand l’utiliser et les outils autorisés. Exemples : un simplificateur qui retire la complexité inutile après l’agent principal, un vérificateur qui lance l’application et contrôle le comportement, un explorateur qui étudie la base de code et rend compte sans encombrer le contexte principal. Versionnez ces définitions pour que toute l’équipe les partage.

---
name: verificateur
description: Lance l'application et vérifie que le changement fonctionne avant que la session annonce la fin du travail
tools: Bash, Read
---
Démarre l'application avec make run. Exerce le comportement modifié et les deux parcours voisins les plus proches.
Indique ce que tu as lancé, ce que tu as observé, et tout comportement qui ne correspond pas à plan.md.
Ne corrige rien : rends compte seulement.

Gouvernance et mesure

Plus de sessions, c’est plus de production : les contrôles doivent venir de la configuration du dépôt. Les hooks et les réglages de permissions s’y appliquent à toutes les sessions, et ce que fait chaque session est tracé et attribué à l’ingénieur qui l’a lancée.

• Indicateur avancé : le nombre de sessions simultanées par ingénieur à qualité de relecture constante, mesuré par l’export OpenTelemetry, et la part du temps passée à piloter plutôt qu’à attendre.
• Indicateur retardé : les changements fusionnés par ingénieur et par semaine, lus avec le taux de reprise.

À vous de jouer

Deux sessions et un vérificateur. Dans un plan réel, repérez deux tâches qui ne touchent pas les mêmes fichiers, et lancez-les dans deux worktrees, chacune avec sa session. Définissez dans .claude/agents/ un sous-agent vérificateur qui lance l’application et rend compte sans rien corriger. Notez à la fin de la journée le nombre de flux que vous avez pu relire correctement : c’est votre plafond actuel.

Sources officielles : Parallel sessions and subagents (Claude Academy) · The AI-native SDLC playbook — Stage 3: Build · Subagents · Monitoring · cours Introduction aux sous-agents

Points clés à retenir

• Une session parallèle par tâche indépendante, chacune dans son worktree ; les tâches qui partagent des fichiers restent ensemble
• Deux ou trois sessions pour commencer : le plafond est ce que vous pouvez relire correctement
• Des sous-agents versionnés dans .claude/agents/ pour les tâches récurrentes, avec des outils limités
• Les contrôles viennent de la configuration du dépôt, qui s’applique à toutes les sessions