🤖 Paralelismo real

Para lanzar varios agents, solo tienes que pedírselo a Claude: "Ejecuta estas tres tareas en paralelo usando subagentes". Invocará la herramienta Task varias veces de forma simultánea. El secreto está en formular cada tarea como una instrucción autocontenida.

Execute em paralelo usando subagentes:
1. Rode todos os testes e reporte quais falharam
2. Analise o arquivo src/auth.ts e sugira melhorias de seguranca
3. Atualize o README com as novas funcionalidades
Cada tarefa e independente. Use worktrees se precisar editar arquivos.

La regla de oro: solo paraleliza tareas que no dependen unas de otras. Si la tarea B necesita el resultado de la tarea A, deben ejecutarse en secuencia. Pero si A, B y C son independientes (por ejemplo, pruebas, lint y documentación), se ejecutan todas al mismo tiempo.

Una heurística útil: si puedes explicar cada tarea sin mencionar las demás, son independientes. Si tienes que decir "después de que termine X", hay una dependencia y debe ser secuencial.

Claude Code puede usar el comando git worktree add para crear espacios de trabajo aislados. Cada worktree es una copia del repositorio con su propia branch, donde el subagente edita libremente sin interferir con los demás.

# Criar worktree para um subagente
git worktree add .claude/worktrees/agent-testes -b agent/testes

# Listar worktrees ativos
git worktree list

# Remover apos o merge
git worktree remove .claude/worktrees/agent-testes

Algunas tareas llevan tiempo: ejecutar una suite de pruebas completa, hacer un build o analizar un codebase grande. En lugar de quedarse esperando, el agente principal lanza la tarea en segundo plano y sigue trabajando. Cuando el resultado está listo, lo incorpora. Esto es especialmente útil con el run_in_background de la herramienta Bash.

Cuando todos los subagentes terminan, el agente principal recibe los resultados textuales de cada uno. Le corresponde al agente principal sintetizarlos: combinar los hallazgos, resolver los conflictos si los hay y producir el resultado final. Piensa en él como un gerente que recibe informes del equipo y prepara el informe consolidado.

Cuando falla un subagente, el agente principal tiene tres opciones: retry (volver a intentarlo con un prompt ajustado), skip (ignorar y seguir con los que funcionaron) o abort (detener todo). La estrategia depende de la criticidad de la tarea. ¿Fallan las pruebas? Vuelve a intentarlo con más contexto. ¿La documentación está desactualizada? Omítela por ahora. ¿Es un error de seguridad? Aborta e investiga.