docs: track design docs, plans, audits, coordination infrastructure, handoffs
- 21 docs/*.md: audits, design notes, deployment plans, checklists, memos - Coordination: ROLES, runbooks (DGX reboot, Lea live), patches, registre, syntheses, systemd, QG template - Handoffs: 6 Codex handoff documents + README + template
This commit is contained in:
81
docs/coordination/ROLES.md
Normal file
81
docs/coordination/ROLES.md
Normal file
@@ -0,0 +1,81 @@
|
||||
# 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.*
|
||||
Reference in New Issue
Block a user