Kanban hybride humain et multi-agents : coordonner Claude, Claude Code et un humain dans un graphe de connaissances
Share
Des baristas avisés chez Good Brew
Je gère un graphe de connaissances personnel de plus de 9 000 pensées reliées, construit en une décennie dans TheBrain. Quand j'ai commencé à construire des serveurs MCP pour donner à Claude un accès programmatique à mes outils et services, je savais qu'une solution de coordination serait nécessaire. Plusieurs agents IA, chacun sans mémoire, travaillant aux côtés d'un humain pendant des jours et des semaines sur des projets suivis : cela exige un état partagé modifiable, des conventions claires et une ergonomie visuelle. Des fichiers README et l'historique des conversations n'allaient jamais suffire.
Alors Claude, Claude Code et moi avons construit un protocole de coordination des tâches à l'intérieur même du graphe de connaissances. Voici l'architecture, sa justification, et assez de détails pour construire le vôtre.
Le problème de la coordination
Si vous faites un vrai travail de projet avec des agents IA (pas des questions ponctuelles, mais un développement sur plusieurs sessions, de la conception à la mise en œuvre et au déploiement), vous devez résoudre ceci : chaque nouvelle session d'agent démarre sans aucune mémoire. Claude Code ne sait pas ce que claude.ai a décidé ce matin. La session de demain ne se souviendra pas de celle d'aujourd'hui. Et l'humain a ses propres tâches (configuration d'identifiants, déploiements, fusions de PR) que les agents ne peuvent pas exécuter mais doivent suivre.
Trois exigences en découlent directement :
1. Un état partagé que n'importe quel agent peut lire et écrire, sur n'importe quel appareil, sans contexte préalable.
2. Des conventions structurelles qui permettent à un agent de s'orienter en quelques secondes, pas en minutes d'analyse de texte.
3. Une ergonomie visuelle, pour que l'humain voie d'un coup d'œil ce qui est en cours, ce qui est fait et ce qui demande son attention.
Ces trois exigences doivent être servies par le même artefact. Des systèmes séparés finissent par diverger. Seul un graphe unique, qui sert agents et humains à égalité, tient la route.
TheBrain comme support
TheBrain est un outil de gestion des connaissances bâti autour d'un graphe infini et zoomable. Les nœuds (pensées) ont des parents, des enfants, des liens transversaux (« jumps »), des notes, des pièces jointes, des Types aux couleurs et icônes héritées, des balises et des étiquettes. Il récompense l'investissement à long terme : mon graphe reflète une décennie de structure et de relations accumulées.
Le fondement architectural : exposer toute l'API de graphe de TheBrain par un serveur Model Context Protocol. J'ai construit thebrain-mcp, un serveur Python FastMCP qui encapsule l'API de TheBrain et ajoute BrainQuery, un langage de requête proche de Cypher pour la recherche de motifs dans le graphe. Déployé sur FastMCP Cloud, il est accessible depuis n'importe quel client Claude : web, bureau, mobile et ligne de commande. Toute session d'agent, où qu'elle soit, lit et écrit dans le même graphe.
Voilà pour l'état partagé modifiable. Viennent ensuite les conventions.
Le protocole
Chaque projet de ma collection « Claude Thoughts » suit le Project Task Management Protocol, un document vivant stocké dans le graphe lui-même, que chaque agent lit au démarrage de sa session.
Hiérarchie structurelle
Projet (ex. « thebrain-mcp »)
└── TASKS
├── Proposed ← en file pour plus tard
├── In-Progress ← en cours
├── Parked ← reporté ou remplacé
├── Done ← terminé
└── Lessons Learned ← référence transversale
Le statut est structurel, non textuel. Le statut d'une tâche est déterminé par la colonne Kanban sous laquelle elle est rattachée. Déplacer une tâche, c'est la rattacher à un autre parent dans le graphe, pas modifier un champ de statut dans une note. Les agents analysent la structure d'un graphe plus sûrement que du texte libre : nous encodons donc le statut là où l'analyse réussit à coup sûr.
Un agent qui arrive sans contexte va à TASKS, voit quatre colonnes, consulte In-Progress (reprendre un travail en cours ?), puis Proposed (prendre la suite ?). Deux sauts dans le graphe pour une orientation complète.
Les pensées de tâche
Chaque tâche est une pensée à part entière, avec une note riche : objectif, spécification, critères d'acceptation, cas de test et notes de fin. Le détail vit au niveau de la tâche, pas sur le tableau. Le tableau reste léger (un index structurel, pas un déversoir de spécifications), sous 3 Ko, pour que les agents le chargent en un seul appel d'outil et gardent de la fenêtre de contexte pour le vrai travail.
Signaler une tâche bloquée
Quand une tâche a besoin d'une action humaine (fusionner une PR, configurer un service, approuver des identifiants), l'agent lui ajoute la balise @todo, une balise partagée visible dans le filtre de balises de l'interface de TheBrain. La balise se superpose à la position dans la colonne : la tâche reste dans In-Progress avec un signal @todo en plus. Quand l'humain lève le blocage, il retire la balise et laisse une note. La session d'agent suivante voit la tâche débloquée et reprend là où la précédente s'était arrêtée.
Définition de « terminé »
Une tâche de code n'est pas terminée tant que la PR n'est pas fusionnée et déployée. Le protocole associe chaque étape du pipeline à une colonne et à une étiquette. Une tâche fusionnée mais non déployée reste dans In-Progress avec l'étiquette « Merged (pending deploy) ». Les agents ne doivent jamais marquer une tâche terminée trop tôt : les sessions suivantes supposeraient que le travail est en production alors qu'il ne l'est pas.
Le système de Types : des repères visuels pour les humains
Le système de Types de TheBrain propage des propriétés visuelles (couleurs et icônes) à toutes les pensées typées. Nous utilisons quatre Types de statut, enfants d'un Type parent 🤖 Agent Task :
| Type | Couleur | Signification |
|---|---|---|
| Done Task | Vert | Terminée de bout en bout |
| In-Progress Task | Ambre | En cours |
| Proposed Task | Bleu | En file pour plus tard |
| Parked Task | Gris | Reportée ou remplacée |
La hiérarchie des Types :
Task
├── 👤 Human Task
└── 🤖 Agent Task
├── Done Task (vert)
├── In-Progress Task (ambre)
├── Proposed Task (bleu)
└── Parked Task (gris)
Attribuer un Type de statut à une tâche lui donne la bonne couleur partout dans le graphe. Les icônes définies sur une pensée de Type dans l'application de bureau se propagent à toutes les tâches de ce Type. On le règle une fois, on le voit partout.
Quand un agent déplace une tâche d'une colonne à l'autre, il effectue trois opérations : changer le parent de la pensée, changer son Type et mettre à jour l'étiquette. C'est le triple signal : structure, couleur et texte communiquent tous le même statut. L'humain qui jette un œil au graphe voit la couleur. L'agent qui parcourt le graphe lit la structure. L'agent qui analyse les métadonnées lit l'étiquette. Trois canaux redondants : un échec partiel (un agent oublie de mettre à jour l'étiquette) laisse encore deux signaux justes.
Une contrainte à anticiper : TheBrain n'autorise qu'un seul Type par pensée. Utiliser l'emplacement du Type pour le statut exclut un typage sémantique comme « Infrastructure Task ». C'est le bon compromis : les tâches sont déjà catégorisées par leur projet parent et par leur nom. Si une catégorisation secondaire devient nécessaire, des liens transversaux vers des pensées de Type la fournissent sans consommer l'emplacement du Type.
Le travail multi-agents en pratique
Une journée type sur mes trois projets actifs :
Le matin, claude.ai. Session de conception. Claude et moi évaluons des options d'architecture, étudions des outils tiers et prenons des décisions stratégiques. Claude écrit les notes de conception directement dans la pensée de la tâche concernée, crée de nouvelles tâches sous Proposed avec le bon Type, et relie par des liens transversaux les tâches liées d'un projet à l'autre.
L'après-midi, Claude Code. Session de mise en œuvre. Claude Code lit le protocole (il est là, dans le graphe), va à In-Progress, charge la spécification de la tâche active, écrit le code, lance les tests, crée une PR. À la fin : rattacher à Done, retyper en Done Task, mettre à jour l'étiquette avec la date et le numéro de PR, écrire les notes de fin dans la pensée de la tâche.
Le soir, l'humain. J'ouvre TheBrain. Un mur de vert dans Done, une tache d'ambre dans In-Progress, une balise @todo sur une tâche qui m'attend. Je m'occupe de l'étape manuelle (approuver un identifiant, fusionner une PR, configurer un service), je retire la balise @todo et je laisse une note. La session d'agent de demain la reprend sans aucun briefing.
Aucun agent ne se souvient de la session précédente. Aucun n'en a besoin. Le graphe est la mémoire. Le protocole est le mécanisme de coordination. Les Types et les couleurs sont le tableau de bord.
Le principe de conformité
Le protocole comprend une vérification de conformité que chaque agent exécute au démarrage : le projet a-t-il ses quatre colonnes Kanban ? Les tâches sont-elles correctement rattachées ? Les Types de statut correspondent-ils à la colonne ? Si quelque chose n'est pas conforme, la restructuration passe avant tout travail sur le projet.
Le principe directeur : la foule nettoie les communs. Chaque session d'agent laisse la structure au moins aussi propre qu'elle l'a trouvée. Les agents ne se contentent pas de consommer une infrastructure que les humains entretiennent : ils l'entretiennent en l'utilisant. Les opérations de restructuration sont les mêmes opérations sur le graphe que celles du travail sur les tâches : créer des pensées, créer des liens, supprimer des liens, changer des Types. Il n'y a pas de « mode administrateur » séparé. Entretenir le système et l'utiliser sont une seule et même activité, et c'est ce qui le rend durable.
Construire le vôtre
Si vous voulez reproduire ce système, voici la prescription.
Rendez le statut structurel, non textuel. Encodez le statut dans la topologie du graphe (quelle colonne est parente de quelle tâche), pas dans des champs texte qu'il faut analyser. Un saut dans un graphe n'échoue jamais. Une expression régulière, si.
Gardez le tableau léger. Le tableau TASKS doit rester sous 3 Ko : juste les colonnes Kanban et leurs enfants. Les spécifications complètes appartiennent aux pensées de tâche, chargées à la demande. Les agents doivent consacrer leur fenêtre de contexte au travail, pas à s'orienter.
Utilisez le triple signal pour le statut. Structure (colonne), couleur (héritage du Type) et texte (étiquette) doivent concorder. Prévoyez le cas où un signal est périmé : les deux autres disent encore la vérité.
Placez le protocole dans le graphe qu'il régit. Pas dans un README. Pas dans un wiki. Dans le même graphe que les agents parcourent pour leurs tâches. Le protocole doit se trouver à un saut de chaque projet, rencontré naturellement lors de l'orientation.
Tirez parti de l'héritage des Types pour la cohérence visuelle. Définissez une fois une icône et une couleur sur une pensée de Type ; chaque tâche de ce Type en hérite dans tous les projets. C'est ce levier qui fait qu'une hiérarchie de Types vaut la contrainte du Type unique.
Exigez une vérification de conformité au démarrage. Chaque agent, chaque session. Si la structure a dérivé, corrigez-la d'abord. Un petit entretien à chaque session évite de grosses restructurations plus tard.
La pile technologique
TheBrain : graphe de connaissances, plus de 9 200 pensées, Types, balises, riches propriétés visuelles
thebrain-mcp : serveur MCP libre (Python/FastMCP), BrainQuery, CRUD complet, parcours paginé, identifiants multi-locataires
FastMCP Cloud : déploiement distant pour l'accès des agents depuis tous les appareils
Claude (claude.ai) : sessions de conception, de recherche et de stratégie
Claude Code : mise en œuvre, tests, flux de PR
BTCPay Server + Lightning : infrastructure de paiement pour la monétisation d'API (le projet qui a mis à l'épreuve tout le pipeline Kanban avec les trois types d'agents)
Le serveur thebrain-mcp est sur GitHub. Le protocole, la hiérarchie de Types et la structure Kanban décrits ici sont reproductibles dans n'importe quelle instance de TheBrain. Le schéma de coordination se généralise à tout graphe partagé que des agents peuvent lire et écrire, mais les propriétés visuelles de TheBrain, l'héritage des Types et un modèle de données qui traverse les décennies le rendent particulièrement adapté.
Construisez la structure une fois. Laissez les agents l'entretenir. Jetez un œil aux couleurs. Livrez le travail.
Me joindre :
🛒 cafe.tollbooth-dpyc.com
🐙 GitHub : lonniev
🐦 Retrouvez-moi sur X ; les « j'aime » sont appréciés
Si cet article vous a été utile, j'accepte les pourboires en bitcoin.






