Parallel Agent Orchestration
병렬 에이전트 실행 및 결과 집계 워크플로우입니다.
Quick Start
# 병렬 개발 에이전트 실행
python .claude/skills/parallel-agent-orchestration/scripts/run_parallel.py \
--agents "architect,coder,tester" \
--task "새 기능 구현"
# 병렬 테스트 에이전트 실행
python scripts/run_parallel.py \
--agents "unit,integration,e2e,security" \
--task "전체 테스트 실행"
Fan-Out/Fan-In 패턴
┌─────────────┐
│ Supervisor │ ← Task 분해
└──────┬──────┘
│
┌───┼───┐ ← Fan-Out
↓ ↓ ↓
[A1] [A2] [A3] ← 병렬 실행
│ │ │
└───┼───┘ ← Fan-In
↓
┌─────────────┐
│ Aggregator │ ← 결과 종합
└─────────────┘
에이전트 그룹
개발 그룹 (dev)
| 에이전트 |
역할 |
| architect |
설계 및 구조 |
| coder |
구현 |
| tester |
테스트 작성 |
| docs |
문서화 |
테스트 그룹 (test)
| 에이전트 |
역할 |
| unit |
단위 테스트 |
| integration |
통합 테스트 |
| e2e |
E2E 테스트 |
| security |
보안 테스트 |
리뷰 그룹 (review)
| 에이전트 |
역할 |
| code-reviewer |
코드 리뷰 |
| security-auditor |
보안 리뷰 |
| architect-reviewer |
아키텍처 리뷰 |
실행 옵션
# 그룹 단위 실행
python scripts/run_parallel.py --group dev --task "기능 구현"
# 개별 에이전트 지정
python scripts/run_parallel.py --agents "coder,tester" --task "빠른 구현"
# 타임아웃 설정
python scripts/run_parallel.py --group test --timeout 300 --task "테스트"
결과 집계
성공 기준
| 그룹 |
성공 조건 |
| dev |
모든 에이전트 완료 |
| test |
모든 테스트 통과 |
| review |
Critical 이슈 없음 |
실패 처리
1회 실패 → 해당 에이전트 재실행
2회 실패 → 에러 로그 분석 → 수정 시도
3회 실패 → ⏸️ 수동 개입
관련 커맨드
| 커맨드 |
그룹 |
/parallel-dev |
dev |
/parallel-test |
test |
/parallel-review |
review |
참조: CLAUDE.md 섹션 4 Agents
majiayu000