Una guía completa de Hermes Kanban: el modelo de coordinación, cómo compartir contexto entre agentes y la creación de un equipo de software de 4 agentes (PM, backend, frontend, tester) en aproximadamente 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 ocurre es lo contrario. Los agentes empiezan con una pizarra en blanco. Un agente no sabe lo que construyeron los demás, qué archivos cambiaron o cómo es la API. Cada traspaso es un arranque en frío, y el trabajo se degrada en el momento en que pasa de un agente a otro.
Hermes Kanban soluciona eso. Cada tarea sobrevive a fallos y reinicios. Cada informe lleva exactamente lo que necesita el siguiente agente. Cada fallo se guarda, para que el reintento sepa qué se rompió.
Así es como se ve tu centro de control:
Panel Kanban
Lo mejor 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 estás lejos del 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 aproximadamente 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, vamos a ello.
Por qué un solo agente no es suficiente
Supongamos, por ejemplo, que quieres añadir 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 conjunto de extremo a extremo
1 vs 3 Agentes
Puedes ejecutar los tres a través de un solo agente, pero la ventana de contexto se llena y el agente pierde la noción de lo que hizo hace tres pasos. Pasas más tiempo gestionándolo del que te ahorra.
Dividir el trabajo entre agentes que son dueños de 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 los agentes se sitúan detrás de las columnas
Una tarea tiene un título, una descripción, un responsable y un estado. Alguien la recoge, la mueve por el tablero y la cierra. El tablero es la fuente única 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 cambiados, lo que construyó, lo que necesita saber el siguiente agente. El siguiente agente lee ese resumen antes de empezar.
Ese resumen es toda la clave. Es lo que convierte a un grupo de agentes en un equipo en lugar de extraños.
El vocabulario
Tenemos 6 columnas diferentes en el tablero Kanban:
- Triage: Las ideas aproximadas llegan aquí, ideal para "quiero limitación de tasa de 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.
- Listo: Dependencias cumplidas, esperando que un agente la recoja.
- En progreso: Un agente está ejecutándose activamente.
- Bloqueado: El agente encontró un obstáculo y lo señaló para un humano. Nada se ejecuta hasta que lo desbloquees.
- Hecho: Terminado, con historial completo de ejecución, resumen y metadatos conservados.
El orquestador: un agente que gestiona al resto
Piensa en el agente orquestador como el gestor de proyectos que lee un objetivo de alto nivel, verifica qué agentes existen, divide el objetivo en tareas vinculadas y se retira. Nunca escribe código ni ejecuta pruebas. Coordina.
El agente orquestador
La única regla que importa: comprobar qué perfiles existen antes de crear tareas. El sistema omite silenciosamente cualquier tarea cuyo responsable no coincida con un perfil real, así que el paso cero es siempre kanban_list.
Este es un turno típico de gestor de proyectos, descomponiendo una solicitud de "construir un flujo de restablecimiento de contraseña" en un pipeline vinculado:
1kanban_show()23be = kanban_create(title="Backend de restablecimiento de contraseña", assignee="backend-developer",4 body="Flujo de olvido/restablecimiento de contraseña + invalidación de sesión")56fe = kanban_create(title="UI 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="Creado pipeline de dependencias backend → frontend → QA")
Después de esto, el tablero gestiona la promoción y los informes gestionan el contexto. Cuando los tres terminan, el gestor de proyectos se despierta, lee los resúmenes y determina si el trabajo está hecho. 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. El pipeline: Cada tarea depende de la anterior. Solo la primera comienza en "Listo". Todo lo demás espera 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 UI de autenticación" \7 --assignee frontend-developer \8 --parent $BACKEND \9 --body "Leer informe 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 extremo a extremo" \13 --assignee tester \14 --parent $FRONTEND \15 --body "Cubrir camino feliz, contraseña incorrecta, token expirado, persistencia de sesión."
No ejecutas esto manualmente. Le describes el proyecto al gestor de proyectos en Telegram y él crea estas tareas por ti. Internamente se ve como lo anterior.
Cuando el agente backend llama a kanban_complete(), la tarea frontend se mueve a "Listo" con el trabajo del backend adjunto.
2. Humano en el bucle: No todos los bloqueos son un fracaso. A veces un agente encuentra un problema real y se detiene para preguntar.
1kanban_block(reason="revisión requerida: falta verificación de seguridad de contraseña, "2 "los tokens de restablecimiento no son de un solo uso (se pueden reutilizar en 30 min)")
Ves el bloqueo en el panel. Verificas el problema, lo solucionas 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 por 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 precisamente qué corregir; no empieza desde cero.
3. Especificador de triage.
Cuando tienes una idea aproximada 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 recoja.
1# Colocar una idea aproximada2hermes kanban create "auth necesita limitación de tasa" --triage --assignee backend-developer34# Desarrollarla antes de que el despachador la recoja5hermes 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 recoge recibe un informe real.
Configurarlo: cuatro perfiles en aproximadamente 20 minutos
Cuatro agentes, un tablero compartido, el gestor de proyectos accesible por 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 por defecto como punto de partida.
Paso 2: Darle personalidad a cada agente
1. Gestor de proyectos en ~/.hermes/profiles/project-manager/SOUL.md:
1# Alma23Eres el gestor de proyectos 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, funciones5de borde y despliegue.
3. Desarrollador frontend en ~/.hermes/profiles/frontend-developer/SOUL.md:
1# Alma23Eres el desarrollador frontend de un equipo de software. Construyes la UI —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 funciones completadas4de extremo a extremo, verificas que se cumplan los criterios de aceptación y reportas5los errores claramente al tablero Kanban para que puedan ser corregidos.
Paso 3: Añadir 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 formación laboral para tus agentes. Vamos a enumerarlas una por una:
InsForge (código abierto, Apache 2.0) actúa como la capa de ingeniería de contexto del backend para agentes que usan Skills y CLI. Nuestro perfil de agente desarrollador backend usa esta habilidad para tener un servicio backend listo para usar en proyectos.
Primero, añade 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ósticos 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 lista de Edge Functions 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 incorporadas, 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. Ambos se incluyen 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 contiene cada tarea, contexto e historial de ejecución.
Luego configura la puerta de enlace de chat bajo el perfil del gestor de proyectos. 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 proyectos esté accesible en Telegram.
Paso 5: Envía tu primer proyecto.
Envía un mensaje al gestor de proyectos con lo que quieres que se construya. 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 recargar.
0:20
Panel Hermes kanban
Dos controles vale la pena conocer. Carriles por perfil agrupa la columna de Ejecución por responsable, para que puedas ver de un vistazo qué agente posee qué. Nudge dispatcher ejecuta una pasada 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 y metadatos de cada intento, 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 el momento en que la tarea se marca como hecha, porque el espacio temporal se borra por diseño. Usa worktree para tareas de codificación, 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. Contra 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. Para modelos respaldados por 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.
- Las habilidades son las instrucciones paso a paso para tipos específicos de trabajo.
- La memoria es lo que el agente sabe sobre tu entorno entre 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 proyectos en Telegram y observa cómo se llena el tablero.
Si aprendes mejor con video, una guía completa de Hermes Kanban se publicará en YouTube y X en un par de días.
Gracias por leer.
