Files
rpa_vision_v3/docs/coordination
Dom 6d34b3cb68
Some checks failed
tests / Lint (ruff + black) (push) Failing after 1m44s
tests / Tests unitaires (sans GPU) (push) Failing after 1m49s
tests / Tests sécurité (critique) (push) Has been skipped
chore(dgx): snapshot consolidation WIP pour transfert poc DGX
Regroupe le WIP non committé requis pour le clone/runtime DGX (Option A) :
- api_stream.py : préflight replay + smoke santé modèles + handler 403 WP-B
- de-hardcode VLM : vlm_config, gpu/*, vram_orchestrator, ollama_manager
- stream_processor, semantic_matcher, agent_chat (app/planner/intent)
- workflows.db (acquis ; le transfert artifacts le mettra à jour + rewrite chemins)
- docs : plans DGX, benchmarks VLM/grounders, recherche SOTA, coordination 8 juin

Snapshot destiné à la branche poc-dgx poussée sur Gitea pour cloner le DGX.
Scan anti-secret : clean. graphify (repo embarqué) exclu.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 16:33:58 +02:00
..

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.