¿Qué hace Orquestación en Equipo de Agentes?
Usa esta habilidad cuando los agentes se gestionen como un equipo, no como un asistente individual. El objetivo es hacer que la orquestación basada en equipos sea fiable: elementos de trabajo claros, propiedad explícita, estado Kanban de 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 áreas de trabajo.
- El usuario menciona orquestación de equipo, Kanban de agente, escuadrón, director, panel de control, gestor, aplicación de escritorio, Zellij, tmux, Hermes, Devin, Codex, Claude Code, o trabajo multi-agente.
- Un proyecto necesita estado de flujo de trabajo compartido entre personas y agentes.
- La expansión (fan-out) de agentes existente produce resultados, pero no un producto fusionable.
Modelo Operativo
Trata a cada agente como un compañero de equipo con un contrato reducido:
- Propietario (Owner): la persona o agente responsable del elemento de trabajo.
- Alcance (Scope): archivos, rama, superficie de herramientas y áreas prohibidas.
- Estado (State): backlog, listo, ejecutando, revisión, bloqueado, fusionado o archivado.
- Evidencia (Evidence): pruebas, capturas de pantalla, registros, notas de revisión o informes de evaluación.
- Compuerta de fusión (Merge gate): la condición exacta que permite la integración.
Kanban de Agente
Usa Kanban de agente cuando el trabajo deba ser visible entre sesiones.
| Columna | Significado | Criterio de Salida |
|---|---|---|
| Backlog | Elemento candidato, aún no definido | Criterios de aceptación escritos |
| Listo | Definido y asignable | Propietario y rama/área de trabajo asignados |
| Ejecutando | El agente está trabajando activamente | Artefacto de traspaso y archivos modificados existentes |
| Revisión | Trabajo completado pero no fusionado | Pruebas, revisión de diferencias y verificación de riesgos superados |
| Bloqueado | Necesita entrada externa o falló la compuerta | Bloqueo tiene propietario y siguiente acción |
| Fusionado | Integrado en la línea principal | PR fusionado o rama principal actualizada localmente |
| Archivado | Ya no es relevante | Motivo registrado |
Cada tarjeta debe ajustarse a este esquema:
{
"id": "agent-card-001",
"title": "Construir habilidad de flujo de trabajo dinámico",
"owner": "codex",
"state": "running",
"branch": "product/dynamic-workflow-team-orchestration",
"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 superadas",
"handoff": "path/to/handoff.md"
}
Flujo de Orquestación Basado en Equipo
- Dar forma al tablero: convertir la ambición difusa 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, expansión de áreas de trabajo, orquestador de escritorio externo.
- Asignar límites: un propietario por tarjeta, alcance de archivos 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 verificaciones de seguridad/riesgo, luego pulido de contenido/producto.
- Fusionar deliberadamente: un integrador resuelve conflictos y actualiza el panel de control o el artefacto de estado.
- Extraer habilidad reutilizable: si el patrón de la tarjeta se repite, promuévalo 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, área de trabajo y último latido.
- Enlaces a artefactos de traspaso, pruebas, capturas de pantalla y PRs.
- Bloqueos 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ñada más automatización hasta que el operador pueda responder: ¿quién posee esto, qué cambió, qué compuerta falló y qué se puede fusionar de forma segura?
Compatibilidad con Flujo de Trabajo Dinámico
Cuando una tarjeta necesite modo de flujo de trabajo dinámico:
- Ponga el arnés local de la tarea bajo el propietario de la tarjeta.
- Almacene entradas y salidas en la tarjeta.
- Requiera una evaluación antes de pasar de Ejecutando a Revisión.
- Promueva el arnés a habilidad compartida solo después de uso repetido.
Modos de Fallo a Vigilar
- Sopa de agentes: muchos agentes ejecutándose, sin propietario ni compuerta de fusión.
- Trabajo invisible: salida útil existente 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 áreas de trabajo.
- Sin artefacto de producto: el proceso produce documentos pero ninguna superficie ejecutable o publicable.
Estándar de Salida
Finalice cada paso de orquestación con:
- Cambios en el tablero/tarjetas.
- Ramas fusionadas o pendientes.
- Pruebas y evidencia de evaluación.
- Bloqueos con propietario y siguiente acción.
- Nuevos candidatos a habilidad compartida.