Étude de cas : cas client multi-agent

1. Périmètre conservé après anonymisation

Le produit étudié reste un dashboard applicatif complet avec workflow web, reporting, validations, backlog structuré et usage mobile. La partie la plus intéressante n'est pas l'interface elle-même, mais la manière dont plusieurs instances Claude Code se coordonnent pour produire, implémenter puis vérifier les changements.

• Un orchestrateur central déclenche les étapes et arbitre les retours QA.
• Un agent PMO formalise les besoins et les critères d'acceptation.
• Un agent Tech implémente, teste et documente.
• Un agent QA valide l'accessibilité, les E2E et les performances.
• Les échanges passent par des artefacts Markdown dans .claude/.

2. Architecture multi-agent

Le projet repose sur un workflow séquentiel. L'orchestrateur ouvre le cycle, le PMO cadre la demande, le Tech livre l'implémentation, puis le QA valide avant fusion ou retour en correction. Ce choix réduit les oublis de spécification et limite les corrections tardives.

Exemple de workflow orchestré

// apps/orchestrator/src/workflow/workflow.service.ts
@Injectable()
export class WorkflowService {
  async executeSpec(specId: string): Promise<WorkflowResult> {
    const pmoResult = await this.pmoAgent.validateSpec(specId);
    if (!pmoResult.approved) {
      return { status: 'blocked', reason: pmoResult.feedback };
    }

    const techResult = await this.techAgent.implement(specId);
    await this.saveImplementation(specId, techResult);

    const qaResult = await this.qaAgent.validate(specId);
    if (qaResult.passed) {
      await this.createMergeRequest(specId);
      return { status: 'completed', pr: qaResult.prUrl };
    }

    return this.handleQAFailure(specId, qaResult);
  }
}

3. Communication inter-agents

Les agents ne se parlent pas directement. Ils déposent des documents structurés dans .claude/. Ce protocole simplifie le suivi, réduit les ambiguïtés et laisse une trace exploitable en reprise de session.

4. Métriques observées

Répartition de l'effort

Le Tech réalise la plus grande part d'exécution, mais la valeur du système vient du fait que PMO et QA absorbent le cadrage et la vérification au lieu de laisser ces tâches implicites.

5. Stack technique

cas-client-multi-agent/
├── apps/
│   ├── api/              # Backend NestJS
│   ├── web/              # Frontend Angular
│   └── orchestrator/     # Coordination du workflow
├── libs/
│   ├── shared/           # Types partagés
│   ├── ui/               # Components réutilisables
│   └── data-access/      # Services et accès API
├── .claude/
│   ├── CLAUDE.md         # Règles globales
│   ├── specs/            # Livrables PMO
│   ├── implementations/  # Rapports Tech
│   └── test-reports/     # Rapports QA
└── nx.json               # Configuration du monorepo

6. Limites et enseignements