| 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 | [object Object] |
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배 속도