orchestrator · diff
git:20260805.aaf3b8c to git:20260812.afc9950
15 added, 23 removed. Audit A to A.
---
name: orchestrator
description: PM-Worker 패턴의 Multi-AI 오케스트레이션 (MCP 기반). 네이티브 멀티에이전트의 폴백 + 정책 레이어 (hard file lock, 외부 태스크 보드, 크로스-CLI 혼합). /daedalus --mcp로 실행. 일반 프로젝트는 네이티브 모드 권장.
- triggers:
- - "workpm"
- - "daedalus"
- - "다이달로스"
- - "pmworker"
- - "orchestrator"
- - "workpm-mcp"
- - "daedalus-mcp"
- - "daedalus --mcp"
- - "multi ai"
- - "멀티 에이전트"
- - "병렬 ai"
- auto_apply: false
---
# Orchestrator - Multi-AI 병렬 작업 시스템 (MCP 대규모 모드)
PM (Project Manager)이 태스크를 분배하고, Worker들이 병렬로 수행합니다.
> **참고:** 일반 프로젝트는 `/daedalus` (네이티브 모드)를 권장합니다.
> 이 MCP 모드는 대규모(섹션 10+), 크로스-CLI 혼합, 장시간 작업에 적합합니다.
> `/daedalus --mcp`로 진입합니다.
**네이티브 vs MCP 선택 기준:**
| 상황 | 진입점 | 이유 |
|------|--------|------|
- | 일반 프로젝트 (섹션 10개 미만) | `/daedalus` (네이티브) | 4-CLI 전부 네이티브 멀티에이전트 보유 (Claude=Agent Teams, Codex=spawn_agent, Gemini=서브에이전트, Grok=spawn_subagent) — 설치 불필요 |
+ | 일반 프로젝트 (섹션 10개 미만) | `/daedalus` (네이티브) | 4-CLI의 내장 탐색자·작업자 사용. Claude Agent Teams는 사용자가 실험 기능을 켠 경우에만 사용 |
| 대규모(섹션 10+) / 장시간 / 크로스-CLI 혼합 | `/daedalus --mcp` (이 모드) | 태스크 보드가 외부 저장돼 세션 한도와 무관 |
| 구버전 CLI (네이티브 멀티에이전트 도구 없음) | `/daedalus --mcp` | 유일한 병렬 경로 (폴백) |
| 파일 잠금(hard lock)이 필요한 병렬 수정 | `/daedalus --mcp` | `orchestrator_lock_file` — 네이티브 팀은 소유권 규칙(soft)뿐 |
## 설치
```bash
- node skills/orchestrator/install.js # 설치
- node skills/orchestrator/install.js --uninstall # 제거
+ # 위 모듈 해석 계약으로 이 source-only 스킬의 MODULE_ROOT를 먼저 확정한다.
+ node "$MODULE_ROOT/install.js" <대상-프로젝트-경로> # 프로젝트 설치
+ node "$MODULE_ROOT/install.js" <대상-프로젝트-경로> --uninstall # 프로젝트 제거
```
+ MCP 실행 파일은 활성 스킬 레지스트리가 아니라
+ `~/.claude/.olympus/runtime-modules/orchestrator/`의 비노출 런타임 미러를
+ 우선 사용합니다. 전체 Olympus 설치에서는 이 미러와 의존성을 자동 관리합니다.
+
---
## 포함 파일
```
orchestrator/
├── SKILL.md # 이 파일
├── install.js # 설치 스크립트
├── mcp-server/ # Orchestrator MCP 서버
│ ├── src/
│ ├── scripts/ # Worker spawn 스크립트 (ps1, sh)
│ └── package.json
├── commands/
- │ ├── workpm.md # PM 명령어 (Claude Agent Teams 모드)
+ │ ├── workpm.md # 공통 5단계 PM 계약 + CLI별 네이티브 역할
│ ├── workpm-mcp.md # PM 명령어 (MCP 전용, 모든 CLI)
│ └── pmworker.md # Worker 명령어 (모든 CLI)
└── docs/
└── orchestrator-guide.md # 상세 가이드
```
---
## 사용법
### CLI별 진입점
| CLI | 권장 엔트리포인트 | 실제 동작 |
|-----|-------------------|-------------|
- | **Claude** | `workpm` | Agent Teams 활용, 실시간 팀원 통신 |
- | **Codex** | `workpm` | Native spawn_agent (명시적 MCP는 `workpm-mcp`) |
- | **Gemini** | `workpm` | Native 서브에이전트 (미실측 — 인식 실패 시 `workpm-mcp` 폴백) |
- | **Grok** | `workpm` | Native spawn_subagent |
+ | **Claude** | `workpm` | 내장 subagent; 실험 Agent Teams가 활성화되면 named teammate |
+ | **Codex** | `workpm` | 내장 `explorer`/`worker`/`default` |
+ | **Gemini** | `workpm` | 내장 `codebase_investigator`/`generalist` |
+ | **Grok** | `workpm` | 내장 `explore`/`general-purpose` |
- `workpm`: 통합 PM 엔트리포인트. 각 CLI의 네이티브 멀티에이전트로 실행, 네이티브 부재 시 `workpm-mcp`로 폴백
- `workpm-mcp`: 명시적 MCP-only PM 엔트리포인트. 모든 CLI에서 동작
### Worker 모드 (모든 CLI 공통)
```
pmworker
```
- 통합 Worker 엔트리포인트
- 가용 태스크 확인 및 수행
- 파일 락 및 완료 보고
- MCP 도구만 사용하므로 Claude/Codex/Gemini 모두 동작
---
## 핵심 3원칙
| 원칙 | 설명 |
|------|------|
- | **작업 외주화** | 리더는 코딩하지 않는다. 전략만 |
+ | **조건부 외주화** | 독립 작업자와 병렬 이득이 있을 때 리더는 조율에 집중. 작업자가 없으면 같은 계약을 메인 컨텍스트에서 순차 실행 |
| **기억 외부화** | 중요 결정은 activity log에 즉시 기록 |
| **계속 해고** | 작업 끝난 팀원은 교체. 깨끗한 컨텍스트 유지 |
---
## 워크플로우
```
- /workpm (Agent Teams 모드 — 5단계):
+ /workpm (네이티브 역할 모드 — 5단계):
Phase 1: 리서치 & 제안 — 팀원 4명 병렬 리서치 → 3가지 제안서 → 사용자 승인
Phase 2: 프로세스 도면 확보 — flow-diagrams 검증/생성
Phase 3: 영향도 분석 — 기존 코드 있을 때만 (신규면 건너뜀)
Phase 4: 구현 & 검증 — 새 팀원 4명 → 코드리뷰 → 자재검사
Phase 5: 공정 점검 — 도면 vs 코드 대조
/workpm-mcp (MCP 전용 — 4단계, 영향도 분석 없음):
Phase 1: 리서치 & 제안
Phase 2: 프로세스 도면 확보
Phase 3: 구현 & 검증
Phase 4: 공정 점검
```
---
## 명령어 요약
### PM 전용
| 명령어 | 설명 |
|--------|------|
| `orchestrator_detect_providers()` | AI CLI 감지 |
| `orchestrator_create_task({...})` | 태스크 생성 |
| `orchestrator_get_progress()` | 진행 상황 |
| `orchestrator_log_activity({...})` | 결정/진행 기록 |
| `orchestrator_get_activity_log({...})` | 활동 로그 조회 |
### Worker 전용
| 명령어 | 설명 |
|--------|------|
| `orchestrator_get_available_tasks()` | 가용 태스크 확인 |
| `orchestrator_claim_task({task_id})` | 태스크 담당 |
| `orchestrator_lock_file({path})` | 파일/폴더 락 |
| `orchestrator_complete_task({task_id, result})` | 완료 보고 |
| `orchestrator_fail_task({task_id, error})` | 실패 보고 |
---
## 상세 가이드
[docs/orchestrator-guide.md](docs/orchestrator-guide.md) 참조
---
## 다음 단계 안내
모든 Worker 태스크가 완료되면 사용자에게 다음 단계를 안내합니다:
```
✅ 오케스트레이터 구현 완료!
📊 결과: {완료 태스크 수}/{전체 태스크 수}
👉 다음 단계 (선택):
/minos → Playwright 자동 테스트 + Healer 루프
/review → 코드 리뷰 (품질/보안/성능)
/commit → 변경사항 커밋
📎 참고: docs/workflow-guide.md
```