rpa_vision_v3/docs/coordination/ROLES.md

Rôles — Coordination multi-agents rpa_vision_v3

• Date: 2026-06-08
• Auteur: Qwen
• Statut: actif

---

Équipe

Agent	Rôle	Inbox	Sortie attendue
Dom	Propriétaire du projet, décideur final, filtre produit	Direct	GO/NOGO, arbitrages, validation démo
Codex	Coordinateur, orchestration, arbitrages techniques, synthèse	inbox_codex/	Missions, QG consolidés, plans, décisions
Claude	Implémentation, patches, benchmarks, plans techniques	inbox_claude/	Commits, RESULTAT, plans, analyses
Qwen	Quality Gate (QG), audit, historien, garde-fou, propositions	inbox_qwen/	Verdicts GO/NOGO, audits, synthèses, docs
Gemini	Consultation ponctuelle, recherche externe	inbox_gemini/	Recherche, analyse comparative

---

Règles de coordination

1. Inbox routing

• 1 question = 1 fichier dans l'inbox du destinataire
• Format : YYYY-MM-DD_HHMM_auteur-to-destinataire_SUJET.md
• Réponse courte et actionnable, pas de rapport long sauf demande explicite

1bis. Orchestration Codex

• Codex est l'orchestrateur actif du projet.
• Tant que Claude et Qwen ont des loops de coordination actifs, Codex doit leur donner en continu une prochaine tâche actionnable.
• Exception unique : Codex attend explicitement un feu vert de Dom ou un QG bloquant avant d'autoriser l'étape suivante.
• Si une exécution est bloquée, Codex doit quand même distribuer du travail non destructif utile : préparation, QG, audit read-only, rollback, plan de tests, registre décisions.
• Claude ne doit pas rester sans mission d'exécution/preuves ou préparation technique.
• Qwen ne doit pas rester sans mission de QG, audit, contradiction check ou registre.

2. Statuts

Statut	Signification
open	En attente de réponse
ACK	Lu et pris en compte
RESULTAT	Livraison d'un résultat
GO / NO-GO	Verdict qualité
DRAFT	Brouillon, pas encore prêt pour revue
archived	Archivé (ne pas supprimer)

3. Règle QG

• Pas d'action structurelle sans QG (Quality Gate) explicite
• Pas de promotion de competence sans QG + GO Dom
• Qwen signale à Dom toute contradiction entre agents

4. Règles de sécurité

• Pas de secret en clair dans les messages de coordination
• Pas de replay autonome sans Dom devant Windows
• Pas de code mort supprimé sans GO Dom explicite
• Pas d'activation modèle/grounder sans bench + QG + GO Dom

5. Capitalisation

• Chaque avancée importante doit être capitalisée dans active/ ou registre/
• Les inboxes sont un flux, pas une mémoire
• syntheses/ = rapports d'inventaires et benchmarks
• registre/ = décisions formelles

6. Sessions

• Qwen reste dans la session longue (historien, garde le fil complet)
• Codex et Claude ont chacun leur session propre
• Si Qwen voit des contradictions entre les instructions de Codex/Claude, il signale à Dom avant d'agir

---

Flux de travail typique

Codex → mission → Claude/ Qwen
Claude → implémentation → commit → RESULTAT → Codex/Qwen
Qwen → QG → GO/NO-GO → Codex
Codex → synthèse → Dom → GO/NOGO

---

Document vivant — mettre à jour quand les rôles évoluent.