dispatching-parallel-agents

name	dispatching-parallel-agents
description	Use when facing 3+ independent failures that can be investigated without shared state or dependencies. Dispatches multiple Claude agents to investigate and fix independent problems concurrently.
allowed-tools	Read, Glob, Grep, Task, Bash
license	MIT
metadata	{"author":"obra/superpowers","version":"1.0"}

Dispatching Parallel Agents

여러 독립적인 문제를 병렬 에이전트로 동시에 해결하는 스킬입니다.

Core Principle

"Dispatch one agent per independent problem domain. Let them work concurrently."

When to Use

✅ 적합한 상황

- 3개 이상의 독립적 실패
- 각 문제가 서로 관련 없음
- 공유 상태 없이 조사 가능
- 서로 다른 파일/서브시스템에서 발생

❌ 피해야 할 상황

- 실패들이 연결되어 있음 (하나 해결 시 다른 것도 해결)
- 전체 시스템 컨텍스트가 필요
- 에이전트들이 공유 리소스에 간섭

Execution Pattern

1. 독립적 문제 도메인 식별

## 실패 분석

| 파일/영역 | 문제 | 독립성 |
|-----------|------|--------|
| auth.test.js | JWT 검증 실패 | ✅ 독립 |
| api.test.js | 라우팅 오류 | ✅ 독립 |
| db.test.js | 연결 타임아웃 | ✅ 독립 |

2. 에이전트 태스크 생성

## Agent 1: Auth Module
Scope: src/auth/, tests/auth/
Goal: JWT 검증 실패 원인 찾기
Constraint: auth 관련 파일만 수정

## Agent 2: API Routes
Scope: src/api/, tests/api/
Goal: 라우팅 오류 해결
Constraint: api 관련 파일만 수정

## Agent 3: Database
Scope: src/db/, tests/db/
Goal: 연결 타임아웃 해결
Constraint: db 관련 파일만 수정

3. 동시 디스패치

Task(Agent 1) || Task(Agent 2) || Task(Agent 3)

4. 결과 통합

## Results

### Agent 1 (Auth)
- 문제: 만료 시간 계산 오류
- 수정: auth/jwt.js:45
- 테스트: ✅ 통과

### Agent 2 (API)
- 문제: 미들웨어 순서
- 수정: api/routes.js:12
- 테스트: ✅ 통과

### Agent 3 (DB)
- 문제: 커넥션 풀 설정
- 수정: db/config.js:8
- 테스트: ✅ 통과

Agent Prompt Template

## Task
[구체적인 문제 설명]

## Scope
- 파일: [제한된 파일 목록]
- 관련 테스트: [테스트 파일]

## Goal
[명확한 목표]

## Constraints
- 다른 영역 코드 수정 금지
- 프로덕션 코드 최소 변경
- 테스트 통과 필수

## Expected Output
1. 근본 원인 분석
2. 수정 내용 요약
3. 테스트 결과

Common Pitfalls

문제	해결책
범위가 너무 넓음	구체적인 파일/디렉토리 지정
컨텍스트 누락	필요한 배경 정보 포함
제약 미정의	"~하지 마세요" 명시
출력 불명확	정확한 deliverable 지정

Demonstrated Results

6개 실패, 3개 파일
→ 3개 병렬 에이전트
→ 동시 완료
→ 충돌 0건
→ 순차 대비 ~3배 속도