# Dispatching Parallel Agents

> Úsalo cuando enfrentes 2 o más tareas independientes que puedan trabajarse sin estado compartido ni dependencias secuenciales.

Fuente: https://skillsagentes.com/skills/obra/superpowers/dispatching-parallel-agents
Markdown: https://skillsagentes.com/skills/obra/superpowers/dispatching-parallel-agents.md

Repositorio: https://github.com/obra/superpowers
Autor: obra
Licencia: MIT
Actualizado: hace 2 meses
Coste de contexto: 27 tok instalada, 1.5k tok al activarse, 1.5k tok con todos los archivos del bundle
Bundle: 1 archivo, 6 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add obra/superpowers --skill dispatching-parallel-agents --agent claude-code
# Cursor
npx -y skills add obra/superpowers --skill dispatching-parallel-agents --agent cursor
# Codex
npx -y skills add obra/superpowers --skill dispatching-parallel-agents --agent codex
# Gemini CLI
npx -y skills add obra/superpowers --skill dispatching-parallel-agents --agent gemini
# Windsurf
npx -y skills add obra/superpowers --skill dispatching-parallel-agents --agent windsurf
# Cline
npx -y skills add obra/superpowers --skill dispatching-parallel-agents --agent cline
```

## Qué hace

- Instruye al agente para delegar tareas independientes a subagentes con contexto aislado en lugar de investigar todo en serie
- Define cómo agrupar fallos en dominios independientes y construir prompts enfocados, autocontenidos y con salida específica
- Especifica que múltiples dispatches en la misma respuesta se ejecutan en paralelo, uno por respuesta se ejecuta en secuencia

## Cuándo usarla

- 3 o más archivos de test fallando con causas raíz distintas
- Múltiples subsistemas rotos de forma independiente
- Cada problema puede entenderse sin contexto de los demás
- No hay estado compartido entre las investigaciones

## Cuándo no

- Los fallos están relacionados y arreglar uno podría arreglar otros
- Se necesita entender el estado completo del sistema
- Los agentes interferirían entre sí (editando los mismos archivos o recursos)

## Qué la activa

- "Tengo 6 tests fallando en 3 archivos distintos tras un refactor, ¿puedes arreglarlos en paralelo?"
- "Despacha un agente por cada archivo de test que falla de forma independiente"
- "Investiga y arregla estos tres subsistemas rotos a la vez"

## Archivos

- SKILL.md — 6 KB

## SKILL.md

Reproducido tal cual desde obra/superpowers bajo MIT. Esta sección es el documento original y está en inglés.

# Dispatching Parallel Agents

## Overview

You delegate tasks to specialized agents with isolated context. By precisely crafting their instructions and context, you ensure they stay focused and succeed at their task. They should never inherit your session's context or history — you construct exactly what they need. This also preserves your own context for coordination work.

When you have multiple unrelated failures (different test files, different subsystems, different bugs), investigating them sequentially wastes time. Each investigation is independent and can happen in parallel.

**Core principle:** Dispatch one agent per independent problem domain. Let them work concurrently.

## When to Use

```dot
digraph when_to_use {
    "Multiple failures?" [shape=diamond];
    "Are they independent?" [shape=diamond];
    "Single agent investigates all" [shape=box];
    "One agent per problem domain" [shape=box];
    "Can they work in parallel?" [shape=diamond];
    "Sequential agents" [shape=box];
    "Parallel dispatch" [shape=box];

    "Multiple failures?" -> "Are they independent?" [label="yes"];
    "Are they independent?" -> "Single agent investigates all" [label="no - related"];
    "Are they independent?" -> "Can they work in parallel?" [label="yes"];
    "Can they work in parallel?" -> "Parallel dispatch" [label="yes"];
    "Can they work in parallel?" -> "Sequential agents" [label="no - shared state"];
}
```

**Use when:**
- 3+ test files failing with different root causes
- Multiple subsystems broken independently
- Each problem can be understood without context from others
- No shared state between investigations

**Don't use when:**
- Failures are related (fix one might fix others)
- Need to understand full system state
- Agents would interfere with each other

## The Pattern

### 1. Identify Independent Domains

Group failures by what's broken:
- File A tests: Tool approval flow
- File B tests: Batch completion behavior
- File C tests: Abort functionality

Each domain is independent - fixing tool approval doesn't affect abort tests.

### 2. Create Focused Agent Tasks

Each agent gets:
- **Specific scope:** One test file or subsystem
- **Clear goal:** Make these tests pass
- **Constraints:** Don't change other code
- **Expected output:** Summary of what you found and fixed

### 3. Dispatch in Parallel

Issue all three subagent dispatches in the same response — they run in parallel:

```text
Subagent (general-purpose): "Fix agent-tool-abort.test.ts failures"
Subagent (general-purpose): "Fix batch-completion-behavior.test.ts failures"
Subagent (general-purpose): "Fix tool-approval-race-conditions.test.ts failures"
# All three run concurrently.
```

Multiple dispatch calls in one response = parallel execution. One per response = sequential.

### 4. Review and Integrate

When agents return:
- Read each summary
- Verify fixes don't conflict
- Run full test suite
- Integrate all changes

## Agent Prompt Structure

Good agent prompts are:
1. **Focused** - One clear problem domain
2. **Self-contained** - All context needed to understand the problem
3. **Specific about output** - What should the agent return?

```markdown
Fix the 3 failing tests in src/agents/agent-tool-abort.test.ts:

1. "should abort tool with partial output capture" - expects 'interrupted at' in message
2. "should handle mixed completed and aborted tools" - fast tool aborted instead of completed
3. "should properly track pendingToolCount" - expects 3 results but gets 0

These are timing/race condition issues. Your task:

1. Read the test file and understand what each test verifies
2. Identify root cause - timing issues or actual bugs?
3. Fix by:
   - Replacing arbitrary timeouts with event-based waiting
   - Fixing bugs in abort implementation if found
   - Adjusting test expectations if testing changed behavior

Do NOT just increase timeouts - find the real issue.

Return: Summary of what you found and what you fixed.
```

## Common Mistakes

**❌ Too broad:** "Fix all the tests" - agent gets lost
**✅ Specific:** "Fix agent-tool-abort.test.ts" - focused scope

**❌ No context:** "Fix the race condition" - agent doesn't know where
**✅ Context:** Paste the error messages and test names

**❌ No constraints:** Agent might refactor everything
**✅ Constraints:** "Do NOT change production code" or "Fix tests only"

**❌ Vague output:** "Fix it" - you don't know what changed
**✅ Specific:** "Return summary of root cause and changes"

## When NOT to Use

**Related failures:** Fixing one might fix others - investigate together first
**Need full context:** Understanding requires seeing entire system
**Exploratory debugging:** You don't know what's broken yet
**Shared state:** Agents would interfere (editing same files, using same resources)

## Real Example from Session

**Scenario:** 6 test failures across 3 files after major refactoring

**Failures:**
- agent-tool-abort.test.ts: 3 failures (timing issues)
- batch-completion-behavior.test.ts: 2 failures (tools not executing)
- tool-approval-race-conditions.test.ts: 1 failure (execution count = 0)

**Decision:** Independent domains - abort logic separate from batch completion separate from race conditions

**Dispatch:**
```
Agent 1 → Fix agent-tool-abort.test.ts
Agent 2 → Fix batch-completion-behavior.test.ts
Agent 3 → Fix tool-approval-race-conditions.test.ts
```

**Results:**
- Agent 1: Replaced timeouts with event-based waiting
- Agent 2: Fixed event structure bug (threadId in wrong place)
- Agent 3: Added wait for async tool execution to complete

**Integration:** All fixes independent, no conflicts, full suite green

## Verification

After agents return:
1. **Review each summary** - Understand what changed
2. **Check for conflicts** - Did agents edit same code?
3. **Run full suite** - Verify all fixes work together
4. **Spot check** - Agents can make systematic errors

## Dónde encaja

- Categoría: [Automatización](https://skillsagentes.com/categorias/automatizacion.md) — Flujos de varios pasos que se ejecutan sin supervisión.
- Creador: [obra](https://skillsagentes.com/creators/obra.md) — 14 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Subagent Driven Development](https://skillsagentes.com/skills/obra/superpowers/subagent-driven-development.md): Úsalo al ejecutar planes de implementación con tareas independientes dentro de la sesión actual.
- [Brainstorming](https://skillsagentes.com/skills/obra/superpowers/brainstorming.md): Debes usarlo antes de cualquier trabajo creativo: crear features, construir componentes, añadir funcionalidad o modificar comportamiento. Explora la intención, requisitos y diseño antes de implementar.
- [Using Superpowers](https://skillsagentes.com/skills/obra/superpowers/using-superpowers.md): Úsala al iniciar cualquier conversación: establece cómo encontrar y usar skills, exigiendo su invocación antes de CUALQUIER respuesta, incluso preguntas aclaratorias.
- [Writing Skills](https://skillsagentes.com/skills/obra/superpowers/writing-skills.md): Úsala al crear nuevas skills, editar skills existentes o verificar que funcionan antes de desplegarlas.
- [Finishing A Development Branch](https://skillsagentes.com/skills/obra/superpowers/finishing-a-development-branch.md): Úsalo cuando la implementación esté completa, todos los tests pasen, y necesites decidir cómo integrar el trabajo.

## Skills relacionadas

- [Using Superpowers](https://skillsagentes.com/skills/obra/superpowers/using-superpowers.md): Úsala al iniciar cualquier conversación: establece cómo encontrar y usar skills, exigiendo su invocación antes de CUALQUIER respuesta, incluso preguntas aclaratorias.
- [Systematic Debugging](https://skillsagentes.com/skills/obra/superpowers/systematic-debugging.md): Úsalo ante cualquier bug, fallo de test o comportamiento inesperado, antes de proponer arreglos.
- [Migrate To Shoehorn](https://skillsagentes.com/skills/mattpocock/skills/migrate-to-shoehorn.md): Migra archivos de test de aserciones de tipo `as` a @total-typescript/shoehorn. Úsalo cuando menciones shoehorn, quieras reemplazar `as` en tests, o necesites datos de test parciales.
- [Browser Testing With Devtools](https://skillsagentes.com/skills/addyosmani/agent-skills/browser-testing-with-devtools.md): Prueba en navegadores reales usando Chrome DevTools MCP. Úsalo al construir o depurar cualquier cosa que corra en un navegador, o para inspeccionar DOM, consola, red o rendimiento.
- [Context Engineering](https://skillsagentes.com/skills/addyosmani/agent-skills/context-engineering.md): Optimiza la configuración del contexto del agente. Úsalo al iniciar una sesión nueva, cuando la calidad del agente empeora, al cambiar de tarea o al configurar archivos de reglas y contexto de un proyecto.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)