Fluxos dmux

O que Fluxos 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 várias sessões de agente em paralelo
• Coordenando trabalho entre Claude Code, Codex e outras plataformas
• Tarefas complexas que se beneficiam do paralelismo 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 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

Padrões de Fluxo de Trabalho

Padrão 1: Pesquisar + Implementar

Divide pesquisa e implementação em trilhas paralelas:

Painel 1 (Pesquisa): "Pesquise as melhores práticas para limitação de taxa em Node.js.
  Verifique as bibliotecas atuais, compare abordagens e escreva as descobertas em
  /tmp/rate-limit-research.md"

Painel 2 (Implementação): "Implemente o middleware de limitação de taxa 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 as descobertas no contexto do Painel 2

Padrão 2: Recurso Multi-Arquivo

Paralelize o trabalho em arquivos independentes:

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

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

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

Execute testes em um painel, corrija em outro:

Painel 1 (Observador): "Execute o conjunto 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: Multi-Plataforma

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 de cobertura de teste"

# 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 umas das outras.
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 arquivo, 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 tocam 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 as branches quando concluído
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 grande escala
Ferramenta Task do Claude Code	Inicialização de subagente em processo	Paralelismo programático dentro de uma sessão
Codex multi-agente	Papéis de agente embutidos	Trabalho paralelo específico do Codex

Helper do ECC

O ECC agora inclui um helper 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": "Corrija as skills 1-4 e escreva notas de handoff." },
    { "name": "docs-b", "task": "Corrija as skills 5-8 e escreva notas de handoff." }
  ]
}

O helper:

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

Use seedPaths quando os workers precisarem de acesso a arquivos locais sujos ou não rastreados que ainda não fazem parte de HEAD, como scripts de orquestração local, 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 responde: Mude para o painel diretamente ou inspecione-o com tmux capture-pane -pt <session>:0.<pane-index>.
• Conflitos de merge: Use worktrees git para isolar alterações de arquivo 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).