harness/plugins/pm-pmo/skills/pm-pmo-orchestrator/SKILL.md
DESKTOP-TKLFCPR\ython 009364cc64 feat(pm-pmo): PM·PMO 하네스 플러그인 v1.0.0 신규 (에이전트 7·오케스트레이터·/pmo 커맨드)
- 에이전트 7인: pm-planner(계획/WBS/M-M)·pm-risk-manager(리스크/이슈/CR)·
  pm-reporter(주간/월간/EVM)·pm-auditor(감리 대응: 점검항목 매핑·모의감리·지적조치)·
  pmo-governance(방법론/표준/품질게이트)·pmo-portfolio(다중 프로젝트 총괄)·pm-qa(경계면 정합 QA)
- pm-pmo-orchestrator 스킬(하이브리드: PM/PMO 트랙 분기) + /pmo 커맨드
- marketplace.json 등록 → /plugin install pm-pmo@ythong-harness 설치 검증(오류 0)
- CLAUDE.md 하네스 포인터·PROJECT_MAP·docs/plugins.md 카탈로그 등재
- 경계: 제안(수주 전)=proposal-builder, 수주 후 수행·총괄=pm-pmo

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-17 09:15:31 +09:00

85 lines
8.1 KiB
Markdown

---
name: pm-pmo-orchestrator
description: PM(프로젝트 관리)·PMO(프로젝트 관리 조직) 업무를 자동화하는 오케스트레이터. pm-planner·pm-risk-manager·pm-reporter·pm-auditor·pmo-governance·pmo-portfolio·pm-qa 7인 팀이 착수/계획(사업수행계획서·WBS·일정·M/M)→리스크/이슈/변경→진척보고(주간/월간/EVM)→감리 대응(모의감리·지적조치)→PMO 거버넌스(방법론·표준·품질게이트)→포트폴리오 총괄→정합성 검증을 파이프라인으로 처리한다. "프로젝트 계획", "WBS", "사업수행계획서", "주간보고/월간보고/완료보고", "리스크 관리", "이슈 정리", "변경 영향분석", "감리 대응", "모의감리", "지적사항 조치", "검수 준비", "PMO 표준", "품질게이트", "포트폴리오 현황", "자원 배분", "전체 프로젝트 현황", "다시 실행", "특정 산출물만", "업데이트", "보완" 요청 시 반드시 이 스킬을 사용하라.
---
# PM·PMO 오케스트레이터
**목표:** 프로젝트 수행(PM)과 조직 총괄(PMO)의 관리 산출물을 완성한다. 주력은 **SI 구축·SM 유지보수** 프로젝트의 수행 단계 — 제안(수주 전) 단계는 `proposal-builder`가 담당하고, 이 하네스는 **수주 후**를 담당한다.
## ★ 지휘 원칙 (필수)
사용자가 **"프로젝트 계획 세워줘"**, **"이번 주 보고서 만들어줘"** 처럼 한 마디만 해도 오케스트레이터가 필요한 전문가를 판별·소집해 지휘한다. 단계를 일일이 지시받지 않는다.
- 오케스트레이터(이 스킬을 실행하는 메인)가 **총지휘자**다. 7인 전문가(pm-planner·pm-risk-manager·pm-reporter·pm-auditor·pmo-governance·pmo-portfolio·pm-qa)를 트랙·Phase 순서대로 spawn·조율한다.
- 각 전문가는 `model: opus`로 spawn, 산출물은 `_workspace/`에 파일로 공유, 오케스트레이터가 진행을 모니터링하고 결과를 종합한다.
- 입력(프로젝트 기초 정보)만 확인되면 즉시 착수 — 단계 승인을 매번 받지 않는다(누락 입력만 요청).
**실행 모드:** 하이브리드
- Phase 1 판별(오케스트레이터 직접) → Phase 2 계획/표준(단일) → Phase 3 통제·보고·감리(병렬 서브) → Phase 4 포트폴리오 통합(단일) → Phase 5 QA(점진)
## 전문가 팀 (7)
| 에이전트 | 담당 | 트랙 |
|----------|------|------|
| pm-planner | 사업수행계획서·WBS·일정·자원(M/M)·예산 | PM |
| pm-risk-manager | 리스크 레지스터·이슈 로그·변경(CR) 영향분석 | PM |
| pm-reporter | 주간/월간/단계 보고·EVM(SPI/CPI)·경영진 요약 | PM |
| pm-auditor | 감리 대응(점검항목 매핑·모의감리·지적조치)·검수 준비 | PM |
| pmo-governance | 방법론·표준 템플릿·품질게이트·성숙도 진단 | PMO |
| pmo-portfolio | 다중 프로젝트 대시보드·자원 충돌·우선순위·리스크 롤업 | PMO |
| pm-qa | 산출물 경계면 교차 검증(점진) | 공통 |
## Phase 0: 컨텍스트 확인 / 입력 수집
```
_workspace/ 존재 + 부분 수정 요청 → 해당 에이전트만 재실행 (부분 재실행)
_workspace/ 존재 + 새 프로젝트/기간 입력 → _workspace_prev/ 이동 후 새 실행
_workspace/ 미존재 → 초기 실행
```
필수 입력 확인: ① 프로젝트 기초 정보(계약/RFP/제안서/과업 범위 — 경로 또는 텍스트) ② 요청 유형(계획/보고/리스크/감리/PMO) ③ 실적 데이터(보고서·포트폴리오 요청 시). 발주처 표준 양식이 있으면 함께 수집. 누락 시 사용자에게 요청.
## Phase 1: 트랙 판별 (오케스트레이터 직접)
요청을 트랙으로 매핑한다. 겹치면 둘 다 실행:
- **PM 트랙**: 단일 프로젝트 계획·통제·보고·감리 → Phase 2-A → 3
- **PMO 트랙**: 표준·게이트·다중 프로젝트 총괄 → Phase 2-B → 4
- 부분 요청("주간보고만", "모의감리만")은 해당 에이전트 + pm-qa만 실행.
## Phase 2-A: 계획 수립 (단일 — PM 트랙)
**pm-planner** — 사업수행계획서 골격·WBS·일정·자원·산출물 목록. 산출 `01_planner_*.md`. 기존 계획이 있으면 기준선으로 로드만 하고 건너뛴다.
## Phase 2-B: 표준·게이트 (단일 — PMO 트랙)
**pmo-governance** — 방법론·템플릿 체계·품질게이트·성숙도 진단. 산출 `04_governance_*.md`. 조직 표준이 이미 있으면 갭 분석·증분 개선.
## Phase 3: 통제·보고·감리 (병렬 서브 — PM 트랙)
요청 범위에 맞는 에이전트를 `run_in_background`로 병렬 소집 (각 `model: opus`):
- **pm-risk-manager** — 레지스터·이슈 로그·CR 영향분석 (`02_risk_*.md`)
- **pm-reporter** — 주간/월간/단계 보고·EVM (`03_reporter_*.md`) ※ 리스크 Top 인용을 위해 risk 산출 후 착수하거나, 완료 후 인용 갱신
- **pm-auditor** — 감리 대응 계획·점검항목 매핑·모의감리·지적조치 (`07_auditor_*.md`)
계획(Phase 2-A)의 WBS ID를 공통 참조 키로 사용한다.
## Phase 4: 포트폴리오 통합 (단일 — PMO 트랙)
**pmo-portfolio** — 개별 프로젝트 산출물(보고서·레지스터)을 원천으로 대시보드·자원 충돌·우선순위·리스크 롤업 집계 (`05_portfolio_*.md`). 진척 기준이 프로젝트마다 다르면 pmo-governance 표준으로 정규화 후 비교.
## Phase 5: 정합성 QA (점진)
**pm-qa** (general-purpose) — 각 산출물 완성 직후 경계면 교차 검증: WBS↔일정↔보고서 수치 재계산, 레지스터↔보고서 ID 실존, CR 파급 반영, 감리 매핑표의 산출물 실존, 대시보드↔개별 보고서 일치. 불일치는 해당 에이전트에 반려(권위 판정 포함), 수정 후 해당 경계면만 재검증. 산출 `06_qa_report.md` + 최종 게이트 판정.
## 데이터 전달 프로토콜
- **파일 기반(기본)**: `_workspace/{순번}_{agent}_{artifact}.md`. 중간물은 보존(감사 추적), 최종 산출물만 사용자 지정 경로로.
- **반환값 기반**: 병렬 서브 에이전트 결과를 오케스트레이터가 수집·종합.
- 문서 간 참조는 ID(WBS-x.x.x, RISK-nn, ISS-nn, CR-nn, AUD-nn)로만 — 자유 서술 참조 금지(QA 검증 가능성).
## 에러 핸들링
| 상황 | 대응 |
|------|------|
| 프로젝트 기초 정보 없음 | 사용자에게 요청(HWP는 텍스트 변환 요청, 외부 업로드 금지) |
| 실적 데이터 없이 보고서 요청 | 실적 입력 요청 또는 템플릿+수집 항목 목록만 산출(한계 명시) |
| 원가 데이터 없음(EVM) | 일정 기반 SPI만 산출, CPI 불가 사유 명시 |
| QA 불일치 검출 | 권위 산출물 판정 → 해당 에이전트 반려·수정 → 경계면 재검증 (1회 재시도, 재실패 시 미해결 항목 보고서에 명시) |
| 감리 매핑 산출물 부재 | 공백 금지 — 생성 계획(담당·기한)으로 대체하고 리스크 등재 |
| 프로젝트 간 기준 불일치(포트폴리오) | pmo-governance 표준으로 정규화, 정규화 근거 병기 |
| 자격증명·민감정보 발견 | 산출물에 미기재(불변 보안 규칙 — 외부 API 금지 포함) |
## 테스트 시나리오
**정상:** ① "이 계약서로 프로젝트 계획 세워줘" → Phase 2-A → 3(risk) → QA ② "이번 주 주간보고 만들어줘" → pm-reporter + QA (기존 기준선 로드) ③ "종료 감리 준비해줘" → pm-auditor(매핑+모의감리) + QA ④ "전체 프로젝트 현황 정리해줘" → Phase 4 + QA ⑤ "리스크 레지스터만 업데이트" → pm-risk-manager 부분 재실행
**에러:** ① 실적 데이터 없이 월간보고 요청 → 수집 항목 목록 산출 + 입력 요청 ② QA가 보고서 진척률과 WBS 합산 불일치 검출 → pm-reporter 반려·재계산 후 통과
## 산출물
`사업수행계획서 골격·WBS·일정·자원계획·리스크 레지스터·이슈 로그·CR 영향분석·주간/월간/단계 보고서·EVM·감리 대응 매핑·모의감리 결과·지적조치 관리·방법론/템플릿·품질게이트·포트폴리오 대시보드·QA 보고` — 중간물은 `_workspace/`, 최종 문서는 사용자 지정 경로.