Flujos de trabajo de dmux

Coordina sesiones paralelas de agentes de IA utilizando dmux, un gestor de paneles de tmux para entornos de pruebas de agentes.

Cuándo activarlo

• Cuando se ejecutan varias sesiones de agentes en paralelo
• Coordinar el trabajo entre Claude Code, Codex y otros entornos de pruebas
• Tareas complejas que se benefician del paralelismo de «divide y vencerás»
• El usuario dice «ejecutar en paralelo», «dividir este trabajo», «usar dmux» o «multiagente»

¿Qué es dmux?

dmux es una herramienta de orquestación basada en tmux que gestiona paneles de agentes de IA:

• Pulsa «n» para crear un nuevo panel con un indicador
• Pulsa m para fusionar la salida del panel con la sesión principal
• Compatible con: Claude Code, Codex, OpenCode, Cline, Gemini y Qwen

Instalación: Instala dmux desde su repositorio tras revisar el paquete. Consulta github.com/standardagents/dmux

Inicio rápido

# Iniciar una sesión de dmux
dmux

# Crear paneles de agente (pulsa «n» en dmux y, a continuación, escribe el indicador de comandos)
# Panel 1: «Implementar el middleware de autenticación en src/auth/»
# Panel 2: «Escribir pruebas para el servicio de usuario»
# Panel 3: «Actualizar la documentación de la API»

# Cada panel ejecuta su propia sesión de agente
# Pulsa «m» para fusionar los resultados de nuevo

Patrones de flujo de trabajo

Patrón 1: Investigación + Implementación

Dividir la investigación y la implementación en vías paralelas:

Panel 1 (Investigación): «Investiga las mejores prácticas para la limitación de tasa en Node.js.
  Revisa las bibliotecas actuales, compara enfoques y escribe los resultados en
  /tmp/rate-limit-research.md»

Panel 2 (Implementación): «Implementa un middleware de limitación de tasa para nuestra API de Express.
  Empieza con un token bucket básico; lo perfeccionaremos una vez finalizada la investigación».

# Una vez completado el Panel 1, fusiona los resultados en el contexto del Panel 2

Patrón 2: Funcionalidad de múltiples archivos

Paralelizar el trabajo en archivos independientes:

Panel 1: «Crea el esquema de la base de datos y las migraciones para la función de facturación»
Panel 2: «Crea los puntos finales de la API de facturación en src/api/billing/»
Panel 3: «Crea los componentes de la interfaz de usuario del panel de control de facturación»

# Fusiona todo y, a continuación, realiza la integración en el panel principal

Patrón 3: Bucle de prueba + corrección

Ejecutar pruebas en un panel, corregir en otro:

Panel 1 (Vigilante): «Ejecuta el conjunto de pruebas en modo de vigilancia. Cuando las pruebas fallen,
  resume los fallos».

Panel 2 (Corregidor): «Corrige las pruebas fallidas basándote en los mensajes de error del panel 1»

Patrón 4: Harness cruzado

Utilizar diferentes herramientas de IA para diferentes tareas:

Panel 1 (Claude Code): «Revisa la seguridad del módulo de autenticación»
Panel 2 (Codex): «Reestructura las funciones de utilidad para mejorar el rendimiento»
Panel 3 (Claude Code): «Escribe pruebas de extremo a extremo para el flujo de pago»

Patrón 5: Pipeline de revisión de código

Perspectivas de revisión paralelas:

Panel 1: «Revisar src/api/ en busca de vulnerabilidades de seguridad»
Panel 2: «Revisar src/api/ en busca de problemas de rendimiento»
Panel 3: «Revisar src/api/ en busca de lagunas en la cobertura de pruebas»

# Fusionar todas las revisiones en un único informe

Buenas prácticas

1. Solo tareas independientes. No paralelices tareas que dependan de los resultados de otras.
2. Límites claros. Cada panel debe trabajar con archivos o aspectos distintos.
3. Combina de forma estratégica. Revisa los resultados de cada panel antes de fusionarlos para evitar conflictos.
4. Utiliza árboles de trabajo de Git. Para trabajos propensos a conflictos de archivos, utiliza árboles de trabajo separados por panel.
5. Ten en cuenta los recursos. Cada panel utiliza tokens de API; mantén el número total de paneles por debajo de 5-6.

Integración de Git Worktree

Para tareas que afectan a archivos que se solapan:

# Crea árboles de trabajo para aislarlos
git worktree add -b feat/auth ../feature-auth HEAD
git worktree add -b feat/billing ../feature-billing HEAD

# Ejecuta los agentes en árboles de trabajo independientes
# Panel 1: cd ../feature-auth && claude
# Panel 2: cd ../feature-billing && claude

# Fusiona las ramas cuando hayas terminado
git merge feat/auth
git merge feat/billing

Herramientas complementarias

Asistente de ECC

ECC incluye ahora una herramienta auxiliar para la orquestación de paneles tmux externos con árboles de trabajo de Git independientes:

script de Node «scripts/orchestrate-worktrees.js plan.json --execute»

Ejemplo de plan.json:

{
  "sessionName": "skill-audit",
  "baseRef": "HEAD",
  "launcherCommand": "codex exec --cwd {worktree_path} --task-file {task_file}",
  "workers": [
    { "name": "docs-a", "task": "Corregir las habilidades 1-4 y redactar notas de traspaso." },
    { "name": "docs-b", "task": "Corregir las habilidades 5-8 y redactar notas de traspaso." }
  ]
}

El ayudante:

• Crea un árbol de trabajo de Git respaldado por una rama por cada trabajador
• Opcionalmente, superpone las rutas seedPaths seleccionadas del checkout principal en cada árbol de trabajo de cada trabajador
• Escribe los archivos task.md, handoff.md y status.md específicos de cada trabajador en la carpeta .orchestration//
• Inicia una sesión de tmux con un panel por cada trabajador
• Ejecuta cada comando de trabajador en su propio panel
• Deja el panel principal libre para el orquestador

Utiliza seedPaths cuando los trabajadores necesiten acceder a archivos locales modificados o no controlados que aún no formen parte de HEAD, como scripts de orquestación locales, borradores de planes o documentación:

{
  "sessionName": "workflow-e2e",
  "seedPaths": [
    "scripts/orchestrate-worktrees.js",
    "scripts/lib/tmux-worktree-orchestrator.js",
    ".claude/plan/workflow-e2e-test.json"
  ],
  "launcherCommand": "bash {repo_root}/scripts/orchestrate-codex-worker.sh {task_file} {handoff_file} {status_file}",
  "workers": [
    { "name": "seed-check", "task": "Comprobar que los archivos de inicialización estén presentes antes de comenzar el trabajo." }
  ]
}

Solución de problemas

• El panel no responde: Cambia directamente a ese panel o inspecciónalo con ` tmux capture-pane -pt :0`..
• Conflictos de fusión: utiliza git worktrees para aislar los cambios en los archivos por panel.
• Alto consumo de tokens: Reduce el número de paneles en paralelo. Cada panel es una sesión completa del agente.
• No se encuentra tmux: Instálalo con `brew install tmux ` (macOS) o `apt install tmux ` (Linux).