LGES-OC5-PtoP-Welder/.ubisam_agent/skills/orchestrate-ptop-harness/SKILL.md

name	description
orchestrate-ptop-harness	ILSOS_PrismaticRD_PTOP 개발 팀의 오케스트레이터. 3명 팀원(PTOP Lead, PTOP Developer, Build/DevOps Engineer)의 작업을 조율하고 아키텍처 분석, 구현 분석, 빌드 최적화를 통합 진행. "PTOP 프로젝트 종합 분석", "PTOP 전체 점검", "PTOP 하네스 시작", "PTOP 팀 조율" 요청 시 사용.

Orchestrate PTOP Harness Skill

목표

ILSOS_PrismaticRD_PTOP의 3계층 아키텍처, 구현 상세, 빌드 최적화를 병렬 분석하여 팀원들이 조율하며 통합 보고서를 완성한다.

실행 모드

에이전트 팀 (팀 조율 활성화)

[오케스트레이터]
    ├─ TeamCreate(team=[PTOP Lead, PTOP Developer, Build/DevOps Engineer])
    ├─ Phase 1: 초기 컨텍스트 확인
    ├─ Phase 2: 병렬 분석 작업 할당 (TaskCreate + 팀원 간 SendMessage)
    ├─ Phase 3: 결과 수집 및 통합
    ├─ Phase 4: 최종 검증
    └─ Phase 5: 팀 해제

워크플로우

Phase 1: 초기 컨텍스트 확인 (5분)

수행 항목:

1. _workspace/ 디렉토리 존재 여부 확인

   • 존재 → 기존 분석 파일 로드, 부분 재실행 검토
   • 미존재 → 새 작업 시작

2. 기존 분석이 있으면:

   • 이전 PTOP Lead의 보고서 검토
   • PTOP Developer의 발견사항 검토
   • Build Engineer의 개선안 검토
   • → 파일을 _workspace_prev/로 이동 후 신규 분석 진행

산출:

• Phase 1 진행 상황 (TaskCreate 할당)

Phase 2: 병렬 분석 작업 할당 (15~20분)

TaskCreate 3개 발행:

Task 2-1: PTOP Lead — 아키텍처 분석

Role: PTOP Lead
Task: analyze-ptop-architecture 스킬 실행
Input: 
  - ILSOS_PrismaticRD_PTOP 소스 전체
  - CLAUDE.md 프로젝트 컨텍스트
Output:
  - _workspace/01a_equipdef_analysis.md
  - _workspace/01b_sequences_analysis.md
  - _workspace/01c_device_analysis.md
  - _workspace/01d_rxnet_analysis.md
  - _workspace/01e_device_integration.md
  - _workspace/01_ptop_architecture.md (통합)
Deadline: 20분
Status: in_progress

Task 2-2: PTOP Developer — 구현 분석

Role: PTOP Developer
Task: analyze-ptop-implementation 스킬 실행
Input:
  - PTOP Lead의 01_ptop_architecture.md (참고)
  - SeqAutoRunPTOP.cs, Device/* 소스
Output:
  - _workspace/02_ptop_implementation.md (상태 머신, 타이밍, 에러 처리 포함)
Dependencies: Task 2-1의 아키텍처 정의 완료 후 진행
Deadline: 20분
Status: blocked (대기)

Task 2-3: Build/DevOps Engineer — 빌드 최적화

Role: Build/DevOps Engineer
Task: optimize-ptop-build 스킬 실행
Input:
  - ILSOS_All.sln 파일
  - 현재 빌드 환경 정보
Output:
  - _workspace/04a_dependency_analysis.csv
  - _workspace/04_ptop_build_optimization.md (CI/CD 파이프라인 포함)
Status: in_progress (독립적)
Deadline: 15분

병렬 실행 전략:

• Task 2-1과 2-3은 독립적 → 동시 진행
• Task 2-2는 Task 2-1 결과 참고 필요 → 순차

팀 통신:

[오케스트레이터 → PTOP Lead]
  "아키텍처 분석 시작. 20분 안에 01_ptop_architecture.md 완성 부탁."

[오케스트레이터 → PTOP Developer]
  "PTOP Lead의 아키텍처 분석 대기 중. 시작 신호 받으면 구현 분석 시작할 것."

[오케스트레이터 → Build/DevOps Engineer]
  "빌드 최적화 분석 시작. 15분 안에 04_ptop_build_optimization.md 완성 부탁."

Phase 3: 중간 체크포인트 (10분)

T+10분 타이밍:

[오케스트레이터]
  - PTOP Lead의 01_ptop_architecture.md 완성 확인
  - Build/DevOps Engineer의 진행상황 확인
  
  [PTOP Developer에게 GO신호 발행]
    "PTOP Lead의 아키텍처 분석 완료. 이제 구현 분석 시작해주세요."

SendMessage 패턴:

[오케스트레이터 → PTOP Lead, PTOP Developer]
  "두 분석의 연계 포인트를 확인해주세요.
   - 아키텍처에서 정의한 3계층이 구현에 제대로 반영되었나?
   - 의도하지 않은 구조가 있나?"

Phase 4: 결과 수집 (5분)

수행 항목:

1. 3개 분석 결과 파일 모두 완성 확인
2. 각 팀원의 발견사항 요약 요청 (SendMessage)

[오케스트레이터 → 각 팀원]
  "분석 완료되셨나요? 가장 중요한 발견 3개를 나열해주세요."

PTOP Lead의 응답:
  1. SeqAutoRunPTOP이 메인 시퀀스이고 260605에 추가됨
  2. PLC, Laser, OCT, CellTracker 모두 필수 디바이스
  3. Rx.NET 메시지 흐름이 복잡 - 개선 필요

PTOP Developer의 응답:
  1. 상태 머신이 명확하지 않은 부분 발견 (XXX)
  2. PLC 호출 순서가 타이밍 크리티컬
  3. OCT 스캔 시간 최적화 기회

Build/DevOps Engineer의 응답:
  1. Release 빌드가 Debug보다 20% 느림
  2. AuroraDevices 중 불필요한 프로젝트 5개 발견
  3. CI/CD 파이프라인 설계 완료

Phase 5: 통합 보고서 생성 (10분)

오케스트레이터가 종합:

_workspace/00_PTOP_HARNESS_SUMMARY.md 생성

# ILSOS_PrismaticRD_PTOP 하네스 분석 — 종합 보고서

**분석 일시:** [날짜]
**팀원:** PTOP Lead, PTOP Developer, Build/DevOps Engineer
**총 소요시간:** ~50분

---

## Executive Summary

ILSOS_PrismaticRD_PTOP은 [간단 설명]

### 주요 발견

#### 아키텍처 (PTOP Lead)
- 3계층 구조 검증 완료
- 핵심 컴포넌트: [리스트]
- 개선 우선순위: [P0, P1, P2]

#### 구현 (PTOP Developer)
- 상태 머신 분석 완료
- 성능 병목: [리스트]
- 안정성 이슈: [리스트]

#### 빌드 (Build/DevOps Engineer)
- 빌드 성능: [현황]
- 의존성 최적화: [개선안]
- CI/CD: [설계 완료]

---

## 상세 분석

### 1. 아키텍처
[01_ptop_architecture.md 요약]

### 2. 구현
[02_ptop_implementation.md 요약]

### 3. 빌드 & DevOps
[04_ptop_build_optimization.md 요약]

---

## 종합 권장사항

| 우선순위 | 항목 | 담당 | 예상 공수 |
|---------|------|------|---------|
| P0 | [긴급] | PTOP Developer | ? |
| P1 | [중요] | PTOP Lead | ? |
| P2 | [개선] | Build/DevOps Engineer | ? |

---

## 다음 단계

1. 이 보고서 검토 (팀 + 사용자)
2. P0 항목 즉시 대응
3. P1 항목 일정 수립
4. P2 항목 백로그 등록

---

## 부록

- [분석 파일 목록]
- [팀 통신 기록]
- [시간 로그]

Phase 6: 팀 정리 및 후속 계획

[오케스트레이터]
  ✓ 팀 해제 (TeamDelete)
  ✓ 최종 보고서 제출
  → 사용자에게 결과 요약 제시

[사용자에게 제시]
  "PTOP 하네스 분석 완료. 주요 발견:
   1. 아키텍처: 3계층 구조 검증 완료 (문서: 01_ptop_architecture.md)
   2. 구현: 상태 머신 분석, 성능 병목 식별 (문서: 02_ptop_implementation.md)
   3. 빌드: 최적화 기회 발견, CI/CD 설계 완료 (문서: 04_ptop_build_optimization.md)
   
   다음 단계: 보고서 검토 → P0 항목 대응"

데이터 전달 프로토콜

전달 객체	방식	용도
팀원 간 작업 결과	파일 (_workspace/)	아키텍처 → 구현 분석 의존성
팀원 간 실시간 소통	SendMessage	질문, 상충 해결, 진행상황
최종 산출물	통합 보고서 + 세부 파일	사용자 제시

에러 핸들링

상황	처리 방식
팀원 분석 지연	진행상황 확인, 추가 시간 할당
팀원 간 의견 상충	SendMessage로 토론, 양쪽 견해 모두 기록
코드 이해 불가	해당 부분을 "불명확" 표시하고 진행
분석 결과 불완전	세부 파일에 "TODO" 표시, 최종 보고서에 명시

성공 기준

• 5개 세부 분석 문서 완성 (01a~01e, 02, 04a, 04)
• 3개 팀원 모두 할당된 작업 완료
• 통합 보고서 (00_PTOP_HARNESS_SUMMARY.md) 생성
• 주요 발견사항 3개 이상 도출
• 권장사항(P0/P1/P2)이 명확히 기술됨
• 모든 분석이 코드 레퍼런스와 함께 기술됨
• 팀원 간 의견 상충 없이 완료되거나, 상충이 있으면 명시적으로 기록됨

후속 작업

이 하네스는 초기 분석이며, 이후:

• P0 항목 대응 후 재검토
• P1 항목 진행 중 코드 리뷰 (별도 하네스)
• P2 항목 백로그 관리

재실행 트리거:

• 사용자가 "PTOP 재분석", "PTOP 상태 업데이트" 요청 시
• 주요 코드 변경 후 영향도 분석 필요 시