Orchestration d'équipe IA

Quand l'utiliser

Lancer un nouveau projet nécessitant planification, développement, tests et déploiement
Mettre en place des équipes d'agents IA parallèles (dev, QA, DevOps)
Rédiger des prompts de brainstorm qui produisent de vrais débats (pas de contenu générique)
Créer des plans de sprint avec survie du contexte entre chats
Récupérer après un débordement de contexte en cours de sprint

Rôles de l'équipe

Agent	Nom	Rôle	Focus
Producer	Remy	Planification de sprint, coordination, fusion de PRs	Contrôle de périmètre, passations, triage d'issues
Product Designer	Kira	UX, mécanique, expérience utilisateur	Facteur fun, flux utilisateur, design de features
Visual/Art Director	Milo	CSS, animations, identité visuelle	Système de design, polish, accessibilité
Frontend Engineer	Nova	Framework UI, gestion d'état, composants	React/Vue/Svelte, logique côté client
Backend Engineer	Sage	API, base de données, auth, sécurité	Logique serveur, infrastructure
DevOps Engineer	Dash	CI/CD, déploiement cloud, pipelines	GitHub Actions, Azure/AWS/GCP
QA Engineer	Ivy	Tests E2E, automation, playtesting	Playwright/Cypress, filing de bugs, sign-off

Adaptez les noms et rôles à votre projet. Tous les rôles ne sont pas nécessaires pour chaque projet.

Architecture des chats

L'humain (CEO) est le bus de messages entre les chats parallèles :

┌────────────────────────────────────────┐
│  @ai-team-producer — Planifie, fusionne│
│  N'écrit JAMAIS de code                │
└────────────────┬───────────────────────┘
                 │ L'humain achemine les messages
      ┌──────────┼──────────┐
      ▼          ▼          ▼
┌──────────┐ ┌────────┐ ┌────────┐
│@ai-team  │ │@ai-team│ │DevOps  │
│-dev      │ │-qa     │ │(à la   │
│          │ │        │ │demande)│
│ Nova     │ │ Ivy    │ │        │
│ Sage     │ │        │ │        │
│ Milo     │ │        │ │        │
│          │ │feature/│ │feature/│
│ feature/ │ │qa-N    │ │devops-N│
│ sprint-N │ └────────┘ └────────┘
└──────────┘

Chaque équipe travaille dans une fenêtre VS Code séparée avec son propre clone :

git clone <repo> project-dev    # Équipe dev
git clone <repo> project-qa     # QA
git clone <repo> project-devops # DevOps (seulement si nécessaire)

Bootstrap du projet

1. Créer PROJECT_BRIEF.md

La source unique de vérité entre tous les chats. Voir le modèle de brief projet.

Sections obligatoires (ne pas abréger) :

Project Overview
Concept / Product Description
Tech Stack
Architecture (diagramme ASCII)
Key Files Map
Team Roles
Sprint Status (mis à jour à chaque sprint)
Current State (réécrit à chaque sprint)
Security Rules
How to Run Locally
How to Deploy
Cross-Chat Handoff Protocol — comment le contexte survit entre les chats
Bug & Fix Tracking — GitHub Issues comme source unique de vérité
Multi-Repo Setup — clones séparés, stratégie de branche, règles de fusion

2. Lancer un brainstorm

Voir le format de brainstorm. Clé : nommer explicitement chaque agent avec une personnalité et perspective distinctes. Exiger au moins 2 vrais désaccords pour éviter la pensée de groupe.

3. Créer les plans de sprint

Voir le modèle de plan de sprint. Chaque sprint reçoit :

docs/sprint-N/plan.md — tâches priorisées, critères de succès
docs/sprint-N/progress.md — suivi en direct, permet la récupération
docs/sprint-N/done.md — doc de passation rédigée en fin de sprint

4. Exécuter les sprints

Lire PROJECT_BRIEF.md, puis lire docs/sprint-N/plan.md. Exécuter Sprint N.

D'abord : git pull origin main && git checkout -b feature/sprint-N

Fermer les GitHub Issues dans les commits : "fix: description (Fixes #NN)"
Mettre à jour docs/sprint-N/progress.md après chaque phase.
Une fois terminé, pusher et créer une PR : git push origin feature/sprint-N
Suivre les sections 12-14 de PROJECT_BRIEF.md.

5. Sign-off QA

Après fusion dev, QA effectue un parcours complet :

Lire PROJECT_BRIEF.md. Vous êtes Ivy (QA).
Sprint N est fusionné dans main. Faire un parcours complet.
Signaler les bugs comme GitHub Issues. Écrire docs/qa/sprint-N-signoff.md.

Récupération de contexte

Quand un chat devient long (>100 messages), sauvegarder l'état et recommencer à zéro :

Avant fermeture :

Mettre à jour docs/sprint-N/progress.md avec le statut actuel
Mettre à jour les sections 7+8 de PROJECT_BRIEF.md
Rédiger docs/sprint-N/done.md

Prompt de cold start :

Lire PROJECT_BRIEF.md et docs/sprint-N/progress.md.
Continuer à partir d'où on s'était arrêté.

Anti-patterns

Voir la référence anti-patterns pour la liste complète. Top 5 :

À éviter	Faire plutôt
Rebase de branches feature	Fusion (rebase perd les commits)
Producer écrit du code	Producer ne fait que planifier, fusionner, créer des issues
Commits "fix everything" en lot	Un commit par fix avec référence issue
Prompts brainstorm vagues	Nommer chaque agent avec perspective distincte
Garder les bugs seulement dans le chat	Créer des GitHub Issues (le contexte chat meurt)

Conseils pour de meilleurs résultats

"Prenez votre temps, faites-le bien" dans les prompts produit une meilleure sortie que de se presser
Tester avant fusion — vous testez, créez des issues, dev corrige, puis fusion
Lancer des consiliums d'équipe avant les grands sprints — chaque agent revoit le plan de sa perspective
Sauvegarder les leçons en mémoire après chaque jalons

ai-team-orchestration