Notes pratiques : Claude Code Agent Teams : Un guide pratique pour créer une équipe

Ce guide reconstitue le parcours allant des matières premières à un système fonctionnel pour : Claude Code Agent Teams : Un guide pratique pour créer une équipe de développeurs d’IA. L’accent est mis sur des étapes opérationnelles, des vérifications explicites, ainsi que du code que vous pouvez intégrer directement dans un dépôt sans devoir deviner son intention. Pour l’étape d’aperçu, définissez les entrées, le responsable de l’étape et les critères de fin avant de modifier le code. Les opérateurs doivent pouvoir relancer l’étape à partir d’un point de contrôle connu sans avoir à deviner l’état caché. Conservez la configuration en dehors du code de l’application. Les fichiers d’environnement, les bases de données secrètes et les indicateurs fonctionnels doivent être regroupés en un seul endroit que les opérateurs peuvent auditer sans devoir lire l’ensemble du système.

Qu’est-ce que Claude Code Agent Teams ?

Lors de la phase « Qu’est-ce que Claude Code ? », notez d’abord le contrat : les entrées requises, le signal de succès et ce qui se passe en cas d’échec partiel. Cette liste de contrôle permet de garantir l’honnêteté des modifications ultérieures du code. Documentez ensemble le parcours normal et le parcours de récupération. Les tentatives répétées, les contrôles humains et la gestion des messages non livrés font partie intégrante du produit, et non d’améliorations apportées ultérieurement. Créez un point de contrôle après les étapes coûteuses. Le système de reprise ne doit pas facturer à nouveau la même appel du LLM lorsque l’opérateur tente à nouveau un nœud ultérieur.

Team Lead

Backend
Frontend
Database
QA
Reviewer

Les équipes d’agents diffèrent des sous-agents

Lorsque vous travaillez sur les différentes étapes des Agent Teams, notez d’abord le contrat : les données requises, le signal de succès et ce qui se passe en cas d’échec partiel. Cette liste de contrôle permet de rester honnête lors des modifications ultérieures du code. Préférez des unités petites et testables plutôt que des scripts complexes. Lorsqu’une étape échoue, l’échec doit indiquer une seule responsabilité et non un processus embrouillé. Créez des points de contrôle après les étapes coûteuses. Le système de reprise ne doit pas facturer à nouveau la même appel au LLM lorsque l’opérateur réessaie un nœud ultérieur.

Main Agent
    ↓
Subagent
    ↓
Result

Team Lead
                 │
      ┌──────────┼──────────┐
      ↓          ↓          ↓
   Agent A ←→ Agent B ←→ Agent C
      │          │          │
      └──── Shared Tasks ───┘

Étape 1 : Activer les Agent Teams

Lors de la réalisation de l’étape 1 « Activer l’agent », notez d’abord le contrat : les entrées requises, le signal de succès et ce qui se passe en cas d’échec partiel. Cette liste de contrôle permet de garantir l’intégrité des modifications ultérieures du code. Considérez cette étape comme un contrat entre les entrées et les sorties validées. Donnez des noms aux artefacts, définez des vérifications de succès et refusez les terminations partielles silencieuses. Créez des points de contrôle après les étapes coûteuses. Le système de reprise ne doit pas facturer à nouveau la même appel du LLM lorsque l’opérateur réessaie un nœud ultérieur. Lors de la réalisation de l’étape 1 « Activer l’agent », notez d’abord le contrat : les entrées requises, le signal de succès et ce qui se passe en cas d’échec partiel. Cette liste de contrôle permet de garantir l’intégrité des modifications ultérieures du code. Gardez la configuration en dehors du code de l’application. Les fichiers d’environnement, les stocks de secrets et les flags fonctionnels doivent être regroupés en un seul endroit que les opérateurs peuvent auditer sans avoir à lire l’ensemble du système.

cd my-project
claude

Étape 2 : Commencer par le projet, pas par les agents

L’étape 2 « Commencer par » fonctionne le mieux lorsqu’elle est considérée comme une surface mesurable. Capturez un transcript exemplaire, un cas d’échec et la note de rollback avant d’élargir le périmètre. Documentez ensemble le parcours idéal et le parcours de récupération. Les tentatives répétées, les contrôles humains et la gestion des messages non livrés font partie du produit, et non d’une mise en forme ultérieure. Maintenez l’état du graphe plat et typé. Les blocs imbriqués cachent le fait que tel nœud a écrit telle champ et perturbent la reprise après interruption.

Build complete authentication for this application.

Requirements:- PostgreSQL user model
- FastAPI authentication API
- React login and registration
- JWT authentication
- refresh tokens
- automated testsUse an Agent Team.Act as the Team Lead.
Inspect the repository, determine the workstreams,
identify dependencies and create the teammates required.

Étape 3 : Laisser le chef d’équipe décomposer le projet

La étape 3 « Laissez la scène fonctionner » est optimale lorsqu’elle est considérée comme une surface mesurable. Capturez un transcript parfait, un cas d’échec et la note de réversion avant d’élargir le périmètre. Préférez des unités petites et testables aux scripts complexes. Lorsqu’une étape échoue, l’erreur doit indiquer une seule responsabilité plutôt qu’un processus embrouillé. Maintenez l’état du graphe plat et typé. Les blocs imbriqués cachent le fait que tel nœud a écrit telle champ et perturbent la reprise après interruption.

Authentication Design
Database Schema
API Implementation
Frontend UI
Integration
Testing
Security Review

Étape 4 : Identifier ce qui peut réellement s’exécuter en parallèle

Étape 4 : Déterminer quelle étape fonctionne le mieux lorsqu’elle est considérée comme une surface mesurable. Recueillir un exemplaire idéal, un cas d’échec et une note de réversion avant d’élargir le périmètre. Considérer cette étape comme un contrat entre les entrées et les sorties validées. Donner des noms aux artefacts, définir des vérifications de succès et refuser toute complétion partielle silencieuse. Maintenir l’état du graphe plat et typé. Les blocs imbriqués cachent le fait que tel nœud a écrit tel champ et perturbent la reprise après interruption. Étape 4 : Déterminer quelle étape fonctionne le mieux lorsqu’elle est considérée comme une surface mesurable. Recueillir un exemplaire idéal, un cas d’échec et une note de réversion avant d’élargir le périmètre. Conserver la configuration en dehors du code de l’application. Les fichiers d’environnement, les stocks de secrets et les flags fonctionnels doivent se trouver en un seul endroit que les opérateurs peuvent auditer sans devoir lire l’ensemble du graphe.

Schema
↓
API
↓
Integration

Backend
Frontend
Test Planning
Documentation
Security Review

Étape 5 : Créer des collaborateurs spécialisés

Pour l’étape 5 « Créer une étape spécialisée », définissez les entrées, le responsable de l’étape et les critères de fin avant de modifier le code. Les opérateurs doivent pouvoir relancer l’étape à partir d’un point de contrôle connu sans deviner l’état caché. Documentez ensemble le parcours idéal et le parcours de récupération. Les tentatives répétées, les contrôles humains et la gestion des messages non livrés font partie intégrante du produit, et non d’une mise en forme ultérieure. Imposez une approbation humaine pour les actions qui entraînent des dépenses ou modifient des données de production. La connexion en temps de compilation ne garantit pas la complétude du processus métier.

Team Lead
├── Backend Engineer
├── Frontend Engineer
├── Database Engineer
├── QA Engineer
└── Reviewer

Étape 6 : Assigner une responsabilité claire à chaque agent

Pour l’étape 6, définissez pour chaque étape les entrées nécessaires, le responsable de l’étape ainsi que les critères d’achèvement avant de modifier du code. Les opérateurs doivent pouvoir relancer l’étape à partir d’un point de contrôle connu, sans avoir à deviner l’état caché. Préférez des unités petites et testables aux scripts complexes. Lorsqu’une étape échoue, l’échec doit indiquer une seule responsabilité et non un processus embrouillé. Faites approuver par des humains les actions qui entraînent des dépenses ou modifient des données de production. Une connexion effectuée en temps de compilation ne garantit pas la complétude du processus métier.

Help with backend.

Backend Agent owns:

/api
/services
/auth

/pages
/components
/hooks

/schema
/migrations

/tests

Étape 7 : Utiliser la liste de tâches partagée

Pour l’étape 7 Use the stage, définissez les entrées, le responsable de l’étape et les critères de fin avant de modifier le code. Les opérateurs doivent pouvoir relancer l’étape à partir d’un point de contrôle connu sans deviner l’état caché. Considérez cette étape comme un contrat entre les entrées et les sorties validées. Donnez des noms aux artefacts, définites des vérifications de succès et refusez les terminations partielles silencieuses. Faites approuver par un humain les actions qui entraînent des dépenses ou modifient des données de production. La connexion en temps de compilation ne correspond pas à une complétude opérationnelle. Pour l’étape 7 Use the stage, définissez les entrées, le responsable de l’étape et les critères de fin avant de modifier le code. Les opérateurs doivent pouvoir relancer l’étape à partir d’un point de contrôle connu sans deviner l’état caché. Gardez la configuration en dehors du code de l’application. Les fichiers d’environnement, les bases de données secrètes et les indicateurs fonctionnels doivent être regroupés en un seul endroit que les opérateurs peuvent auditer sans avoir à lire l’ensemble du système.

[ ] Database schema
[ ] Registration API
[ ] Login API
[ ] Login UI
[ ] Registration UI
[ ] Integration tests
[ ] Security review

[x] Database schema
[x] Registration API
[x] Login API
[ ] Login UI
[ ] Registration UI
[ ] Integration tests
[ ] Security review

Étape 8 : Permettre aux membres de l’équipe de communiquer

Lors de l’exécution de l’Étape 8, faites en sorte que les membres de l’équipe élaborent d’abord le contrat : données requises, signal de succès et actions à entreprendre en cas d’échec partiel. Cette liste de contrôle garantit des modifications de code plus fiables par la suite. Documentez ensemble le parcours normal et les scénarios de récupération. Les tentatives répétées, les contrôles humains et la gestion des messages non traités font partie intégrante du produit, et non d’améliorations ultérieures. Faites un point après les étapes coûteuses. Le système de reprise ne doit pas facturer à nouveau la même appel du LLM lorsque l’opérateur tente à nouveau un nœud ultérieur.

Frontend → Backend

What does POST /auth/login return?

{
  "access_token": "...",
  "refresh_token": "...",
  "user": {
    "id": 10,
    "email": "user@example.com"
  }
}

Étape 9 : Maintenir le chef d’équipe concentré sur la coordination

Lors de l’exécution de l’Étape 9 « Maintenir la scène », notez d’abord le contrat : les entrées requises, le signal de succès et ce qui se passe en cas d’échec partiel. Cette liste de contrôle permet de rester honnête lors des modifications ultérieures du code. Préférez des unités petites et testables plutôt que des scripts volumineux. Lorsqu’une étape échoue, l’échec doit indiquer une seule responsabilité et non un processus embrouillé. Créez des points de contrôle après les étapes coûteuses. Le système de reprise ne doit pas facturer à nouveau la même appel d’LLM lorsque l’opérateur réessaie un nœud ultérieur.

Act primarily as the Team Lead.

Your responsibilities are:- understand the project
- decompose the work
- create tasks
- assign tasks
- identify dependencies
- monitor blockers
- coordinate teammates
- review completed work
- manage integration
- verify the final solutionDelegate implementation whenever appropriate.

Étape 10 : Permettre aux agents de prendre en charge de nouveaux travaux

Lors de l’exécution de l’Étape 10 « Laissez les agents mettre en phase », notez d’abord le contrat : les entrées requises, le signal de succès et ce qui se passe en cas d’échec partiel. Cette liste de contrôle permet de garantir l’intégrité des modifications ultérieures du code. Considérez cette étape comme un contrat entre les entrées et les sorties validées. Donnez des noms aux artefacts, définez des vérifications de succès et refusez toute exécution partielle silencieuse. Faites des points de contrôle après les étapes coûteuses. Le système de reprise ne doit pas facturer à nouveau la même appel du LLM lorsque l’opérateur réessaie un nœud ultérieur. Lors de l’exécution de l’Étape 10 « Laissez les agents mettre en phase », notez d’abord le contrat : les entrées requises, le signal de succès et ce qui se passe en cas d’échec partiel. Cette liste de contrôle permet de garantir l’intégrité des modifications ultérieures du code. Conservez la configuration en dehors du code de l’application. Les fichiers d’environnement, les stocks de secrets et les flags fonctionnels doivent être regroupés en un seul endroit que les opérateurs peuvent auditer sans avoir à lire l’ensemble du graphe.

Claim Task
↓
Work
↓
Complete
↓
Check Backlog
↓
Claim Next Task

Create an initial task backlog.

Agents should claim available tasks that match their role.When a teammate finishes its current task,
it should check the shared task list and claim
the next appropriate unblocked task.

Étape 11 : Rendre les dépendances explicites

L’étape 11 visant à rendre les dépendances explicites fonctionne le mieux lorsqu’elle est considérée comme une surface mesurable. Capturez un enregistrement exemplaire, un cas d’échec et la note de réversion avant d’élargir le périmètre. Documentez ensemble le parcours normal et le parcours de récupération. Les tentatives répétées, les contrôles humains et la gestion des messages non livrés font partie intégrante du produit, et non d’une mise en forme ultérieure. Maintenez l’état du graphe plat et typé. Les blocs imbriqués cachent le fait que tel nœud a écrit telle champ et perturbent la reprise après interruption.

API Contract
Backend
Frontend
Integration Tests

API Contract
         /        \
    Backend     Frontend
         \        /
       Integration

Identify task dependencies before work begins.

Do not allow agents to start blocked tasks.When a dependency is completed,
unblock the appropriate downstream task.

Étape 12 : Ajouter un examinateur indépendant

La étape 12 « Ajouter une phase » fonctionne le mieux lorsqu’elle est considérée comme une surface mesurable. Capturez un transcript parfait, un cas d’échec et la note de réversion avant d’élargir le périmètre. Préférez des unités petites et testables à des scripts complexes. Lorsqu’une étape échoue, l’échec doit pointer vers une seule responsabilité plutôt que vers un processus embrouillé. Maintenez l’état du graphe simple et typé. Les blocs imbriqués masquent le fait que tel nœud a écrit telle champ et perturbent la reprise après interruption.

Developers
    ↓
Reviewer
    ↓
Fixes

Create a Senior Code Reviewer teammate.

Do not use this teammate for feature development initially.Its responsibility is to review completed work for:- correctness
- architecture
- security
- duplicated logic
- error handling
- maintainability
- performanceWhen problems are identified,
create follow-up tasks for the appropriate developer.

Étape 13 : Ajouter un contrôle qualité indépendant

La étape 13 « Ajouter une couche indépendante » fonctionne le mieux lorsqu’elle est considérée comme une surface mesurable. Capturez un enregistrement idéal, un cas d’échec et la note de réversion avant d’élargir le périmètre. Traitez cette étape comme un contrat entre les entrées et les sorties validées. Nommez les artefacts, définites des vérifications de succès et refusez toute complétion partielle silencieuse. Maintenez l’état du graphe plat et typé. Les blocs imbriqués cachent le fait que tel nœud a écrit telle champ et perturbent la reprise après interruption. La étape 13 « Ajouter une couche indépendante » fonctionne le mieux lorsqu’elle est considérée comme une surface mesurable. Capturez un enregistrement idéal, un cas d’échec et la note de réversion avant d’élargir le périmètre. Gardez la configuration en dehors du code de l’application. Les fichiers d’environnement, les stocks de secrets et les flags fonctionnels doivent se trouver en un seul endroit que les opérateurs peuvent auditer sans devoir lire l’ensemble du graphe.

Developer
   ↓
Build
   ↓
QA
   ↓
Failure
   ↓
Fix
   ↓
Retest

Étape 14 : Ne créez pas trop d’agents

Pour l’Étape 14 « Ne pas mettre en production », définissez les entrées, le responsable de l’étape et les critères de fin avant de modifier le code. Les opérateurs doivent pouvoir relancer l’étape à partir d’un point de contrôle connu sans deviner l’état caché. Documentez ensemble le parcours normal et le parcours de récupération. Les tentatives répétées, les contrôles humains et la gestion des messages non livrés font partie du produit, et non d’une mise en forme ultérieure. Imposez une approbation humaine pour les actions qui entraînent des dépenses ou modifient des données de production. La connexion en temps de compilation ne garantit pas la complétude du processus métier.

Team Lead
Backend
Frontend
QA
Reviewer

Étape 15 : Définir ce que signifie « terminé »

Pour l’Étape 15 « Définir quelle étape », il faut définir les entrées, le responsable de l’étape ainsi que les critères d’arrêt avant de modifier du code. Les opérateurs doivent pouvoir relancer l’étape à partir d’un point de contrôle connu sans deviner l’état caché. Préférez des unités petites et testables aux scripts complexes. Lorsqu’une étape échoue, l’échec doit indiquer une seule responsabilité plutôt qu’un processus embrouillé. Faites approuver par un humain les actions qui entraînent des dépenses ou modifient des données de production. La connexion en temps de compilation ne garantit pas la complétude du processus métier.

Implementation complete
Tests passing
Build passing
Lint passing
Type checking passing
Integration working
Reviewer findings resolved
Documentation updated

Write code

Deliver working software

Étape 16 : Laisser le chef d’équipe effectuer l’intégration finale

Pour l’Étape 16, définissez la phase, les entrées, le responsable de l’étape ainsi que les critères de fin avant de modifier le code. Les opérateurs doivent pouvoir relancer l’étape à partir d’un point de contrôle connu sans deviner l’état caché. Considérez cette phase comme un contrat entre les entrées et les sorties validées. Donnez des noms aux artefacts, définites des vérifications de succès et refusez les terminations partielles silencieuses. Faites approuver par un humain les actions qui entraînent des dépenses ou modifient des données de production. La connexion en temps de compilation ne correspond pas à une complétude opérationnelle. Pour l’Étape 16, définissez la phase, les entrées, le responsable de l’étape ainsi que les critères de fin avant de modifier le code. Les opérateurs doivent pouvoir relancer l’étape à partir d’un point de contrôle connu sans deviner l’état caché. Gardez la configuration en dehors du code de l’application. Les fichiers d’environnement, les bases de données secrètes et les indicateurs fonctionnels doivent être regroupés en un seul endroit que les opérateurs peuvent auditer sans avoir à lire l’ensemble du système.

Review changes
↓
Run tests
↓
Build
↓
Check integration
↓
Find failures
↓
Delegate fixes
↓
Retest
↓
Ship

When teammates finish:

1. Inspect all changes.
2. Review the final diff.
3. Resolve inconsistencies between workstreams.
4. Run the full test suite.
5. Run linting.
6. Run type checking.
7. Verify the frontend builds.
8. Verify the backend starts.
9. Check remaining tasks.
10. Assign fixes when failures are discovered.
11. Re-run verification.
12. Only then declare the project complete.

Un prompt réutilisable pour les Agent Teams

Lors de la phase des Agent Teams réutilisables, notez d’abord les exigences : entrées requises, signal de succès et conséquences en cas d’échec partiel. Cette liste de contrôle permet de rester honnête lors des modifications ultérieures du code. Documentez à la fois le parcours normal et les scénarios de récupération. Les tentatives répétées, les contrôles humains et la gestion des messages non livrés font partie intégrante du produit, et non d’améliorations ultérieures. Mémorisez les instructions stables du système ainsi que les schémas des outils. Envoyer à nouveau un préambule identique est une cause fréquente de gaspillage.

Use Claude Code Agent Teams for this task.

You are the Team Lead.First inspect the repository and understand the existing architecture.Then:1. Break the objective into a task graph.
2. Identify dependencies between tasks.
3. Identify which tasks can run in parallel.
4. Create only the teammates that are genuinely useful.
5. Give every teammate a specialized role.
6. Give every teammate clear ownership.
7. Avoid multiple agents modifying the same files unless necessary.
8. Use the shared task list to coordinate work.
9. Allow teammates to communicate when information is required
   from another workstream.
10. Let teammates claim appropriate unblocked work after finishing
    their current tasks.
11. Add independent QA and review tasks.
12. Create follow-up tasks when problems are discovered.
13. Continue until all required tasks are complete.
14. Run tests, builds, linting and type checks.
15. Review the final diff yourself.
16. Do not declare completion while known issues remain.Act primarily as Team Lead.Delegate implementation whenever appropriate instead of
performing all work yourself.

Quand les Agent Teams sont utiles

Lorsque vous travaillez sur la création d’équipes d’agents, notez d’abord le contrat : les entrées requises, le signal de succès et ce qui se passe en cas d’échec partiel. Cette liste de contrôle permet de rester honnête lors des modifications ultérieures du code. Préférez des unités petites et testables plutôt que des scripts complexes. Lorsqu’une étape échoue, l’échec doit indiquer une seule responsabilité et non un processus embrouillé. Faites des points de contrôle après les étapes coûteuses. Le système de reprise ne doit pas facturer à nouveau la même appel d’LLM lorsque l’opérateur réessaie un nœud ultérieur.

Fix this validation bug.

Le changement majeur

Lors de la phase « The bigger shift », notez d’abord le contrat : les entrées requises, le signal de succès et ce qui se passe en cas d’échec partiel. Cette liste de contrôle garantit l’honnêteté des modifications ultérieures du code. Considérez cette phase comme un contrat entre les entrées et les sorties validées. Donnez des noms aux artefacts, définez des vérifications de succès et refusez les terminations partielles silencieuses. Faites des points de contrôle après les étapes coûteuses. Le système de reprise ne doit pas facturer à nouveau la même appel du LLM lorsque l’opérateur réessaie un nœud ultérieur. Lors de la phase « The bigger shift », notez d’abord le contrat : les entrées requises, le signal de succès et ce qui se passe en cas d’échec partiel. Cette liste de contrôle garantit l’honnêteté des modifications ultérieures du code. Gardez la configuration en dehors du code de l’application. Les fichiers d’environnement, les bases de données secrètes et les indicateurs fonctionnels doivent être regroupés en un seul endroit que les opérateurs peuvent auditer sans devoir lire l’ensemble du graphe.

AI Coding Assistant

AI Developer

AI Agents

AI Development Team

Que apprendre ensuite

La phase « Que apprendre ensuite » fonctionne le mieux lorsqu’elle est considérée comme une surface mesurable. Recueillez un enregistrement idéal, un cas d’échec et la note de réversion avant d’élargir le périmètre. Documentez ensemble le parcours normal et le parcours de récupération. Les tentatives répétées, les contrôles humains et la gestion des messages non livrés font partie du produit, et non d’une mise en forme ultérieure. Maintenez l’état du graphe plat et typé. Les blocs imbriqués cachent le fait que tel nœud a écrit telle champ et perturbent la reprise après des interruptions.

Claude Code
↓
Subagents
↓
Agent Teams
↓
Shared Tasks
↓
Agent Communication
↓
Parallel Development
↓
QA + Reviewer Agents
↓
Autonomous Development Teams

Liste de contrôle opérationnelle

La phase « Liste de contrôle opérationnelle » fonctionne le mieux lorsqu’elle est considérée comme une surface mesurable. Recueillez un enregistrement idéal, un cas d’échec et la note de réversion avant d’élargir le périmètre.

Enregistrez les temps d’exécution ainsi que le coût des jetons ou des requêtes à côté des résultats fonctionnels. Une visibilité précoce du coût permet d’éviter des factures inattendues lorsque le chemin passe de l’environnement de démonstration à des environnements partagés.

Gardez l’état du graphe plat et typé. Les blocs imbriqués cachent le fait que tel nœud a écrit telle champ et empêchent la reprise après une interruption.

Ajoutez un test de fumée qui met à l’épreuve le chemin critique dans les processus d’intégration continue en utilisant des fixtures, et non des API payantes en ligne, chaque fois que le budget le permet.

Gardez la configuration en dehors du code de l’application. Les fichiers d’environnement, les bases de données secrètes et les indicateurs fonctionnels doivent être regroupés en un seul endroit que les administrateurs peuvent auditer sans devoir lire l’ensemble du graphe.

Gardez l’état du graphe plat et typé. Les blocs imbriqués cachent le fait que tel nœud a écrit telle champ et empêchent la reprise après une interruption.

Au préalable de promouvoir le stack, figez les versions, conservez une transcription « or » pour le chemin critique, et confirmez les étapes de rollback. Les environnements partagés nécessitent des limites de débit, des vérifications de location, ainsi qu’un responsable clair pour la rotation des secrets. Préférez une fiabilité solide à des démonstrations brillantes mais ponctuelles.

Note de batch pour b860522250c5 : gardez les clés du fournisseur hors du repo, fixez un plafond pour les tokens par session, et stockez les transcriptions à côté des fichiers d’évaluation afin que les remplacements de modèles ultérieurs restent comparables.