parallel-agent-orchestration
병렬 에이전트 오케스트레이션. Fan-Out/Fan-In 패턴으로 다중 에이전트 실행.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
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
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!