Hybrid Human Multi-Agent Kanban: Coordinating Claude, Claude Code, and a Human Inside a Knowledge Graph

Kanban híbrido humano y multiagente: coordinar a Claude, Claude Code y una persona dentro de un grafo de conocimiento

Baristas expertos en Good Brew

Gestiono un grafo de conocimiento personal con más de 9.000 pensamientos interconectados, construido a lo largo de una década en TheBrain. Cuando empecé a construir servidores MCP para dar a Claude acceso programático a mis herramientas y servicios, supe que haría falta una solución de coordinación. Varios agentes de IA, cada uno sin memoria, trabajando junto a una persona durante días y semanas en proyectos continuados: eso exige un estado compartido modificable, convenciones claras y ergonomía visual. Los archivos README y el historial de conversaciones nunca iban a bastar.

Así que Claude, Claude Code y yo construimos un protocolo de coordinación de tareas dentro del propio grafo de conocimiento. Aquí están la arquitectura, sus razones y suficiente detalle para que construya el suyo.

El problema de la coordinación

Si hace trabajo de proyecto real con agentes de IA (no preguntas sueltas, sino desarrollo de varias sesiones que abarca diseño, implementación y despliegue), tiene que resolver esto: cada nueva sesión de un agente empieza sin memoria alguna. Claude Code no sabe lo que claude.ai decidió esta mañana. La sesión de mañana no recordará la de hoy. Y la persona tiene sus propias tareas (configurar credenciales, desplegar, fusionar PR) que los agentes no pueden hacer pero deben seguir.

De ahí se derivan tres requisitos:

1. Estado compartido que cualquier agente pueda leer y escribir, en cualquier dispositivo, sin contexto previo.
2. Convenciones estructurales que permitan a un agente orientarse en segundos, no en minutos de análisis de texto.
3. Ergonomía visual, para que la persona vea de un vistazo qué está activo, qué está hecho y qué requiere su atención.

Los tres requisitos deben cubrirse con el mismo artefacto. Los sistemas separados acaban divergiendo. Solo un grafo único que sirva por igual a agentes y personas se sostiene.

TheBrain como sustrato

TheBrain es una herramienta de gestión del conocimiento construida en torno a un grafo infinito y ampliable. Los nodos (pensamientos) tienen padres, hijos, vínculos cruzados («jumps»), notas, adjuntos, Tipos con colores e iconos heredados, etiquetas y rótulos. Premia la inversión a largo plazo: mi grafo refleja una década de estructura y relaciones acumuladas.

El fundamento arquitectónico: exponer toda la API de grafo de TheBrain mediante un servidor Model Context Protocol. Construí thebrain-mcp, un servidor Python FastMCP que envuelve la API de TheBrain y añade BrainQuery, un lenguaje de consulta parecido a Cypher para buscar patrones en el grafo. Desplegado en FastMCP Cloud, es accesible desde cualquier cliente de Claude: web, escritorio, móvil y línea de comandos. Cualquier sesión de agente, en cualquier lugar, lee y escribe en el mismo grafo.

Eso resuelve el estado compartido modificable. Después vienen las convenciones.

El protocolo

Todos los proyectos de mi colección «Claude Thoughts» siguen el Project Task Management Protocol, un documento vivo guardado en el propio grafo, que cada agente lee al iniciar su sesión.

Jerarquía estructural

Proyecto (p. ej., «thebrain-mcp»)
  └── TASKS
        ├── Proposed        ← en cola para más adelante
        ├── In-Progress     ← en curso
        ├── Parked          ← aplazado o sustituido
        ├── Done            ← terminado
        └── Lessons Learned ← referencia transversal

El estado es estructural, no textual. El estado de una tarea lo determina la columna Kanban de la que cuelga. Mover una tarea significa cambiarle el padre en el grafo, no editar un campo de estado en una nota. Los agentes analizan la estructura de un grafo con más fiabilidad que el texto libre, así que codificamos el estado donde el análisis tiene éxito garantizado.

Un agente que llega sin contexto va a TASKS, ve cuatro columnas, revisa In-Progress (¿retomar trabajo activo?) y luego Proposed (¿coger lo siguiente?). Dos saltos en el grafo para orientarse por completo.

Pensamientos de tarea

Cada tarea es un pensamiento propio con una nota rica: objetivo, especificación, criterios de aceptación, casos de prueba y notas de cierre. El detalle vive en la tarea, no en el tablero. El tablero se mantiene ligero (un índice estructural, no un vertedero de especificaciones), por debajo de 3 KB, para que los agentes lo carguen en una sola llamada y les quede ventana de contexto para el trabajo real.

Señalar tareas bloqueadas

Cuando una tarea necesita una acción humana (fusionar una PR, configurar un servicio, aprobar credenciales), el agente le pone la etiqueta @todo, una etiqueta compartida visible en el filtro de etiquetas de la interfaz de TheBrain. La etiqueta se superpone a la posición en la columna: la tarea sigue en In-Progress con una señal @todo añadida. Cuando la persona resuelve el bloqueo, quita la etiqueta y deja una nota. La siguiente sesión de agente ve la tarea desbloqueada y sigue donde lo dejó la anterior.

Definición de terminado

Las tareas de código no están terminadas hasta que la PR se ha fusionado y desplegado. El protocolo asigna cada etapa del flujo a una columna y un rótulo. Una tarea fusionada pero sin desplegar se queda en In-Progress con el rótulo «Merged (pending deploy)». Los agentes nunca deben marcar tareas como terminadas antes de tiempo: las sesiones siguientes darían por hecho que el trabajo está en producción cuando no lo está.

El sistema de Tipos: pistas visuales para las personas

El sistema de Tipos de TheBrain propaga propiedades visuales (colores e iconos) a todos los pensamientos tipados. Usamos cuatro Tipos de estado, hijos de un Tipo padre 🤖 Agent Task:

Tipo Color Significado
Done Task Verde Terminada en todo el flujo
In-Progress Task Ámbar En curso
Proposed Task Azul En cola para más adelante
Parked Task Gris Aplazada o sustituida

La jerarquía de Tipos:

Task
├── 👤 Human Task
└── 🤖 Agent Task
      ├── Done Task        (verde)
      ├── In-Progress Task (ámbar)
      ├── Proposed Task    (azul)
      └── Parked Task      (gris)

Asignar un Tipo de estado a una tarea le da el color correcto en todo el grafo. Los iconos definidos en un pensamiento de Tipo en la aplicación de escritorio se propagan a todas las tareas de ese Tipo. Se configura una vez y se ve en todas partes.

Cuando un agente mueve una tarea entre columnas, realiza tres operaciones: cambiar el padre del pensamiento, cambiar su Tipo y actualizar el rótulo. Es la triple señal: estructura, color y texto comunican el mismo estado. La persona que mira el grafo ve el color. El agente que recorre el grafo lee la estructura. El agente que analiza los metadatos lee el rótulo. Tres canales redundantes significan que un fallo parcial (un agente olvida actualizar el rótulo) aún deja dos señales correctas.

Una limitación a tener en cuenta: TheBrain solo permite un Tipo por pensamiento. Usar el Tipo para el estado impide un tipado semántico como «Infrastructure Task». Es la contrapartida correcta: las tareas ya están clasificadas por su proyecto padre y por su nombre. Si hace falta una clasificación secundaria, los vínculos cruzados a pensamientos de Tipo la cubren sin consumir el Tipo.

El trabajo multiagente en la práctica

Un día típico en mis tres proyectos activos:

Por la mañana, claude.ai. Sesión de diseño. Claude y yo evaluamos opciones de arquitectura, investigamos herramientas de terceros y tomamos decisiones estratégicas. Claude escribe las notas de diseño directamente en el pensamiento de la tarea correspondiente, crea tareas nuevas en Proposed con el Tipo correcto y enlaza tareas relacionadas entre proyectos.

Por la tarde, Claude Code. Sesión de implementación. Claude Code lee el protocolo (está ahí mismo, en el grafo), va a In-Progress, carga la especificación de la tarea activa, escribe código, ejecuta pruebas y crea una PR. Al terminar: mover a Done, cambiar el Tipo a Done Task, actualizar el rótulo con la fecha y el número de PR y escribir las notas de cierre en el pensamiento de la tarea.

Por la noche, la persona. Abro TheBrain. Una pared de verde en Done, una mancha ámbar en In-Progress, una etiqueta @todo en una tarea que me espera. Me encargo del paso manual (aprobar una credencial, fusionar una PR, configurar un servicio), quito la etiqueta @todo y dejo una nota. La sesión de agente de mañana lo retoma sin necesidad de explicaciones.

Ningún agente recuerda la sesión anterior. Ninguno lo necesita. El grafo es la memoria. El protocolo es el mecanismo de coordinación. Los Tipos y los colores son el panel de control.

El principio de conformidad

El protocolo incluye una comprobación de conformidad que cada agente ejecuta al iniciar la sesión: ¿tiene el proyecto las cuatro columnas Kanban? ¿Cuelgan las tareas del sitio correcto? ¿Coinciden los Tipos de estado con la columna? Si algo no es conforme, la reestructuración es lo primero, antes de cualquier trabajo del proyecto.

El principio rector: la multitud limpia el bien común. Cada sesión de agente deja la estructura al menos tan limpia como la encontró. Los agentes no solo consumen una infraestructura que mantienen las personas: la mantienen al usarla. Las operaciones de reestructuración son las mismas operaciones de grafo que usan para las tareas: crear pensamientos, crear vínculos, borrar vínculos, cambiar Tipos. No hay un «modo administrador» aparte. Mantener el sistema y usarlo son la misma actividad, y eso es lo que lo hace sostenible.

Cómo construir el suyo

Si quiere reproducir este sistema, esta es la receta.

Haga que el estado sea estructural, no textual. Codifique el estado en la topología del grafo (qué columna es padre de qué tarea), no en campos de texto que haya que analizar. Un salto en el grafo nunca falla. Una expresión regular, sí.

Mantenga ligero el tablero. El tablero TASKS debe pesar menos de 3 KB: solo las columnas Kanban y sus hijos. Las especificaciones completas van en los pensamientos de cada tarea, cargados bajo demanda. Los agentes deben dedicar su ventana de contexto al trabajo, no a orientarse.

Use la triple señal para el estado. Estructura (columna), color (herencia del Tipo) y texto (rótulo) deben coincidir. Diseñe para el caso en que una señal esté desactualizada: las otras dos siguen diciendo la verdad.

Ponga el protocolo en el grafo que gobierna. No en un README. No en una wiki. En el mismo grafo que recorren los agentes para sus tareas. El protocolo debe estar a un salto de cualquier proyecto, y encontrarse de forma natural al orientarse.

Aproveche la herencia de Tipos para la coherencia visual. Defina una vez un icono y un color en un pensamiento de Tipo; todas las tareas de ese Tipo lo heredan en todos los proyectos. Esa palanca es la que hace que una jerarquía de Tipos compense la limitación de un solo Tipo.

Exija comprobaciones de conformidad al iniciar sesión. Cada agente, cada sesión. Si la estructura se ha desviado, corríjala primero. Un pequeño mantenimiento en cada sesión evita grandes reestructuraciones después.

La pila tecnológica

TheBrain: grafo de conocimiento, más de 9.200 pensamientos, Tipos, etiquetas, ricas propiedades visuales
thebrain-mcp: servidor MCP de código abierto (Python/FastMCP), BrainQuery, CRUD completo, recorrido paginado, credenciales multiinquilino
FastMCP Cloud: despliegue remoto para el acceso de los agentes desde cualquier dispositivo
Claude (claude.ai): sesiones de diseño, investigación y estrategia
Claude Code: implementación, pruebas, flujo de PR
BTCPay Server + Lightning: infraestructura de pagos para la monetización de API (el proyecto que puso a prueba todo el flujo Kanban con los tres tipos de agentes)

El servidor thebrain-mcp está en GitHub. El protocolo, la jerarquía de Tipos y la estructura Kanban descritos aquí se pueden reproducir en cualquier instancia de TheBrain. El patrón de coordinación se generaliza a cualquier grafo compartido que los agentes puedan leer y escribir, pero las propiedades visuales de TheBrain, la herencia de Tipos y un modelo de datos que aguanta décadas lo hacen especialmente adecuado.

Construya la estructura una vez. Deje que los agentes la mantengan. Eche un vistazo a los colores. Entregue el trabajo.

Contacto:

🛒 cafe.tollbooth-dpyc.com
🐙 GitHub: lonniev
🐦 Búsqueme en X; se agradecen los «me gusta»

Si le ha resultado útil, acepto propinas en bitcoin.

Regresar al blog