docs(coordination): sync agent inboxes and active decisions

docs/coordination/README.md

@@ -0,0 +1,76 @@
+# Coordination multi-agents
+
+But: échanger par fichiers courts, ciblés et auditables entre Codex, Claude,
+Gemini et Dom, tout en capitalisant les décisions, erreurs, corrections et
+résultats de tests.
+
+## Arborescence
+
+- `inbox_codex/`
+  Messages que Codex doit lire et arbitrer.
+- `inbox_claude/`
+  Messages que Claude doit lire.
+- `inbox_gemini/`
+  Messages que Gemini doit lire quand le canal est utilisé.
+- `outbox_gemini/`
+  Messages déposés pour Gemini quand son inbox directe n'est pas le canal actif.
+- `active/`
+  Etat courant, files ouvertes, risques et prochaine action.
+- `syntheses/`
+  Synthèses datées, lisibles par un humain qui reprend le projet.
+- `registre/`
+  Registre des décisions, validations, échecs utiles et reports.
+- `index/`
+  Index manuel ou généré des messages importants.
+- `archive/YYYY-MM-DD/`
+  Messages traités et sortis du flux actif. Ne pas archiver une conversation en
+  cours sans confirmation Codex.
+- `templates/` et `TEMPLATE_MESSAGE.md`
+  Modèles de message.
+
+## Convention
+
+1. Une question = un fichier.
+2. L'émetteur écrit dans l'inbox du destinataire.
+3. Le destinataire répond dans l'inbox de l'émetteur.
+4. Le nom de fichier suit:
+   `YYYY-MM-DD_HHMM_sender-to-recipient_slug.md`
+5. Chaque message contient au minimum:
+   `Contexte`, `Constat`, `Question précise`, `Contraintes`, `Attendu`, `Statut`.
+6. `Statut` usuels:
+   `open`, `ACK`, `NACK`, `patched`, `validated`, `blocked`, `archived`.
+7. Une réponse doit citer le fichier source dans `Répond à`.
+8. Quand la boucle est terminée, déplacer les fichiers dans `archive/YYYY-MM-DD/`.
+   Tant qu'un agent peut encore répondre, laisser le fil dans les inbox.
+
+## Style attendu
+
+- court et factuel
+- références de fichiers/fonctions explicites
+- pas de prose longue
+- pas de code dans les messages de coordination sauf extrait très court si indispensable
+
+## Workflow actif
+
+1. Codex pose une mission dans l'inbox du collègue.
+2. Le collègue répond dans `inbox_codex/` avec `ACK/NACK`.
+3. Codex lit, vérifie, teste, arbitre.
+4. Codex répond dans l'inbox du collègue.
+5. Une synthèse ou une décision durable est recopiée dans `syntheses/` ou
+   `registre/` avant archivage.
+
+Même règle en sens inverse si Claude initie la demande.
+
+## Règle de capitalisation
+
+Un message de coordination est un flux. Une synthèse ou un registre est une
+mémoire.
+
+Chaque avancée importante doit être convertie en au moins un des artefacts :
+
+- décision durable dans `registre/` ;
+- synthèse de reprise dans `syntheses/` ;
+- état courant dans `active/` ;
+- entrée d'index dans `index/`.
+
+Ne pas supprimer les messages bruts : ils servent d'audit trail.