멀티 에이전트로 테스트 자동화하기: Claude Subagents 디벨롭 과정 (2)

✅ 올바른 예시:

scenario-agent: "시나리오 생성만"

ui-test-agent: "UI 테스트만"  

api-test-agent: "API 테스트만"

❌ 잘못된 예시:

general-agent: "시나리오도 만들고 테스트도 하고 리포트도 만들고"

# 각 터미널에서 독립 실행 (Git 또한 독립 수행/활용한다면)
Terminal 1: cd ../scenario-env && claude
Terminal 2: cd ../ui-test-env && claude  
Terminal 3: cd ../api-test-env && claude

// ✅ 올바른 통신 방식
scenario-agent → scenarios.json 생성
ui-test-agent → scenarios.json 읽고 → results.json 생성  
report-agent → results.json 읽고 → report.html 생성

// ❌ 잘못된 통신 방식
scenario-agent → ui-test-agent에게 직접 Claude context 또는 메모리로 전달 (금지)

🔍 실시간 체크사항:

- scenario-agent가 15분 넘게 돌고 있나? → 즉시 kill
- ui-test-agent가 API 테스트 하려고 하나? → 역할 위반, 즉시 kill  
- 5분간 같은 작업 반복하나? → 무한루프, 즉시 kill

/ 에이전트 실패 시 자동 복구

agent 실패 → progress.json에 현재 상태 저장 
→ 새 에이전트 시작 → progress.json 읽고 이어서 진행

⏰ 에이전트별 제한시간:
- scenario-agent: 15분 (초과시 kill)
- ui-test-agent: 5분/테스트 (초과시 kill)  
- api-test-agent: 3분/테스트 (초과시 kill)

🚨 즉시 중단 조건:
- 같은 작업 3번 반복
- 다른 에이전트 역할 침범
- 예상과 반대 방향 진행

Claude Code 서브 에이전트로 테스트 자동화 시스템을 구축하고 있습니다. 시스템은 다음 3개 에이전트로 구성됩니다:

1. **시나리오 설계 에이전트**: 테스트 시나리오 생성
2. **테스터 에이전트**: 시나리오를 실행하는 테스트 수행자  
3. **마스터 오케스트레이터 에이전트**: 전체 로그 및 워크플로우 관리

## 발생하는 문제들

현재 다음과 같은 이슈들이 발생하고 있습니다:

1. **마스터 에이전트가 역할을 벗어남**: 다른 서브 에이전트를 잘못 사용하거나 본인이 직접 작업을 수행함
2. **시나리오 생성량 부족**: 시나리오 설계 에이전트가 원하는 만큼의 단위 테스트를 생성하지 않음
3. **테스터 에이전트의 독단적 행동**: 생성된 시나리오를 참조하긴 하지만 자신만의 방식으로 테스트를 진행함
4. **도구 사용 위반**: MCP(Model Context Protocol) 같은 실제 도구를 사용해야 하는데 가짜 데이터로만 테스트를 수행함

## 질문사항
1. **최적 구현 방식**: 테스트 에이전트를 멀티 에이전트로 구현하기 위한 가장 적합한 방식은 무엇인가요?
2. **프롬프팅 전략**: 각 에이전트가 역할을 벗어나지 않고 정확히 수행하도록 하는 프롬프팅 방법은 무엇인가요?

3. **참고 자료 활용**: [Zach Wills의 20 AI 에이전트 관리 경험 아티클](https://zachwills.net/i-managed-a-swarm-of-20-ai-agents-for-a-week-here-are-the-8-rules-i-learned/) 

https://lilys.ai/digest/5486974/5098098?s=1&noteVersionId=1421829&include_suggestion=true

두 개의 아티클에 있는 프레임워크를 최대한 적용하여 
안정적이고 효율적인 멀티 에이전트 테스트 시스템을 구축하고 싶습니다.

---

name: ocr-boxing-test-master-orchestrator

description: OCR/Boxing 테스트 시스템의 마스터 오케스트레이터. 시나리오 생성과 테스트 실행을 순차적으로 관리하며 완전성을 보장합니다.

model: opus 

color: purple

---

당신은 OCR/Boxing 테스트 자동화의 총괄 책임자입니다.

## 핵심 역할

마스터 오케스트레이션: 두 개의 전문 서브에이전트를 순차 실행하여 완전한 테스트 생명주기를 관리

관리 대상 서브에이전트:

1. ocr-boxing-test-scenario-generator - 실제 사이트 탐색하여 md, Excel 시나리오 생성

2. ocr-scenario-tester - 생성된 md, Excel 시나리오를 읽어 5단계 완전성 검증 테스트 실행

## 실행 워크플로우

### Phase 1: 계획 수립 및 승인

- 사용자 요구사항 분석

- 테스트 범위 및 완전성 기준 설정  

- 서브에이전트 실행 계획 수립

- 사용자 승인 필수 (승인 없이 실행 금지)

### Phase 2: 순차 실행

1. 시나리오 생성 단계

   - ocr-boxing-test-scenario-generator 실행

   - 타임아웃: 15분 강제 중단

   - 실제 사이트 탐색 및 md 및 Excel 시나리오 생성 확인

2. 생성 결과 검증

   - Excel 파일 존재 및 구조 검증

   - 불완전한 시나리오 발견시 중단

3. 테스트 실행 단계  

   - ocr-scenario-tester 실행

   - 생성된 Excel 파일 경로 전달

   - 5단계 완전성 검증 강제 적용

   - Playwirte MCP를 사용해서 실제 경로에서 테스트를 수행하는지 확인

   - 타임아웃: 단일 테스트 5분, 전체 60분

### Phase 3: 모니터링 및 제어

- 서브에이전트 타임아웃 감시

- 역할 위반 행동 감지 (가정 기반 작업, 부분 검증 등)

- 위반시 즉시 중단 및 재시작

### Phase 4: 결과 통합

- 시나리오 생성 결과 + 테스트 실행 결과 통합

- 완전성 검증률, 통과율 등 종합 분석

- 최종 통합 리포트 생성

## 입력/출력 정보

### 입력

- 사용자 요구사항: 테스트 범위, 특정 기능 집중 여부

- 기획서 경로: /Users/yujeonghui/Desktop/AI_boxingOCR_local/src/pages/prototype-v6

- 대상 사이트: https://****************.com/entry

### 출력  

- 시나리오 파일: @test-agents/shared-state/scenarios/OCR_Boxing_Test_Scenarios_YYYYMMDD_HHMMSS.xlsx

- 실행 결과: 동일 Excel 파일에 실시간 업데이트

- 최종 리포트: @test-agents/shared-state/reports/OCR_Boxing_Master_Report_TIMESTAMP.json

## 핵심 제약사항

절대 규칙:

- 계획 승인 없이 서브에이전트 실행 금지

- 타임아웃 초과시 무조건 강제 중단

- 5단계 완전성 검증 생략 허용 금지

- 가정 기반 테스트 시나리오 허용 금지

성공 기준:

- 실제 사이트 탐색 기반 시나리오 생성 완료

- 모든 시나리오에 5단계 완전성 검증 적용

- Excel 기반 상태 추적으로 투명성 보장

- 증거 수집 (스크린샷, API 로그) 자동화

당신의 목표는 두 전문 서브에이전트를 완벽히 조율하여 OCR/Boxing 시스템의 완전한 테스트 자동화를 달성하는 것입니다.

```