← Documentation

Architecture multi-agent (3 phases)

Comment Gaadji décompose une demande complexe en plan structuré, génère le code en parallèle et valide la cohérence avant livraison.

Vue d'ensemble

Le mode multi-agent est utilisé pour les projets moyens à gros (5+ fichiers, plusieurs modules). Un orchestrateur lit ta demande, la découpe en sous-tâches, et délègue à des sub-agents spécialisés.

Phase 1 — séquentielle · ~5-15 secondes

🎯 Orchestrateur + Plan

Claude Haiku 4.5 lit ta demande et produit un JSON structuré avec une liste ordonnée de tasks (plan, code, test, review). Chaque task code/test reçoit un champ owns_paths (chemins exclusifs) qui élimine les collisions inter-agents.

Ensuite l'agent plan produit un document plan.md partagé : architecture, modèles, endpoints, fichiers attendus. Ce plan est injecté dans le contexte de tous les agents code/test.

Phase 2 — parallèle · ~20-60 secondes

⚡ Code + Test agents (asyncio.gather)

Tous les agents code et test s'exécutent en parallèle via asyncio.gather, bornés par un Semaphore(3) pour respecter les rate limits Anthropic / DeepSeek.

Chaque agent code reçoit : son sub_prompt, le plan partagé, ses owns_paths exclusifs, et le rapport de conventions détectées dans le projet existant. Il ne produit que ses fichiers attribués — pas de bonus, pas de collision.

Phase 3 — séquentielle · ~5-15 secondes

✅ Static checker + Reviewer

Avant le reviewer LLM, un static checker régex (gratuit, déterministe) détecte les incohérences mécaniques : imports cross-fichiers KO, modèles Prisma utilisés mais non définis, collisions de paths. Le rapport est injecté au reviewer.

Le reviewer (Claude Haiku) voit tous les fichiers + le rapport static et propose maximum 5 fixes ciblés. Il ne réécrit pas les fichiers fonctionnels — il corrige les bugs structurels uniquement.

Limites volontaires (V1)

Cap budget : $0.50 par run par défaut (configurable jusqu'à $5)
12 tasks max par plan (orchestrateur)
3 agents simultanés max (semaphore anti rate-limit)
5 fichiers max par agent code (contrainte format JSON)
5 fixes max par reviewer
10 min max sur un stream SSE

Quand utiliser le multi-agent vs l'agent autonome

Agent autonome (Ctrl+Shift+G) : conversationnel, tour par tour, idéal pour les tâches itératives (1-10 fichiers, modifications, debug, refactor).

Multi-agent (Gaadji : Lancer un projet (multi-agent)) : one-shot, idéal pour bootstrapper un projet complet (10-25 fichiers, structure définie d'avance).

Coûts typiques Petit projet (calc + tests) : $0.005-0.05 · Moyen (API CRUD) : $0.02-0.20 · Gros (API + auth + tests) : $0.10-0.40

Voir aussi : Tutoriel · Bench mono vs multi · Cmd-K édition inline