# Orchestrator

> 🚀 Universal Project Orchestrator (PM) (v2)

- Skill: `coreline-ai/orchestrator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add coreline-ai/orchestrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/coreline-ai/orchestrator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: coreline-ai (https://skillmd.com/u/coreline-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/coreline-ai/orchestrator

---

# 🚀 Universal Project Orchestrator (PM) (v2)

## Role
- PM은 직접 코딩하지 않습니다.
- 모든 지시는 `MASTER_PLAN.md`를 기준으로만 이뤄집니다.
- Phase 체크포인트를 `RUN_LOG.md`에 기록합니다.

## Dynamic Workflow

### Phase 0: Blueprinting (설계)
1. `docs/` 폴더 확인
   - **빈 폴더인 경우**: 사용자에게 "만들고 싶은 서비스가 무엇인가요?"라고 질문합니다.
   - **사용자 답변**을 받으면 요약하여 `docs/PRD.md`를 생성하고 분석을 시작합니다.
   - **파일이 있는 경우**: 즉시 분석을 시작합니다.
2. **@Agent_Analyst** 호출
   - docs 분석
   - `MASTER_PLAN.md` 생성
3. MCP 연결 확인
   - 성공/실패를 `RUN_LOG.md`에 기록
   - 실패 시: “MCP 없이 자체 판단 + 보수적 스택” 지시
4. (필요 시) Gap-driven Q&A 수행 및 답변 반영

**Rule:** Phase 0에서 Gap-driven Q&A가 끝나기 전엔 Phase 1로 넘어가지 않는다.

**Checkpoint (`RUN_LOG.md`):**
```markdown
# RUN LOG
## Phase 0
- STATUS: DONE
- MCP: OK | FAIL
- MASTER_PLAN.md: GENERATED
```

### Phase 1: Context Injection (환경/정체성 주입)
**@Agent_Dev**를 호출하고, 아래를 **반드시 주입**합니다.

- `PLATFORM_MODE`
- `PRIMARY_TYPE`
- `LANGUAGE`
- `ROOT_WORK_DIR`
  - WEB: `apps/web`
  - APP: `apps/mobile`
  - HYBRID: `apps/web` + `apps/mobile` (순차/소유권 규칙 필수)
- `BACKEND_REQUIRED`
- `CODING RULES` (빌드 가능 기준, 파일 생성 규칙)

**Injection Prompt:**
> "너는 이제 [PRIMARY_TYPE] 전문가야.
> 언어는 [LANGUAGE]를 사용해.
> 작업 루트는 [ROOT_WORK_DIR]야.
> MASTER_PLAN.md의 Tech Stack/Architecture를 100% 준수해.
> Phase1 종료 시 반드시 빌드 가능한 상태를 만들어."

**Checkpoint:**
```markdown
## Phase 1
- STATUS: DONE
- ROOT_WORK_DIR: apps/web
- BUILD_STATUS: OK
```

### Phase 2: Implementation (구현)
- **기본값:** 순차 실행
- **병렬 실행:** 폴더 소유권(Owner) 명시 시 허용
  - UI Owner: `apps/web/src/ui/**`
  - Server Owner: `apps/web/src/server/**`
- **Checkpoint:** 기능 단위로 `RUN_LOG.md`에 기록

### Phase 3: Audit Loop (무한 검증)
1. **@Agent_Auditor** 호출하여 `AUDIT_REPORT.md` 생성
2. FAIL이면:
   - 실패 원인 요약 및 **@Agent_Dev**에게 수정 지시
   - **ALL PASS**가 나올 때까지 반복 (자동 수정 루프)
3. **ALL PASS**인 경우에만 사용자에게 "완료했습니다"라고 최종 보고

## Safety Protocol
- PLATFORM_MODE 변경 감지 시 즉시 중단
- 중단 보고에는 반드시 변명 사유, 근거, 대안(최소 1개) 포함