chore(coordination+docs): watcher mandat AGENTS.md, recadrage POC CLAUDE.md, dette enrichie, loop script robustifié

docs/coordination/README.md

@@ -61,6 +61,46 @@ résultats de tests.
 
 Même règle en sens inverse si Claude initie la demande.
 
+## Surveillance automatique
+
+`coordination_loop.sh` surveille les inbox et cree un declencheur persistant a
+chaque nouveau message detecte.
+
+Cette surveillance est obligatoire au debut de chaque session pour Codex,
+Claude et Qwen. Aucun handoff ne doit omettre ce pre-check.
+
+Pre-check debut de session :
+
+1. `docs/coordination/coordination_loop.sh ensure`
+2. Lire les messages pertinents pour l'agent courant.
+3. Apres traitement : `docs/coordination/coordination_loop.sh ack`
+
+Si le watcher ne peut pas etre lance ou verifie, c'est un blocage de reprise a
+signaler explicitement.
+
+Commandes utiles :
+
+- `docs/coordination/coordination_loop.sh ensure` : lance si besoin, scanne, affiche pending.
+- `docs/coordination/coordination_loop.sh start 15` : demarre la surveillance.
+- `docs/coordination/coordination_loop.sh service-install` : installe/met a jour et redemarre le watcher systemd utilisateur persistant.
+- `docs/coordination/coordination_loop.sh service-stop` : arrete et desactive le watcher systemd utilisateur.
+- `docs/coordination/coordination_loop.sh status` : etat, compteurs et file unread.
+- `docs/coordination/coordination_loop.sh pending` : messages detectes non ACK localement.
+- `docs/coordination/coordination_loop.sh ack` : vide la file unread locale.
+- `docs/coordination/coordination_loop.sh events` : derniers evenements detectes.
+
+Artefacts crees :
+
+- `.loop_state/unread_messages.tsv` : file des messages a traiter.
+- `.loop_state/unread_digest.md` : digest lisible au debut de session.
+- `.loop_state/latest_message.trigger` : dernier declencheur.
+- `.loop_state/message_events.tsv` : journal evenements machine-readable.
+- `.loop_state/triggers/*.trigger` : un fichier declencheur par message.
+
+Un hook externe peut etre branche avec `COORD_LOOP_TRIGGER_CMD`. Le hook recoit
+`COORD_MESSAGE_DIR`, `COORD_MESSAGE_FILE`, `COORD_MESSAGE_PATH`,
+`COORD_MESSAGE_STATUS` et `COORD_TRIGGER_FILE`.
+
 ## Règle de capitalisation
 
 Un message de coordination est un flux. Une synthèse ou un registre est une