¿Qué hace Orquestación de Equipos de Agentes?
Usa esta habilidad cuando los agentes se gestionan como un equipo en lugar de como un asistente único. El propósito es hacer que la orquestación basada en equipos sea confiable: elementos de trabajo claros, propiedad explícita, estado Kanban del agente, aislamiento de ramas, visibilidad del panel de control y compuertas de fusión.
Cuándo Activar
- La tarea abarca múltiples agentes, herramientas, arneses, ramas o árboles de trabajo.
- El usuario menciona orquestación de equipos, Kanban de agentes, escuadrón, director, panel de control, gestor, aplicación de escritorio, Zellij, tmux, Hermes, Devin, Codex, Claude Code o trabajo multiagente.
- Un proyecto necesita estado de flujo de trabajo compartido entre personas y agentes.
- La dispersión de agentes existente está produciendo resultados, pero no un producto fusionable.
Modelo Operativo
Trata a cada agente como un compañero de equipo con un contrato estrecho:
- Propietario: la persona o agente responsable del elemento de trabajo.
- Alcance: archivos, rama, superficie de herramientas y áreas prohibidas.
- Estado: pendiente, listo, ejecutándose, revisión, bloqueado, fusionado o archivado.
- Evidencia: pruebas, capturas de pantalla, registros, notas de revisión o informes de evaluación.
- Compuerta de fusión: la condición exacta que permite la integración.
Kanban de Agentes
Usa Kanban de agentes cuando el trabajo debe ser visible entre sesiones.
| Columna | Significado | Criterios de Salida |
|---|---|---|
| Pendiente | Elemento de trabajo candidato, aún no definido | Criterios de aceptación escritos |
| Listo | Definido y asignable | Propietario y rama/árbol de trabajo asignados |
| Ejecutándose | El agente está trabajando activamente | Existen artefacto de traspaso y archivos modificados |
| Revisión | El trabajo está completo pero no fusionado | Pasan pruebas, revisión de diferencias y verificación de riesgos |
| Bloqueado | Necesita entrada externa o falló la compuerta | El bloqueador tiene propietario y próxima acción |
| Fusionado | Integrado en la línea principal | PR fusionado o main local actualizado |
| Archivado | Ya no es relevante | Razón registrada |
Cada tarjeta debe ajustarse a este esquema:
{
"id": "tarjeta-agente-001",
"title": "Construir habilidad de flujo de trabajo dinámico",
"owner": "codex",
"state": "ejecutándose",
"branch": "product/flujo-trabajo-dinamico-orquestacion-equipos",
"worktree": ".",
"acceptance": [
"La habilidad existe",
"Las pruebas cubren los conceptos requeridos",
"El artefacto de contenido contiene ángulos de video y artículo"
],
"merge_gate": "lint, pruebas enfocadas y verificación de catálogo pasan",
"handoff": "ruta/al/traspaso.md"
}
Flujo de Orquestación Basada en Equipos
- Dar forma al tablero: convertir ambiciones difusas en elementos de trabajo con propietarios y compuertas de fusión.
- Elegir modo de ejecución: agente único, modo de flujo de trabajo dinámico, dmux/tmux, dispersión de árboles de trabajo u orquestador de escritorio externo.
- Asignar límites: un propietario por tarjeta, alcance de archivo claro y sin escrituras superpuestas sin un integrador.
- Ejecutar agentes: cada agente escribe evidencia y notas de traspaso, no solo código.
- Revisar en secuencia: pruebas primero, luego revisión de diferencias, luego comprobaciones de seguridad/riesgo, luego pulido de contenido/producto.
- Fusionar deliberadamente: un integrador resuelve conflictos y actualiza el panel de control o artefacto de estado.
- Extraer habilidad reutilizable: si el patrón de tarjeta se repite, promuévelo a
skills/.
Requisitos del Panel de Control
Un panel de control útil para la orquestación de equipos debe mostrar:
- Elementos de trabajo activos y su estado Kanban de agente.
- Propietario, arnés, rama, árbol de trabajo y último latido.
- Enlaces a artefactos de traspaso, pruebas, capturas de pantalla y PRs.
- Bloqueadores agrupados por propietario y acción de desbloqueo.
- Preparación para fusión por compuerta, no por sensaciones.
- Candidatos a flujo de trabajo reutilizables que deberían convertirse en habilidades compartidas.
No añadas más automatización hasta que el operador pueda responder: ¿quién es el propietario de esto?, ¿qué cambió?, ¿qué compuerta falló?, ¿qué se puede fusionar de forma segura?
Compatibilidad con Flujo de Trabajo Dinámico
Cuando una tarjeta necesita modo de flujo de trabajo dinámico:
- Coloca el arnés local a la tarea bajo el propietario de la tarjeta.
- Almacena entradas y salidas en la tarjeta.
- Requiere una evaluación antes de pasar de Ejecutándose a Revisión.
- Promueve el arnés a una habilidad compartida solo después de uso repetido.
Modos de Falla a Vigilar
- Sopa de agentes: muchos agentes ejecutándose, sin propietario ni compuerta de fusión.
- Trabajo invisible: existe resultado útil solo en una transcripción de chat.
- Teatro de tablero: existe un tablero Kanban pero las tarjetas no tienen criterios de aceptación.
- Escrituras superpuestas: agentes paralelos editan los mismos archivos sin árboles de trabajo.
- Sin artefacto de producto: el proceso produce documentos pero no una superficie ejecutable o publicable.
Estándar de Salida
Finaliza cada pase de orquestación con:
- Cambios en el tablero/tarjetas.
- Ramas fusionadas o pendientes.
- Evidencia de pruebas y evaluaciones.
- Bloqueadores con propietario y próxima acción.
- Nuevos candidatos a habilidades compartidas.