parallel-agents

同时调度多个子代理执行独立任务。当面临 2 个以上不相关的任务时使用，这些任务可以在没有共享状态或顺序依赖关系的情况下继续进行。通过并行工作最大化吞吐量。

## 概述（中文）

同时调度多个子代理执行独立任务。当面临 2 个以上不相关的任务时使用，这些任务可以在没有共享状态或顺序依赖关系的情况下继续进行。通过并行工作最大化吞吐量。

## 原文

# Parallel Agent Dispatch

독립적인 작업들을 병렬 서브에이전트로 동시 처리.

## 언제 사용

```
여러 작업? → 독립적? → 공유 상태 없음? → 병렬 디스패치!
```

**사용:**
- 3+ 테스트 파일이 다른 원인으로 실패
- 여러 서브시스템이 독립적으로 고장
- 각 문제가 다른 문제의 맥락 없이 이해 가능
- 리서치 + 구현 + 테스트 등 다른 종류의 작업

**금지:**
- 실패가 서로 관련 (하나 고치면 다른 것도 해결될 수 있음)
- 전체 시스템 상태 이해 필요
- 에이전트끼리 같은 파일 편집해야 함
- 탐색적 디버깅 (뭐가 문제인지도 모를 때)

## 패턴

### 1. 독립 도메인 식별
작업을 도메인별로 그룹화:
- 작업 A: UI 버그 수정
- 작업 B: API 성능 최적화
- 작업 C: 테스트 작성

각 도메인이 독립적인지 확인.

### 2. 집중된 프롬프트 작성

좋은 프롬프트:
- **특정 범위:** 하나의 명확한 문제
- **자체 완결:** 필요한 모든 맥락 포함
- **출력 명시:** 에이전트가 뭘 반환해야 하는지

```
❌ "모든 테스트 고쳐" — 범위 너무 넓음
✅ "src/game/physics.test.ts의 3개 실패 테스트 수정" — 집중됨

❌ "레이스 컨디션 고쳐" — 맥락 없음
✅ "에러 메시지 + 테스트 이름 + 스택 트레이스 포함" — 맥락 충분

❌ "고쳐" — 출력 불명
✅ "근본 원인 요약 + 변경 사항 반환" — 출력 명시
```

### 3. Clawdbot에서 디스패치

```
# sessions_spawn으로 병렬 서브에이전트 생성
서브에이전트 1: "physics.test.ts의 충돌 감지 버그 수정"
서브에이전트 2: "render pipeline 성능 최적화"
서브에이전트 3: "새 게임 레벨 에셋 생성" (MiniPC)
```

### 4. 결과 통합

에이전트 반환 시:
1. **각 요약 검토** — 변경 사항 이해
2. **충돌 확인** — 같은 코드 편집했는지?
3. **전체 테스트** — 모든 수정이 함께 작동하는지
4. **스팟 체크** — 서브에이전트도 실수할 수 있음

## 흔한 실수

| 실수 | 교정 |
|------|------|
| 너무 넓은 범위 | 1 에이전트 = 1 도메인 |
| 맥락 부족 | 에러 메시지, 파일 경로 포함 |
| 제약 없음 | "프로덕션 코드 변경 금지" 등 |
| 출력 불명확 | "근본 원인 + 변경 사항 요약" 명시 |

## 시간 절약 효과

3개 문제를 순차 처리 = 3T 시간
3개 문제를 병렬 처리 = ~1T 시간

독립 도메인이 많을수록 이득이 크다.