Le serveur de coordination relie les sessions Claude de l'équipe et leurs membres : qui travaille sur quelle
carte, questions à trancher, alertes, fusions et recettes. Cet écran en montre l'état, sur le poste et sur le téléphone.
1. Installer son poste (une fois)
Nico envoie à chacun son jeton par un canal privé : c'est l'identité du membre, valable pour tous ses comptes Claude.
Vérifie le jeton et le range dans ~/.config/coordination/jeton, installe le plugin
« coordination » dans Claude Code (outils, hooks et skill), le script de réveil dans ~/.local/bin et
branche Claude Desktop. Rejouable sans risque. Le plugin se met ensuite à jour seul.
- Vérifier : relancer Claude Code, puis
/mcp → coordination « connected ».
Le jeton est relu dans son fichier à chaque connexion : plus besoin de relancer IntelliJ après l'installation.
- Autres outils (JetBrains AI Assistant…) : URL
Authorization: Bearer <jeton>.
2. Paramétrer son poste et ses sessions (bonnes pratiques)
3. Projets
Le serveur suit plusieurs projets (ASRIA CRM, Coordination…) : chacun a ses dépôts, son projet Plane, son préfixe de
carte, sa branche et sa file de fusion. Le sélecteur en haut de l'écran choisit le projet affiché, ou tous. Une session
sert le projet du dossier où elle est ouverte (.coordination.json).
4. Au quotidien, dans sa session
- Démarrer : ouvrir Claude Code dans le dossier du projet ; la session est déclarée seule et reçoit
sa note de relève, ses messages et l'état des cartes.
- Prendre une carte : libre seulement (
qui_fait_quoi), puis prendre_carte ;
dans Plane, la carte passe en cours et vous est assignée. Le hook la prend aussi au premier fichier modifié dans son
worktree. Une carte terminée dans Plane (Fini, Annulé, Déployé) est libérée seule et n'est plus montrée comme tenue.
- Fusionner : une seule fusion à la fois par projet.
prendre_jeton_fusion avec les MR
(à jour de la branche, sans conflit ni brouillon) ; sinon la session est mise en file et réveillée à son tour. Après la
fusion, rendre_jeton_fusion : tout le monde est prévenu que la branche a bougé et les cartes passent en
Recette auto (Déployé pour Coordination). Un NO GO (signaler_no_go) suspend les fusions du seul projet.
- Relève :
noter_releve à chaque étape ; elle est rendue à la session rouverte.
- Finir : la fin de session libère ses cartes.
5. Questions et validations
- Avant de demander :
chercher_decisions. Sinon poser_question (Q-n) puis
publier_page : gabarit « question » (options, recommandation, impacts) ou « validation » (un bloc par écran
de maquette).
- Dans l'onglet Questions (« Pour moi » par défaut), on choisit une option, ou « Autre » avec un
commentaire obligatoire quand aucune ne convient ; pour une validation, un verdict par écran. La session est prévenue
aussitôt et la décision est inscrite au registre.
6. Alertes
- Une session prévient quand elle est bloquée ou en difficulté (
alerter), et le serveur quand une session
se tait en tenant une carte ou qu'un fichier partagé est en conflit entre deux MR. Bloquée et problème arrivent en
notification sur le téléphone.
- Répondre : la réponse part en message à la session, qui est réveillée.
- Résolue : une alerte traitée est close, par le bouton « Résolue », par la session
(
resoudre_alerte), ou seule quand sa cause a disparu (MR fusionnée ou fermée, session reprise ou fermée).
Elle quitte la pastille et reste lisible dans l'onglet « Résolues », avec le motif et l'heure.
7. Recettes
- Plan de recette : un périmètre (epics entières ou cartes choisies dans les listes), des scénarios,
des liens et des fichiers. Le périmètre peut rester à définir par la session à qui le plan est attribué.
- Jouer : une session réserve des scénarios ; en session, glisser vers la gauche passe au scénario
suivant.
- Verdict : humain par défaut (à l'écran), ou par l'IA si le plan le permet (
donner_verdict).
Il est écrit dans Plane (commentaire signé ; non conforme : la carte repart, En cours par défaut). Avec « Fini auto »
sur un scénario, la carte passe à Fini quand tous ses scénarios sont conformes.
- Clore le plan (écran ou
clore_plan_recette) : il passe en Terminé avec un récapitulatif.
Les écarts (non conforme non reparti, carte sans trace…) ont leur page et une ligne au point du matin.
8. Cet écran
- Navigation : Accueil, Questions, Alertes, Recettes et Plus (Cartes et MR, Équipe, Décisions,
Écarts, Rapport, réglages et ce mode d'emploi). Sur l'ordinateur, le menu de gauche ; sur le téléphone, la barre du bas.
- Accueil : « À faire maintenant » (ce qui vous attend), les chiffres du jour, le jeton de fusion de
chaque projet, les nouveautés depuis votre dernier passage.
- Équipe : par membre, ses sessions, ses cartes tenues et ses cartes Plane en cours.
- Cartes et MR : cartes Plane par état, MR et leurs conflits. Écran rafraîchi toutes les 4 s, Plane
toutes les 60 s, GitLab toutes les 30 s ; il se recharge seul à chaque nouvelle version.
- Skills : pastille verte = la session lit la version de référence ; rouge = en retard (mettre à jour
le clone principal puis relancer la session).
9. Session de coordination
Elle ne code pas : MR, file de fusion, questions, messages, répartition des cartes. Elle veille sans tâche planifiée :
scripts-session/veille-ronde.sh et attendre-coordination.sh tournent en arrière-plan et la
réveillent quand quelque chose change ; elle traite, puis relance le script terminé.
10. Reprise des sessions dans IntelliJ (facultatif)
- Les sessions ouvertes à la fermeture d'IntelliJ se rouvrent à l'ouverture du projet, la coordination en premier.
Installer :
puis Settings › Tools › Startup Tasks › + › « Reprendre les sessions ».
- Le relevé
reprise-des-sessions.json garde les rôles ; une copie est sur le serveur
(python3 ~/.local/bin/reprise-sessions.py restaurer). Changer un rôle : definir_role.
Les commandes en cours à la fermeture ne reprennent pas seules.
11. Sur le téléphone
- Installer : menu « Ouvrir sur le téléphone », ouvrir le lien (il contient votre jeton : canal privé
seulement), puis l'ajouter à l'écran d'accueil (iPhone : Safari › Partager ; Android : Chrome › Installer). Depuis
l'icône, « Notifications sur cet appareil ».
- Visage ou empreinte : une clé d'accès enregistrée permet de se reconnecter sans lien.
- Limite : une autorisation demandée dans le terminal se donne au poste, pas depuis l'application.