harness/plugins/pm-pmo/skills/pm-pmo-orchestrator/SKILL.md
DESKTOP-TKLFCPR\ython 5647851f60 feat(pm-pmo): v1.1.0 — 외부 AI 의뢰 트랙 추가 (pm-ai-commissioner, 8인) + 스티치 의뢰서 design.md
- pm-ai-commissioner 에이전트 신규: 스티치(Stitch) design.md(이미지 분석 기반)·
  젠스파크(Genspark) 조사/슬라이드 의뢰 md·graphify 지식그래프(graphify-out/) 생성 전담
- 오케스트레이터 Phase5 '외부 AI 의뢰' 트랙 신설 + graphify-out 생성/재사용 배선 + 트리거 확장
- /pmo 커맨드·README·INSTALL·카탈로그(CLAUDE.md/PROJECT_MAP/plugins.md) v1.1.0 동기화
- design.md: 루트 PNG 4종(배너·아이콘·소셜·팀) 분석 기반 스티치 디자인 의뢰서
  (브랜드 시스템·HEX 팔레트·에셋별 영문 프롬프트·납품/검수 기준)
- 설치 검증: claude plugin details → 에이전트 8·스킬 2 정상 로드

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

98 lines
10 KiB
Markdown

---
name: pm-pmo-orchestrator
description: PM(프로젝트 관리)·PMO(프로젝트 관리 조직) 업무를 자동화하는 오케스트레이터. pm-planner·pm-risk-manager·pm-reporter·pm-auditor·pmo-governance·pmo-portfolio·pm-ai-commissioner·pm-qa 8인 팀이 착수/계획(사업수행계획서·WBS·일정·M/M)→리스크/이슈/변경→진척보고(주간/월간/EVM)→감리 대응(모의감리·지적조치)→PMO 거버넌스(방법론·표준·품질게이트)→포트폴리오 총괄→외부 AI 의뢰서(스티치 design.md·젠스파크 조사 의뢰·graphify 지식그래프)→정합성 검증을 파이프라인으로 처리한다. "프로젝트 계획", "WBS", "사업수행계획서", "주간보고/월간보고/완료보고", "리스크 관리", "이슈 정리", "변경 영향분석", "감리 대응", "모의감리", "지적사항 조치", "검수 준비", "PMO 표준", "품질게이트", "포트폴리오 현황", "자원 배분", "전체 프로젝트 현황", "디자인 의뢰", "스티치 의뢰", "design.md 생성", "젠스파크 의뢰", "Genspark", "AI 의뢰서", "브리프 작성", "graphify-out 생성", "지식그래프", "다시 실행", "특정 산출물만", "업데이트", "보완" 요청 시 반드시 이 스킬을 사용하라.
---
# PM·PMO 오케스트레이터
**목표:** 프로젝트 수행(PM)과 조직 총괄(PMO)의 관리 산출물을 완성한다. 주력은 **SI 구축·SM 유지보수** 프로젝트의 수행 단계 — 제안(수주 전) 단계는 `proposal-builder`가 담당하고, 이 하네스는 **수주 후**를 담당한다.
## ★ 지휘 원칙 (필수)
사용자가 **"프로젝트 계획 세워줘"**, **"이번 주 보고서 만들어줘"** 처럼 한 마디만 해도 오케스트레이터가 필요한 전문가를 판별·소집해 지휘한다. 단계를 일일이 지시받지 않는다.
- 오케스트레이터(이 스킬을 실행하는 메인)가 **총지휘자**다. 8인 전문가(pm-planner·pm-risk-manager·pm-reporter·pm-auditor·pmo-governance·pmo-portfolio·pm-ai-commissioner·pm-qa)를 트랙·Phase 순서대로 spawn·조율한다.
- 각 전문가는 `model: opus`로 spawn, 산출물은 `_workspace/`에 파일로 공유, 오케스트레이터가 진행을 모니터링하고 결과를 종합한다.
- 입력(프로젝트 기초 정보)만 확인되면 즉시 착수 — 단계 승인을 매번 받지 않는다(누락 입력만 요청).
**실행 모드:** 하이브리드
- Phase 1 판별(오케스트레이터 직접) → Phase 2 계획/표준(단일) → Phase 3 통제·보고·감리(병렬 서브) → Phase 4 포트폴리오 통합(단일) → Phase 5 외부 AI 의뢰(요청 시, 단일) → Phase 6 QA(점진)
## 전문가 팀 (8)
| 에이전트 | 담당 | 트랙 |
|----------|------|------|
| 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-ai-commissioner | 외부 AI 의뢰서 — 스티치 design.md·젠스파크 조사/슬라이드 의뢰 md·graphify 지식그래프 활용 | 의뢰 |
| pm-qa | 산출물 경계면 교차 검증(점진) | 공통 |
## Phase 0: 컨텍스트 확인 / 입력 수집
```
_workspace/ 존재 + 부분 수정 요청 → 해당 에이전트만 재실행 (부분 재실행)
_workspace/ 존재 + 새 프로젝트/기간 입력 → _workspace_prev/ 이동 후 새 실행
_workspace/ 미존재 → 초기 실행
```
필수 입력 확인: ① 프로젝트 기초 정보(계약/RFP/제안서/과업 범위 — 경로 또는 텍스트) ② 요청 유형(계획/보고/리스크/감리/PMO) ③ 실적 데이터(보고서·포트폴리오 요청 시). 발주처 표준 양식이 있으면 함께 수집. 누락 시 사용자에게 요청.
## Phase 1: 트랙 판별 (오케스트레이터 직접)
요청을 트랙으로 매핑한다. 겹치면 모두 실행:
- **PM 트랙**: 단일 프로젝트 계획·통제·보고·감리 → Phase 2-A → 3
- **PMO 트랙**: 표준·게이트·다중 프로젝트 총괄 → Phase 2-B → 4
- **의뢰 트랙**: 외부 AI 의뢰서(design.md·젠스파크 md)·지식그래프 → Phase 5
- 부분 요청("주간보고만", "모의감리만", "design.md만")은 해당 에이전트 + pm-qa만 실행.
**graphify 지식그래프(요청 시 또는 컨텍스트 필요 시):** 프로젝트 소스/문서 파악이 필요하거나 "graphify-out 생성" 요청이 있으면 `graphify` 스킬을 호출해 `graphify-out/`을 생성한다. 이미 존재하면 재생성하지 않고 그래프 질의로 활용(명시적 재생성 요청 시만 갱신).
## 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: 외부 AI 의뢰 (단일 — 의뢰 트랙, 요청 시)
**pm-ai-commissioner** — 외부 AI 서비스에 전달할 의뢰서를 작성:
- **스티치(Stitch) 디자인 의뢰** → 대상 이미지(*.png 등)를 직접 분석해 `design.md`(브랜드 시스템·에셋별 영문 프롬프트·납품/검수 기준)
- **젠스파크(Genspark) 조사/슬라이드 의뢰** → `genspark_request.md`(목적·요청 작업·입력 자료·산출 형식·검수 기준)
- 프로젝트 요약이 필요하면 graphify 지식그래프(`graphify-out/`) 생성·조회로 컨텍스트 확보
보안: 의뢰서는 외부 전송 전제 — 자격증명·내부 IP·민감정보 기재 금지를 산출 전 자체 점검한다.
## Phase 6: 정합성 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 금지 포함) |
| 의뢰 대상 파일(이미지 등) 없음 | 경로 요청 — 추측으로 의뢰서 작성 금지 |
| graphify 스킬 미설치 | 지식그래프 생략, 파일 직접 분석으로 대체(한계 명시) |
## 테스트 시나리오
**정상:** ① "이 계약서로 프로젝트 계획 세워줘" → Phase 2-A → 3(risk) → QA ② "이번 주 주간보고 만들어줘" → pm-reporter + QA (기존 기준선 로드) ③ "종료 감리 준비해줘" → pm-auditor(매핑+모의감리) + QA ④ "전체 프로젝트 현황 정리해줘" → Phase 4 + QA ⑤ "리스크 레지스터만 업데이트" → pm-risk-manager 부분 재실행 ⑥ "*.png로 스티치 의뢰 design.md 만들어줘" → pm-ai-commissioner(이미지 분석→의뢰서) + QA ⑦ "젠스파크에 시장조사 의뢰서" → pm-ai-commissioner + QA
**에러:** ① 실적 데이터 없이 월간보고 요청 → 수집 항목 목록 산출 + 입력 요청 ② QA가 보고서 진척률과 WBS 합산 불일치 검출 → pm-reporter 반려·재계산 후 통과
## 산출물
`사업수행계획서 골격·WBS·일정·자원계획·리스크 레지스터·이슈 로그·CR 영향분석·주간/월간/단계 보고서·EVM·감리 대응 매핑·모의감리 결과·지적조치 관리·방법론/템플릿·품질게이트·포트폴리오 대시보드·design.md(스티치 의뢰)·genspark_request.md(젠스파크 의뢰)·graphify-out/(지식그래프)·QA 보고` — 중간물은 `_workspace/`, 최종 문서는 사용자 지정 경로.