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

8.1 KiB

name description
pm-pmo-orchestrator 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/, 최종 문서는 사용자 지정 경로.