Un guide complet d'Hermes Kanban : le modèle de coordination, le partage de contexte entre agents, et la construction d'une équipe logicielle de 4 agents (PM, backend, frontend, testeur) en environ 20 minutes.
Les agents IA étaient censés fonctionner comme une équipe.
Vous décrivez l'objectif. Ils divisent le travail. Chacun reprend là où le précédent s'est arrêté.
C'est la promesse. Ce qui se passe en réalité est l'inverse. Les agents démarrent sur une ardoise vierge. Un agent ne sait pas ce que les autres ont construit, quels fichiers ont été modifiés, ou à quoi ressemble l'API. Chaque passage de relais est un démarrage à froid, et le travail se dégrade dès qu'il passe d'un agent à l'autre.
Hermes Kanban résout ce problème. Chaque tâche survit aux crashs et aux redémarrages. Chaque briefing contient exactement ce dont l'agent suivant a besoin. Chaque échec est sauvegardé, donc la nouvelle tentative sait ce qui a cassé.
Voici à quoi ressemble votre centre de contrôle :
Tableau Kanban
Le meilleur, c'est que toute l'équipe fonctionne depuis votre téléphone. Vous créez et gérez les tâches via Telegram, et les agents les prennent en charge pendant que vous êtes loin de votre bureau.
Regardez ça :
Dans cet article, nous construisons cette configuration complète de zéro : le modèle de coordination, les briefings, et une équipe logicielle de 4 membres fonctionnant sur votre propre matériel en environ 20 minutes.
Pour le démontrer, j'ai créé un clone fonctionnel de Google Docs, avec fonctionnalités IA incluses, un backend prêt pour la production, construit par cette équipe d'agents.
Démo du clone Google Docs
Alors, sans plus attendre, commençons.
Pourquoi un seul agent ne suffit pas
Disons, par exemple, que vous souhaitez ajouter une fonctionnalité de réinitialisation de mot de passe. Le travail se répartit sur trois domaines :
- Un développeur backend qui construit l'API REST
- Un développeur frontend qui lit cette API et construit l'interface utilisateur par-dessus
- Un testeur qui vérifie l'ensemble de bout en bout
1 vs 3 Agents
Vous pouvez exécuter les trois via un seul agent, mais la fenêtre de contexte se remplit et l'agent perd la trace de ce qu'il a fait il y a trois étapes. Vous passez plus de temps à le gérer qu'il ne vous en fait gagner.
Diviser le travail entre des agents qui possèdent chacun un domaine crée un problème différent : comment le développeur frontend sait-il ce que le développeur backend a construit ? Ce problème de contexte partagé est ce que Hermes Kanban résout.
Le modèle mental : un tableau de tâches, mais avec des agents derrière les colonnes
Une tâche a un titre, une description, un responsable et un statut. Quelqu'un la prend, la déplace sur le tableau et la ferme. Le tableau est la source unique de vérité.
Hermes Kanban conserve ce modèle et place des agents derrière chaque colonne au lieu d'humains.
Tableau Hermes Kanban
Chaque tâche est une ligne qui survit aux crashs et aux redémarrages. Lorsqu'un agent termine, il écrit un résumé : fichiers modifiés, ce qu'il a construit, ce que l'agent suivant doit savoir. L'agent suivant lit ce résumé avant de commencer.
Ce résumé est la clé de voûte. C'est ce qui transforme un groupe d'agents en une équipe plutôt qu'en étrangers.
Le vocabulaire
Nous avons 6 colonnes différentes sur le tableau Kanban :
- Tri : Les idées brutes atterrissent ici, idéal pour "Je veux une limitation de débit pour l'auth" avant d'avoir un cahier des charges complet.
- À faire : Tâche créée mais en attente d'une dépendance. Elle ne bougera pas tant que sa tâche parente n'est pas terminée.
- Prêt : Dépendances satisfaites, en attente qu'un agent la prenne en charge.
- En cours : Un agent est activement en train de l'exécuter.
- Bloqué : L'agent a rencontré un obstacle et l'a signalé à un humain. Rien ne s'exécute tant que vous ne le débloquez pas.
- Terminé : Fini, avec l'historique complet d'exécution, le résumé et les métadonnées conservés.
L'orchestrateur : un agent qui gère les autres
Considérez l'agent orchestrateur comme le chef de projet qui lit un objectif de haut niveau, vérifie quels agents existent, décompose l'objectif en tâches liées, puis recule. Il n'écrit jamais de code ni n'exécute de tests. Il coordonne.
L'agent orchestrateur
La seule règle qui compte : vérifier quels profils existent avant de créer des tâches. Le système ignore silencieusement toute tâche dont le responsable ne correspond pas à un profil réel, donc l'étape zéro est toujours kanban_list.
Voici un tour typique du chef de projet, décomposant une demande "construire un flux de réinitialisation de mot de passe" en un pipeline lié :
1kanban_show()23be = kanban_create(title="Backend réinitialisation mot de passe", assignee="backend-developer",4 body="Flux mot de passe oublié/réinitialisation + invalidation de session")56fe = kanban_create(title="UI réinitialisation mot de passe", assignee="frontend-developer",7 parents=[be], body="Flux de réinitialisation Next.js utilisant l'API backend")89qa = kanban_create(title="Test E2E réinitialisation mot de passe", assignee="tester",10 parents=[fe], body="Valider tous les critères d'acceptation")1112kanban_complete(summary="Pipeline de dépendances créé : backend → frontend → QA")
Après cela, le tableau gère la promotion et les briefings gèrent le contexte. Lorsque les trois sont terminés, le chef de projet se réveille, lit les résumés et juge si le travail est fait. Si le testeur renvoie "verdict": "FAIL", il crée des tâches de correction et la boucle continue.
Mais en réalité, vous n'avez pas à vous soucier de quoi que ce soit. Vous devez simplement déléguer une tâche depuis Telegram et l'orchestrateur prend le relais.
Trois modèles que vous utiliserez constamment
1. Le pipeline : Chaque tâche dépend de la précédente. Seule la première commence en état "Prêt". Toutes les autres attendent leur tour.
1BACKEND=$(hermes kanban create "Implémenter l'API d'authentification" \2 --assignee backend-developer \3 --body "POST /register, POST /login, POST /refresh, POST /logout." \4 --json | jq -r .id)56FRONTEND=$(hermes kanban create "Construire l'UI d'authentification" \7 --assignee frontend-developer \8 --parent $BACKEND \9 --body "Lire le compte-rendu backend pour la forme de l'API. Pages de connexion, inscription, profil." \10 --json | jq -r .id)1112hermes kanban create "Tester le flux d'authentification de bout en bout" \13 --assignee tester \14 --parent $FRONTEND \15 --body "Couvrir le scénario nominal, mauvais mot de passe, token expiré, persistance de session."
Vous n'exécutez pas cela manuellement. Vous décrivez le projet au chef de projet sur Telegram et il crée ces tâches pour vous. En coulisses, cela ressemble à ce qui précède.
Lorsque l'agent backend appelle kanban_complete(), la tâche frontend passe en "Prêt" avec le travail du backend attaché.
2. Intervention humaine : Tous les blocages ne sont pas des échecs. Parfois, un agent trouve un vrai problème et s'arrête pour demander.
1kanban_block(reason="review-required: vérification de la force du mot de passe manquante, "2 "les tokens de réinitialisation ne sont pas à usage unique (peuvent être rejoués dans les 30 min)")
Vous voyez le blocage sur le tableau. Vous vérifiez le problème, le corrigez et débloquez la tâche :
1hermes kanban unblock $IMPL
Vous n'exécutez pas non plus cela dans le terminal, il suffit de commenter dans le tableau Kanban ou d'envoyer un message sur Telegram, et le système le débloque.
Le système redémarre l'agent au cycle suivant. La deuxième exécution appelle kanban_show() et voit exactement pourquoi la première tentative a été bloquée. Il sait précisément quoi corriger ; il ne repart pas de zéro.
3. Spécificateur de tri.
Lorsque vous avez une idée vague plutôt qu'un cahier des charges complet, déposez-la sur le tableau et laissez le système l'étoffer avant qu'un agent ne la prenne en charge.
1# Déposer une idée vague2hermes kanban create "l'auth a besoin de limitation de débit" --triage --assignee backend-developer34# L'étoffer avant que le répartiteur ne la prenne en charge5hermes kanban specify $TASK_ID
La commande specify réécrit le titre de trois mots en une tâche complète avec un objectif, une approche et des critères d'acceptation. L'agent qui la prend en charge reçoit un véritable briefing.
Configuration : quatre profils en environ 20 minutes
Quatre agents, un tableau partagé, le chef de projet joignable sur Telegram.
Étape 1 : Créer les profils.
1hermes profile create project-manager --clone2hermes profile create backend-developer --clone3hermes profile create frontend-developer --clone4hermes profile create tester --clone
--clone copie la configuration de votre profil par défaut comme point de départ.
Étape 2 : Donner une personnalité à chaque agent
1. Chef de projet dans ~/.hermes/profiles/project-manager/SOUL.md :
1# Âme23Vous êtes le chef de projet d'une équipe de développement logiciel. Votre travail4consiste à prendre l'idée d'application d'un utilisateur, à la décomposer en tâches claires,5à les attribuer aux bons membres de l'équipe et à suivre la progression sur le tableau Kanban.6Vous n'écrivez pas de code vous-même. Vous gérez le travail.
2. Développeur Backend dans ~/.hermes/profiles/backend-developer/SOUL.md :
1# Âme23Vous êtes le développeur backend d'une équipe logicielle. Vous construisez et gérez4l'ensemble du backend en utilisant InsForge — base de données, authentification, stockage,5fonctions edge et déploiement.
3. Développeur Frontend dans ~/.hermes/profiles/frontend-developer/SOUL.md :
1# Âme23Vous êtes le développeur frontend d'une équipe logicielle. Vous construisez l'interface utilisateur —4composants, pages et flux utilisateur — et les connectez au backend5en utilisant les API et méthodes SDK que le développeur backend a mises en place.
4. Testeur dans ~/.hermes/profiles/tester/SOUL.md :
1# Âme23Vous êtes le testeur d'une équipe logicielle. Vous testez les fonctionnalités terminées4de bout en bout, vérifiez que les critères d'acceptation sont remplis et signalez les bugs5clairement sur le tableau Kanban afin qu'ils puissent être corrigés.
Étape 3 : Ajouter des compétences aux agents
Les compétences sont des guides étape par étape, des instructions spécifiques sur la façon d'effectuer certains types de travail. Considérez-les comme une formation professionnelle pour vos agents. Listons-les une par une :
InsForge (open-source, Apache 2.0) sert de couche d'ingénierie de contexte backend pour les agents utilisant les Compétences et la CLI. Le profil de notre agent développeur backend utilise cette compétence pour disposer d'un service backend prêt à l'emploi pour les projets.
Tout d'abord, ajoutez le dépôt de compétences InsForge :
1hermes skills tap add InsForge/insforge-skills
Ensuite, installez les compétences backend :
1hermes -p backend-developer skills install InsForge/insforge-skills/insforge --force
De la même manière, nous installons d'autres compétences comme insforge-cli (commandes d'infrastructure), insforge-debug (diagnostics de panne) et insforge-integrations (fournisseurs d'authentification tiers).
Voici comment l'agent développeur backend utilise la compétence pour construire le backend de notre projet sur InsForge.
D'abord, l'agent développeur backend crée un projet appelé "Google Docs Clone" dans InsForge.
Le tableau de bord affiche les statistiques du projet comme le nombre d'utilisateurs, de tables dans la base de données, de stockage et la liste des fonctions Edge avec le code JavaScript/TypeScript déployé lié à l'authentification, la gestion des documents, etc.
Donc, si vous construisez un ingénieur backend IA, allez voir InsForge →
(n'oubliez pas de mettre une étoile 🌟)
Plus de compétences depuis le Hub de Compétences
Hermes maintient également un Hub de Compétences avec 687 compétences réparties dans 18 catégories : 87 intégrées, 79 optionnelles, 16 d'Anthropic (frontend-design, pdf, pptx, docx, mcp-builder, etc.), et 505 de LobeHub.
Pour le développeur frontend, installez frontend-design. Pour le testeur, installez webapp-testing. Les deux sont disponibles dans le Hub.
Étape 4 : Initialiser le tableau et démarrer la passerelle.
hermes kanban init crée ~/.hermes/kanban.db, la base de données SQLite contenant chaque tâche, contexte et historique d'exécution.
Ensuite, configurez la passerelle de chat sous le profil du chef de projet. Obtenez un token de bot auprès de @BotFather sur Telegram et votre ID utilisateur auprès de @userinfobot, puis :
1hermes kanban init2hermes -p project-manager gateway setup3hermes -p project-manager gateway start
La connexion fonctionne 24h/24 et 7j/7, maintient le système actif et rend le chef de projet joignable sur Telegram.
Étape 5 : Envoyer votre premier projet.
Envoyez un message au chef de projet avec ce que vous voulez construire. Il décompose l'objectif en tâches, les crée avec des liens de dépendance, et le système les exécute dans l'ordre.
Le tableau de bord
Exécutez hermes dashboard et ouvrez http://127.0.0.1:9119. Vous obtenez une colonne par statut et des mises à jour en direct via WebSocket sans besoin d'actualisation.
0:20
Tableau de bord Hermes Kanban
Deux contrôles méritent d'être connus. Lanes by profile sous-groupe la colonne "En cours" par responsable, vous permettant de voir quel agent possède quoi en un coup d'œil. Nudge dispatcher exécute un passage immédiatement au lieu d'attendre 60 secondes, ce qui est utile juste après avoir débloqué une tâche.
Cliquez sur n'importe quelle carte pour ouvrir son tiroir et voir l'historique complet d'exécution, le résultat et les métadonnées de chaque tentative, ainsi que des champs modifiables pour le titre, le responsable, la priorité et les dépendances.
Ce à quoi il faut faire attention
Trois modes de défaillance à connaître avant une charge de travail sérieuse.
1. Surcharge de la base de données. Avec 2 à 4 agents en parallèle, vous n'atteindrez jamais ce problème. Avec 10 agents ou plus écrivant à haute fréquence, les choses ralentissent. Limitez-le avec hermes kanban dispatch --max 4.
2. Suppression de l'espace de travail temporaire. Les fichiers sauvegardés dans un espace de travail temporaire disparaissent dès que la tâche est marquée comme terminée, car l'espace temporaire est effacé par conception. Utilisez worktree pour les tâches de codage, ou mettez le chemin du dossier du projet dans la description de la tâche afin que l'agent sache où sauvegarder.
3. Saturation du modèle local. Avec un modèle local (Ollama, GPU local), le système peut lancer plusieurs agents à la fois et submerger le GPU, ce qui ralentit la génération et déclenche l'arrêt automatique. Pour les configurations locales, utilisez hermes kanban dispatch --max 2. Pour les modèles basés sur API comme Claude ou GPT-4o, c'est rarement un problème.
L'image complète
Chaque pièce a un travail :
- SOUL.md est l'identité fixe de l'agent : qui il est et comment il pense.
- Compétences sont les instructions étape par étape pour des types de travail spécifiques.
- Mémoire est ce que l'agent sait de votre environnement à travers les sessions.
- Kanban est la couche de coordination : état partagé, transfert de contexte, et une intervention humaine à tout moment.
Quatre profils, quatre fichiers SOUL.md, un démarrage de passerelle. Décrivez ce que vous voulez construire au chef de projet sur Telegram et regardez le tableau se remplir.
Si vous apprenez mieux par la vidéo, un guide complet d'Hermes Kanban sera publié sur YouTube et X dans quelques jours.
Merci d'avoir lu.
