Fluxos de Trabalho dmux

O que Fluxos de Trabalho dmux faz?

Orquestre sessões paralelas de agentes de IA usando dmux, um gerenciador de painéis tmux para plataformas de agentes.

Quando Ativar

• Executando múltiplas sessões de agente em paralelo
• Coordenando trabalho entre Claude Code, Codex e outras plataformas
• Tarefas complexas que se beneficiam do paralelismo de dividir para conquistar
• O usuário diz "execute em paralelo", "divida este trabalho", "use dmux" ou "multi-agente"

O que é dmux

dmux é uma ferramenta de orquestração baseada em tmux que gerencia painéis de agentes de IA:

• Pressione n para criar um novo painel com um prompt
• Pressione m para mesclar a saída do painel de volta à sessão principal
• Suporta: Claude Code, Codex, OpenCode, Cline, Gemini, Qwen

Instalação: Instale o dmux a partir de seu repositório após revisar o pacote. Veja github.com/standardagents/dmux

Início Rápido

# Iniciar sessão dmux
dmux

# Criar painéis de agente (pressione 'n' no dmux, depois digite o prompt)
# Painel 1: "Implemente o middleware de autenticação em src/auth/"
# Painel 2: "Escreva testes para o serviço de usuário"
# Painel 3: "Atualize a documentação da API"

# Cada painel executa sua própria sessão de agente
# Pressione 'm' para mesclar os resultados de volta

Padrões de Fluxo de Trabalho

Padrão 1: Pesquisa + Implementação

Divida pesquisa e implementação em trilhas paralelas:

Painel 1 (Pesquisa): "Pesquise as melhores práticas para rate limiting em Node.js.
  Verifique as bibliotecas atuais, compare abordagens e escreva os resultados em
  /tmp/rate-limit-research.md"

Painel 2 (Implementação): "Implemente o middleware de rate limiting para nossa API Express.
  Comece com um token bucket básico, refinaremos após a pesquisa ser concluída."

# Após o Painel 1 concluir, mescle os resultados no contexto do Painel 2

Padrão 2: Recurso Multi-Arquivo

Paralelize o trabalho em arquivos independentes:

Painel 1: "Crie o esquema de banco de dados e as migrações para o recurso de cobrança"
Painel 2: "Construa os endpoints da API de cobrança em src/api/billing/"
Painel 3: "Crie os componentes de UI do dashboard de cobrança"

# Mescle tudo, depois faça a integração no painel principal

Padrão 3: Loop de Teste + Correção

Execute testes em um painel, corrija em outro:

Painel 1 (Observador): "Execute a suíte de testes em modo de observação. Quando os testes falharem,
  resuma as falhas."

Painel 2 (Corretor): "Corrija os testes com falha com base na saída de erro do painel 1"

Padrão 4: Entre Plataformas

Use diferentes ferramentas de IA para diferentes tarefas:

Painel 1 (Claude Code): "Revise a segurança do módulo de autenticação"
Painel 2 (Codex): "Refatore as funções utilitárias para desempenho"
Painel 3 (Claude Code): "Escreva testes E2E para o fluxo de checkout"

Padrão 5: Pipeline de Revisão de Código

Perspectivas de revisão paralelas:

Painel 1: "Revise src/api/ em busca de vulnerabilidades de segurança"
Painel 2: "Revise src/api/ em busca de problemas de desempenho"
Painel 3: "Revise src/api/ em busca de lacunas na cobertura de testes"

# Mescle todas as revisões em um único relatório

Melhores Práticas

1. Apenas tarefas independentes. Não paralelize tarefas que dependem da saída uma da outra.
2. Limites claros. Cada painel deve trabalhar em arquivos ou preocupações distintas.
3. Mescle estrategicamente. Revise a saída do painel antes de mesclar para evitar conflitos.
4. Use git worktrees. Para trabalho propenso a conflitos de arquivos, use worktrees separados por painel.
5. Consciência de recursos. Cada painel usa tokens de API — mantenha o total de painéis abaixo de 5-6.

Integração com Git Worktree

Para tarefas que afetam arquivos sobrepostos:

# Crie worktrees para isolamento
git worktree add -b feat/auth ../feature-auth HEAD
git worktree add -b feat/billing ../feature-billing HEAD

# Execute agentes em worktrees separados
# Painel 1: cd ../feature-auth && claude
# Painel 2: cd ../feature-billing && claude

# Mescle os branches quando terminar
git merge feat/auth
git merge feat/billing

Ferramentas Complementares

Ferramenta	O que faz	Quando usar
dmux	Gerenciamento de painéis tmux para agentes	Sessões paralelas de agentes
Superset	IDE de terminal para 10+ agentes paralelos	Orquestração em larga escala
Ferramenta de Tarefa Claude Code	Spawn de subagentes em processo	Paralelismo programático dentro de uma sessão
Codex multi-agente	Funções de agente integradas	Trabalho paralelo específico do Codex

Ajudante ECC

O ECC agora inclui um ajudante para orquestração externa de painéis tmux com worktrees git separados:

node scripts/orchestrate-worktrees.js plan.json --execute

Exemplo de plan.json:

{
  "sessionName": "skill-audit",
  "baseRef": "HEAD",
  "launcherCommand": "codex exec --cwd {worktree_path} --task-file {task_file}",
  "workers": [
    { "name": "docs-a", "task": "Corriga habilidades 1-4 e escreva notas de passagem." },
    { "name": "docs-b", "task": "Corriga habilidades 5-8 e escreva notas de passagem." }
  ]
}

O ajudante:

• Cria um worktree git vinculado a um branch para cada trabalhador
• Opcionalmente sobrepõe seedPaths selecionados do checkout principal no worktree de cada trabalhador
• Escreve arquivos task.md, handoff.md e status.md por trabalhador sob .orchestration/<session>/
• Inicia uma sessão tmux com um painel por trabalhador
• Lança cada comando de trabalhador em seu próprio painel
• Deixa o painel principal livre para o orquestrador

Use seedPaths quando os trabalhadores precisarem de acesso a arquivos locais sujos ou não rastreados que ainda não fazem parte de HEAD, como scripts de orquestração locais, rascunhos de planos ou documentos:

{
  "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": "Verifique se os arquivos semeados estão presentes antes de iniciar o trabalho." }
  ]
}

Solução de Problemas

• Painel não respondendo: Mude para o painel diretamente ou inspecione-o com tmux capture-pane -pt <session>:0.<pane-index>.
• Conflitos de merge: Use git worktrees para isolar alterações de arquivos por painel.
• Alto uso de tokens: Reduza o número de painéis paralelos. Cada painel é uma sessão completa de agente.
• tmux não encontrado: Instale com brew install tmux (macOS) ou apt install tmux (Linux).