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:
Dom
2026-07-02 13:29:58 +02:00
parent 7dd5c872df
commit 6907ecc82f
42 changed files with 5267 additions and 0 deletions

View 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.*