작업 요청 템플릿
이 문서는 PM이 전문가 에이전트들에게 작업을 요청할 때 사용하는 표준화된 템플릿을 제공합니다.
템플릿 구조
모든 작업 요청은 다음 구조를 따라야 합니다:
단계: {Phase X - 단계명}
우선순위: {HIGH/MEDIUM/LOW}
예상 시간: {시간}
요청 내용:
"{구체적인 작업 명령}"
필수 산출물:
- [ ] {산출물 1}
- [ ] {산출물 2}
완료 기준:
- [ ] {검증 기준 1}
- [ ] {검증 기준 2}
의존성:
- 선행 작업: {작업명}
- 관련 파일: {파일 경로}
sq_cod_architect 전용 템플릿
아키텍처 설계 요청
단계: Phase 1 - 요구사항 분석 및 설계
우선순위: HIGH
예상 시간: 4-6시간
요청 내용:
"CoD 시스템의 전체 아키텍처를 설계해주세요.
- LangGraph.js 기반 멀티 에이전트 구조
- 4개 전문가 에이전트 간 데이터 플로우 설계
- DTA Wide 플랫폼과의 CQRS/Event 통합 방안
- TimeMachine 서비스 통합 아키텍처
- 확장 가능한 모듈 구조 및 인터페이스 설계"
필수 산출물:
- [ ] 전체 시스템 아키텍처 다이어그램
- [ ] 에이전트 간 데이터 플로우 차트
- [ ] DTA Wide 통합 포인트 명세서
- [ ] 기술 스택 및 라이브러리 선정 근거
- [ ] 성능 및 확장성 고려사항 문서
완료 기준:
- [ ] 아키텍처가 DTA Wide CQRS 패턴을 준수함
- [ ] TimeMachine 통합이 명확히 설계됨
- [ ] 4개 전문가 에이전트 역할이 아키텍처에 반영됨
- [ ] 성능 목표(30초 이내 응답)가 달성 가능함을 검증
- [ ] 의료 데이터 보안 요구사항이 반영됨
의존성:
- 선행 작업: CoD 시스템 설계 문서 검토 완료
- 관련 파일: apps/dta-wide-doc/docs/application/chain-of-debate/sleep-quality-cod-system-design.md
기술 스택 최적화 요청
단계: Phase 1 - 요구사항 분석 및 설계
우선순위: HIGH
예상 시간: 2-3시간
요청 내용:
"CoD 시스템 개발을 위한 최적 기술 스택을 제안해주세요.
- TypeScript + LangGraph.js 환경에서의 성능 최적화 방안
- 의료 데이터 처리를 위한 보안 라이브러리 선정
- 실시간 분석을 위한 캐싱 및 병렬 처리 전략
- DTA Wide 플랫폼과의 호환성 검증"
필수 산출물:
- [ ] 권장 기술 스택 리스트 (버전 포함)
- [ ] 각 선택의 근거와 대안 비교
- [ ] 성능 벤치마크 예상치
- [ ] 보안 요구사항 충족 방안
완료 기준:
- [ ] DTA Wide 기존 기술 스택과 호환성 확인
- [ ] 의료 데이터 보안 규정(GDPR, 의료정보보호법) 준수
- [ ] 목표 성능(30초 이내) 달성 가능성 검증
- [ ] 라이선스 호환성 및 비용 검토 완료
의존성:
- 선행 작업: 없음 (즉시 실행 가능)
sq_cod_developer 전용 템플릿
기본 인프라 구축 요청
단계: Phase 3 - 핵심 인프라 개발
우선순위: HIGH
예상 시간: 8-12시간
요청 내용:
"LangGraph.js 기반 CoD 엔진의 기본 인프라를 구축해주세요.
- NestJS Feature Library 생성 (libs/feature/sleep-quality-cod)
- CQRS 패턴 Command/Query Handlers 구현
- BaseExpertAgent 추상 클래스 구현
- TimeMachine 통합 레이어 구축
- 기본 도메인 엔티티 정의"
필수 산출물:
- [ ] Feature Library 프로젝트 구조
- [ ] PredictSleepQualityCommand Handler
- [ ] GetSleepQualityAnalysisQuery Handler
- [ ] BaseExpertAgent 추상 클래스
- [ ] 도메인 엔티티 (SleepQualityPrediction, ExpertAnalysis)
- [ ] 기본 Repository 인터페이스
완료 기준:
- [ ] NX 빌드가 성공적으로 완료됨
- [ ] CQRS 패턴이 DTA Wide 표준을 준수함
- [ ] TimeMachine 서비스가 정상 주입됨
- [ ] 기본 단위 테스트가 통과함
- [ ] TypeScript strict 모드 준수
의존성:
- 선행 작업: sq_cod_architect의 아키텍처 설계 승인
- 관련 파일: Architecture design documents
전문가 에이전트 구현 요청
단계: Phase 4 - 전문가 에이전트 구현
우선순위: HIGH (단계별 구현)
예상 시간: 각 에이전트당 6-8시간
요청 내용:
"[에이전트명] 전문가의 분석 로직을 완전히 구현해주세요.
- BaseExpertAgent를 상속받은 구체적 구현
- 해당 도메인의 전문 분석 로직
- 다른 에이전트와의 논증(challengeOtherAnalyses) 기능
- 프롬프트 관리 및 LLM 통합
- 결과 해석 및 근거 제시 로직"
필수 산출물:
- [ ] 전문가 에이전트 클래스 구현
- [ ] 도메인별 분석 Tools 구현
- [ ] 프롬프트 템플릿 세트
- [ ] 단위 테스트 스위트
- [ ] 통합 테스트 시나리오
완료 기준:
- [ ] 모든 단위 테스트 통과 (90% 이상 커버리지)
- [ ] 일관된 분석 결과 검증 (동일 입력시 90% 유사성)
- [ ] 논증 기능이 정상 작동함
- [ ] 성능 요구사항 충족 (에이전트당 10초 이내)
- [ ] 에러 핸들링 및 복구 로직 구현
의존성:
- 선행 작업: 기본 인프라 구축 완료
- 관련 작업: 프롬프트 엔지니어링 및 최적화
작업 완료 검증 체크리스트
코드 품질 검증
- TypeScript strict 모드 준수
- ESLint 규칙 통과
- 단위 테스트 커버리지 90% 이상
- 코드 리뷰 완료
성능 검증
- 응답 시간 목표 달성
- 메모리 사용량 최적화
- 동시 요청 처리 검증
- 에러 복구 시간 측정
통합 검증
- DTA Wide 플랫폼과의 호환성
- TimeMachine 서비스 정상 작동
- 이벤트 발행/구독 정상 작동
- 데이터베이스 연동 검증
문서화 검증
- API 문서 업데이트
- 아키텍처 문서 반영
- 사용자 가이드 작성
- 트러블슈팅 가이드 작성