Una guía completa de Hermes Kanban: el modelo de coordinación, el intercambio de contexto entre agentes y la creación de un equipo de software de 4 agentes (PM, backend, frontend, tester) en unos 20 minutos.
Se suponía que los agentes de IA trabajarían como un equipo.
Tú describes el objetivo. Ellos dividen el trabajo. Cada uno retoma donde el anterior lo dejó.
Esa es la promesa. Lo que realmente sucede es lo contrario. Los agentes comienzan con una pizarra en blanco. Un agente no sabe qué construyeron los demás, qué archivos cambiaron o cómo se ve la API. Cada transferencia es un arranque en frío, y el trabajo se degrada en cuanto pasa de un agente a otro.
Hermes Kanban soluciona eso. Cada tarea sobrevive a fallos y reinicios. Cada informe lleva exactamente lo que el siguiente agente necesita. Cada fallo se guarda, para que el reintento sepa qué se rompió.
Así es como se ve tu centro de control:
Panel Kanban
La mejor parte es que todo el equipo funciona desde tu teléfono. Creas y diriges tareas a través de Telegram, y los agentes las recogen mientras no estás en el escritorio.
Mira esto:
En este artículo construimos esta configuración completa desde cero: el modelo de coordinación, los informes y un equipo de software de 4 miembros que se ejecuta en tu propio hardware en unos 20 minutos.
Para demostrarlo, creé un clon funcional de Google Docs, con funciones de IA incluidas, un backend listo para producción, construido exactamente por este equipo de agentes.
Demostración del clon de Google Docs
Así que, sin más preámbulos, comencemos.
Por qué un solo agente no es suficiente
Digamos, por ejemplo, que quieres agregar una función de restablecimiento de contraseña. El trabajo se divide en tres dominios:
- Un desarrollador backend que construye la API REST
- Un desarrollador frontend que lee esa API y construye la interfaz sobre ella
- Un tester que verifica todo el flujo de principio a fin
1 agente vs 3 agentes
Puedes ejecutar todo a través de un solo agente, pero la ventana de contexto se llena y el agente pierde el rastro de lo que hizo tres pasos atrás. Pasas más tiempo gestionándolo del que te ahorra.
Dividir el trabajo entre agentes que poseen cada dominio crea un problema diferente: ¿cómo sabe el desarrollador frontend lo que construyó el desarrollador backend? Ese problema de contexto compartido es lo que resuelve Hermes Kanban.
El modelo mental: un tablero de tareas, pero con agentes detrás de las columnas
Una tarea tiene un título, una descripción, un responsable y un estado. Alguien la toma, la mueve por el tablero y la cierra. El tablero es la única fuente de verdad.
Hermes Kanban mantiene ese modelo y coloca agentes detrás de cada columna en lugar de humanos.
Tablero Hermes Kanban
Cada tarea es una fila que sobrevive a fallos y reinicios. Cuando un agente termina, escribe un resumen: archivos modificados, lo que construyó, lo que el siguiente agente necesita saber. El siguiente agente lee ese resumen antes de comenzar.
Ese resumen es la clave. Es lo que convierte un grupo de agentes en un equipo en lugar de desconocidos.
El vocabulario
Tenemos 6 columnas diferentes en el tablero Kanban:
- Triage: Las ideas vagas llegan aquí, útiles para "quiero limitación de velocidad en autenticación" antes de tener una especificación completa.
- Por hacer: Tarea creada pero esperando una dependencia. No se moverá hasta que su padre termine.
- Lista: Dependencias cumplidas, esperando que un agente la tome.
- En progreso: Un agente está trabajando activamente.
- Bloqueada: El agente encontró un obstáculo y lo notificó a un humano. Nada se ejecuta hasta que desbloquees la tarea.
- Hecha: Terminada, con historial completo de ejecución, resumen y metadatos preservados.
El orquestador: un agente que gestiona a los demás
Piensa en el agente orquestador como el gestor de proyecto que lee un objetivo de alto nivel, verifica qué agentes existen, desglosa el objetivo en tareas vinculadas y se aparta. Nunca escribe código ni ejecuta pruebas. Coordina.
El agente orquestador
La única regla importante: verificar qué perfiles existen antes de crear tareas. El sistema omite silenciosamente cualquier tarea cuyo responsable no coincida con un perfil real, por lo que el paso cero es siempre kanban_list.
Así es un turno típico del gestor de proyecto, descomponiendo una solicitud de "construir un flujo de restablecimiento de contraseña" en una tubería vinculada:
1kanban_show()23be = kanban_create(title="Backend de restablecimiento de contraseña", assignee="backend-developer",4 body="Flujo de contraseña olvidada/restablecimiento + invalidación de sesión")56fe = kanban_create(title="Interfaz de restablecimiento de contraseña", assignee="frontend-developer",7 parents=[be], body="Flujo de restablecimiento en Next.js usando la API del backend")89qa = kanban_create(title="Prueba E2E de restablecimiento de contraseña", assignee="tester",10 parents=[fe], body="Validar todos los criterios de aceptación")1112kanban_complete(summary="Creada tubería de dependencias: backend → frontend → QA")
Después de esto, el tablero maneja la promoción y los informes manejan el contexto. Cuando los tres terminan, el gestor de proyecto se despierta, lee los resúmenes y juzga si el trabajo está completo. Si el tester devuelve "verdict": "FAIL", crea tareas de corrección y el bucle continúa.
Pero en realidad, no tienes que preocuparte por nada. Solo necesitas delegar una tarea desde Telegram y el orquestador se encarga del resto.
Tres patrones que usarás constantemente
1. La tubería: Cada tarea depende de la anterior. Solo la primera comienza en Lista. Las demás esperan su turno.
1BACKEND=$(hermes kanban create "Implementar API de autenticación" \2 --assignee backend-developer \3 --body "POST /register, POST /login, POST /refresh, POST /logout." \4 --json | jq -r .id)56FRONTEND=$(hermes kanban create "Construir interfaz de autenticación" \7 --assignee frontend-developer \8 --parent $BACKEND \9 --body "Leer la transferencia del backend para la forma de la API. Páginas de inicio de sesión, registro, perfil." \10 --json | jq -r .id)1112hermes kanban create "Probar flujo de autenticación de principio a fin" \13 --assignee tester \14 --parent $FRONTEND \15 --body "Cubrir caso feliz, contraseña incorrecta, token expirado, persistencia de sesión."
No ejecutas esto manualmente. Le describes el proyecto al gestor de proyecto en Telegram y él crea estas tareas por ti. Por debajo se ve como lo anterior.
Cuando el agente backend llama a kanban_complete(), la tarea frontend se mueve a Lista con el trabajo del backend adjunto.
2. Humano en el bucle: No todos los bloqueos son fallos. A veces un agente encuentra un problema real y se detiene para preguntar.
1kanban_block(reason="revisión-requerida: falta verificación de fortaleza de contraseña, "2 "los tokens de restablecimiento no son de un solo uso (pueden repetirse dentro de 30 min)")
Ves el bloqueo en el panel. Verificas el problema, lo corriges y desbloqueas la tarea:
1hermes kanban unblock $IMPL
Tampoco ejecutas esto en la terminal; solo comentas en el tablero Kanban o envías un mensaje en Telegram, y el sistema lo desbloquea.
El sistema reinicia el agente en el siguiente ciclo. La segunda ejecución llama a kanban_show() y ve exactamente por qué el primer intento fue bloqueado. Sabe qué corregir; no empieza desde cero.
3. Especificador de triage.
Cuando tienes una idea vaga en lugar de una especificación completa, colócala en el tablero y deja que el sistema la desarrolle antes de que cualquier agente la tome.
1# Colocar una idea vaga2hermes kanban create "la autenticación necesita limitación de velocidad" --triage --assignee backend-developer34# Desarrollarla antes de que el despachador la tome5hermes kanban specify $TASK_ID
El comando specify reescribe el título de tres palabras en una tarea completa con un objetivo, un enfoque y criterios de aceptación. El agente que la toma recibe un informe real.
Configurándolo: cuatro perfiles en unos 20 minutos
Cuatro agentes, un tablero compartido, el gestor de proyecto accesible en Telegram.
Paso 1: Crear los perfiles.
1hermes profile create project-manager --clone2hermes profile create backend-developer --clone3hermes profile create frontend-developer --clone4hermes profile create tester --clone
--clone copia la configuración de tu perfil predeterminado como punto de partida.
Paso 2: Darle a cada agente una personalidad
1. Gestor de Proyecto en ~/.hermes/profiles/project-manager/SOUL.md:
1# Alma23Eres el gestor de proyecto de un equipo de desarrollo de software. Tu trabajo4es tomar la idea de aplicación de un usuario, dividirla en tareas claras, asignarlas5a los miembros correctos del equipo y hacer seguimiento del progreso en el tablero Kanban.6No escribes código tú mismo. Gestionas el trabajo.
2. Desarrollador Backend en ~/.hermes/profiles/backend-developer/SOUL.md:
1# Alma23Eres el desarrollador backend de un equipo de software. Construyes y gestionas4todo el backend usando InsForge — base de datos, autenticación, almacenamiento, funciones5edge y despliegue.
3. Desarrollador Frontend en ~/.hermes/profiles/frontend-developer/SOUL.md:
1# Alma23Eres el desarrollador frontend de un equipo de software. Construyes la interfaz —4componentes, páginas y flujos de usuario — y los conectas al backend5usando las APIs y métodos SDK que el desarrollador backend ha configurado.
4. Tester en ~/.hermes/profiles/tester/SOUL.md:
1# Alma23Eres el tester de un equipo de software. Pruebas las funcionalidades completadas4de principio a fin, verificas que se cumplan los criterios de aceptación y reportas errores5claramente en el tablero Kanban para que puedan ser corregidos.
Paso 3: Agregar habilidades a los agentes
Las habilidades son guías paso a paso, instrucciones específicas sobre cómo realizar ciertos tipos de trabajo. Piensa en ellas como capacitación laboral para tus agentes. Vamos a enumerarlas una por una:
InsForge (código abierto, Apache 2.0) actúa como capa de ingeniería de contexto backend para agentes que usan Habilidades y CLI. El perfil de nuestro agente desarrollador backend usa esta habilidad para tener un servicio backend listo para usar para los proyectos.
Primero, agrega el tap de habilidades de InsForge:
1hermes skills tap add InsForge/insforge-skills
Luego instala las habilidades del backend:
1hermes -p backend-developer skills install InsForge/insforge-skills/insforge --force
Del mismo modo instalamos otras como insforge-cli (comandos de infraestructura), insforge-debug (diagnóstico de fallos) e insforge-integrations (proveedores de autenticación de terceros).
Así es como el agente desarrollador backend usa la habilidad para construir el backend de nuestro proyecto en InsForge.
Primero, el agente desarrollador backend crea un proyecto llamado "Google Docs Clone" en InsForge.
El panel muestra estadísticas del proyecto como el número de Usuarios, tablas en la Base de datos, Almacenamiento y la lista de Funciones Edge con código JavaScript/TypeScript desplegado relacionado con autenticación, manejo de documentos, etc.
Así que si estás construyendo un ingeniero backend de IA, echa un vistazo a InsForge →
(no olvides darle estrella 🌟)
Más habilidades desde Skills Hub
Hermes también mantiene un Skills Hub con 687 habilidades en 18 categorías: 87 integradas, 79 opcionales, 16 de Anthropic (frontend-design, pdf, pptx, docx, mcp-builder, y más) y 505 de LobeHub.
Para el desarrollador frontend, instala frontend-design. Para el tester, instala webapp-testing. Ambas vienen incluidas en el Hub.
Paso 4: Inicializar el tablero e iniciar la puerta de enlace.
hermes kanban init crea ~/.hermes/kanban.db, la base de datos SQLite que almacena cada tarea, contexto e historial de ejecución.
Luego configura la puerta de enlace de chat bajo el perfil del gestor de proyecto. Obtén un token de bot de @BotFather en Telegram y tu ID de usuario de @userinfobot, luego:
1hermes kanban init2hermes -p project-manager gateway setup3hermes -p project-manager gateway start
La conexión funciona 24/7, mantiene el sistema activo y hace que el gestor de proyecto sea accesible en Telegram.
Paso 5: Enviar tu primer proyecto.
Envía un mensaje al gestor de proyecto con lo que quieres construir. Divide el objetivo en tareas, las crea con enlaces de dependencia y el sistema las ejecuta en orden.
El panel
Ejecuta hermes dashboard y abre http://127.0.0.1:9119. Obtienes una columna por estado y actualizaciones en vivo a través de un WebSocket sin necesidad de actualizar.
0:20
Panel Hermes Kanban
Dos controles vale la pena conocer. Lanes by profile sub-agrupa la columna En progreso por responsable, para que puedas ver qué agente posee qué de un vistazo. Nudge dispatcher ejecuta un pase inmediatamente en lugar de esperar 60 segundos, lo que ayuda justo después de desbloquear una tarea.
Haz clic en cualquier tarjeta para abrir su cajón con el historial completo de ejecución, el resultado de cada intento y metadatos, y campos editables para título, responsable, prioridad y dependencias.
Qué tener en cuenta
Tres modos de fallo que vale la pena conocer antes de una carga de trabajo seria.
1. Sobrecarga de la base de datos. Con 2 a 4 agentes en paralelo nunca llegarás a esto. Con 10+ agentes escribiendo a alta frecuencia, las cosas se ralentizan. Limítalo con hermes kanban dispatch --max 4.
2. Eliminación del espacio de trabajo temporal. Los archivos guardados en un espacio de trabajo temporal desaparecen en cuanto la tarea se marca como hecha, porque el espacio temporal se borra por diseño. Usa worktree para tareas de código, o coloca la ruta de la carpeta del proyecto en la descripción de la tarea para que el agente sepa dónde guardar.
3. Saturación del modelo local. Con un modelo local (Ollama, GPU local), el sistema puede lanzar varios agentes a la vez y abrumar la GPU, lo que ralentiza la generación y activa la parada automática. Para configuraciones locales, hermes kanban dispatch --max 2. Con modelos basados en API como Claude o GPT-4o, esto rara vez es un problema.
El panorama completo
Cada pieza tiene un trabajo:
- SOUL.md es la identidad fija del agente: quién es y cómo piensa.
- Habilidades son las instrucciones paso a paso para tipos específicos de trabajo.
- Memoria es lo que el agente sabe sobre tu entorno a través de las sesiones.
- Kanban es la capa de coordinación: estado compartido, transferencia de contexto y un humano en el bucle en cualquier punto.
Cuatro perfiles, cuatro archivos SOUL.md, un inicio de puerta de enlace. Describe lo que quieres construir al gestor de proyecto en Telegram y observa cómo se llena el tablero.
Si aprendes mejor con video, en un par de días saldrá una guía completa de Hermes Kanban en YouTube y X.
Gracias por leer.
