Fluxos de trabalho do dmux

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

Quando ativar

• Execução de várias sessões de agentes em paralelo
• Coordenar o trabalho entre o Claude Code, o Codex e outros conjuntos de agentes
• Tarefas complexas que se beneficiam do paralelismo do tipo “dividir para conquistar”
• O usuário diz “executar em paralelo”, “dividir este trabalho”, “usar o dmux” ou “multi-agente”

O que é o dmux

O dmux é uma ferramenta de orquestração baseada no 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
• Compatível com: Claude Code, Codex, OpenCode, Cline, Gemini, Qwen

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

Início rápido

# Inicie a sessão do dmux
dmux

# Crie painéis de agente (pressione 'n' no dmux e, em seguida, 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 a pesquisa e a implementação em trilhas paralelas:

Painel 1 (Pesquisa): “Pesquise as melhores práticas para limitação de taxa no Node.js.
  Verifique as bibliotecas atuais, compare abordagens e registre as conclusões em
  /tmp/rate-limit-research.md”

Painel 2 (Implementação): “Implemente um middleware de limitação de taxa para nossa API Express.
  Comece com um token bucket básico; vamos refinar depois que a pesquisa for concluída.”

# Após a conclusão do Painel 1, mescle as descobertas no contexto do Painel 2

Padrão 2: Recurso de múltiplos arquivos

Paralelize o trabalho entre arquivos independentes:

Painel 1: “Crie o esquema do banco de dados e as migrações para o recurso de faturamento”
Painel 2: “Crie os endpoints da API de faturamento em src/api/billing/”
Painel 3: “Crie os componentes da interface do painel de controle de faturamento”

# Mescle tudo e, em seguida, faça a integração no painel principal

Padrão 3: Ciclo de teste + correção

Execute os testes em um painel, corrija em outro:

Painel 1 (Observador): “Execute o conjunto de testes no 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 erros do painel 1”

Padrão 4: Harness cruzado

Use diferentes ferramentas de IA para diferentes tarefas:

Painel 1 (Claude Code): “Analise a segurança do módulo de autenticação”
Painel 2 (Codex): “Reestruture as funções utilitárias para melhorar o desempenho”
Painel 3 (Claude Code): “Escreva testes E2E para o fluxo de finalização de compra”

Padrão 5: Pipeline de revisão de código

Perspectivas de revisão paralelas:

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

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

Melhores práticas

1. Apenas tarefas independentes. Não paralelize tarefas que dependam do resultado umas das outras.
2. Limites claros. Cada painel deve trabalhar com arquivos ou aspectos distintos.
3. Faça a fusão de forma estratégica. Analise os resultados de cada painel antes da fusão para evitar conflitos.
4. Use git worktrees. Para trabalhos propensos a conflitos de arquivos, use worktrees separadas por painel.
5. Consciência dos recursos. Cada painel usa tokens de API — mantenha o total de painéis abaixo de 5 a 6.

Integração com Git Worktree

Para tarefas que envolvem 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 separadas
# 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

Auxiliar do ECC

O ECC agora inclui um auxiliar para orquestração externa de painéis do tmux com árvores de trabalho do Git separadas:

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": "Corrigir as habilidades 1 a 4 e redigir notas de transferência." },
    { "name": "docs-b", "task": "Corrigir as habilidades 5 a 8 e redigir notas de transferência." }
  ]
}

O auxiliar:

• Cria uma árvore de trabalho do Git baseada em ramificação para cada trabalhador
• Opcionalmente, sobrepõe os seedPaths selecionados do checkout principal em cada árvore de trabalho do trabalhador
• Grava os arquivos task.md, handoff.md e status.md específicos de cada trabalhador na pasta .orchestration//
• Inicia uma sessão do tmux com um painel por trabalhador
• Executa cada comando do trabalhador em seu próprio painel
• Deixa o painel principal livre para o orquestrador

Use seedPaths quando os workers precisarem acessar arquivos locais alterados ou não rastreados que ainda não fazem parte do HEAD, como scripts locais de orquestração, 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": "Verificar se os arquivos inicializados estão presentes antes de iniciar o trabalho." }
  ]
}

Solução de problemas

• Painel não responde: Alterne diretamente para o painel ou inspecione-o com o comando tmux capture-pane -pt :0..
• Conflitos de mesclagem: use git worktrees para isolar as alterações nos arquivos por painel.
• Alto uso de tokens: Reduza o número de painéis paralelos. Cada painel é uma sessão completa do agente.
• tmux não encontrado: Instale com `brew install tmux ` (macOS) ou `apt install tmux ` (Linux).