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

---
name: orchestrate-ptop-harness
description: 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` 생성

```markdown
# 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 상태 업데이트" 요청 시
- 주요 코드 변경 후 영향도 분석 필요 시