Fluxos de Trabalho do dmux

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

Quando Ativar

• Executando várias sessões de agentes em paralelo
• Coordenando trabalho entre Claude Code, Codex e outros "harnesses"
• Tarefas complexas que se beneficiam de paralelismo "dividir para conquistar"
• O usuário diz "executar em paralelo", "dividir este trabalho", "usar 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 para a sessão principal
• Suporta: Claude Code, Codex, OpenCode, Cline, Gemini, Qwen

Instalar: Instale o dmux de seu repositório após revisar o pacote. Veja github.com/standardagents/dmux

Início Rápido

# Start dmux session
dmux

# Create agent panes (press 'n' in dmux, then type prompt)
# Pane 1: "Implement the auth middleware in src/auth/"
# Pane 2: "Write tests for the user service"
# Pane 3: "Update API documentation"

# Each pane runs its own agent session
# Press 'm' to merge results back

Padrões de Fluxo de Trabalho

Padrão 1: Pesquisa + Implementação

Divida pesquisa e implementação em trilhas paralelas:

Pane 1 (Research): "Research best practices for rate limiting in Node.js.
  Check current libraries, compare approaches, and write findings to
  /tmp/rate-limit-research.md"

Pane 2 (Implement): "Implement rate limiting middleware for our Express API.
  Start with a basic token bucket, we'll refine after research completes."

# After Pane 1 completes, merge findings into Pane 2's context

Padrão 2: Funcionalidade Multi-Arquivo

Paralelize o trabalho em arquivos independentes:

Pane 1: "Create the database schema and migrations for the billing feature"
Pane 2: "Build the billing API endpoints in src/api/billing/"
Pane 3: "Create the billing dashboard UI components"

# Merge all, then do integration in main pane

Padrão 3: Loop Testar + Corrigir

Execute testes em um painel, corrija em outro:

Pane 1 (Watcher): "Run the test suite in watch mode. When tests fail,
  summarize the failures."

Pane 2 (Fixer): "Fix failing tests based on the error output from pane 1"

Padrão 4: Cross-Harness

Use diferentes ferramentas de IA para diferentes tarefas:

Pane 1 (Claude Code): "Review the security of the auth module"
Pane 2 (Codex): "Refactor the utility functions for performance"
Pane 3 (Claude Code): "Write E2E tests for the checkout flow"

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

Perspectivas de revisão paralelas:

Pane 1: "Review src/api/ for security vulnerabilities"
Pane 2: "Review src/api/ for performance issues"
Pane 3: "Review src/api/ for test coverage gaps"

# Merge all reviews into a single report

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 worktrees do git. Para trabalhos propensos a conflitos de arquivos, use worktrees separadas 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:

# Create worktrees for isolation
git worktree add -b feat/auth ../feature-auth HEAD
git worktree add -b feat/billing ../feature-billing HEAD

# Run agents in separate worktrees
# Pane 1: cd ../feature-auth && claude
# Pane 2: cd ../feature-billing && claude

# Merge branches when done
git merge feat/auth
git merge feat/billing

Ferramentas Complementares

Auxiliar ECC

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

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

Exemplo plan.json:

{
  "sessionName": "skill-audit",
  "baseRef": "HEAD",
  "launcherCommand": "codex exec --cwd {worktree_path} --task-file {task_file}",
  "workers": [
    { "name": "docs-a", "task": "Fix skills 1-4 and write handoff notes." },