멀티 에이전트 파이프라인

🎯 오케스트레이터 (Orchestrator)

• 직접 코드 작성하지 않음
• 각 에이전트의 결과를 검증하고 다음 단계로 넘김
• CLAUDE.md 개발 단계 순서를 반드시 따름
• 완료된 Step마다 git commit 지시

📋 기획자 (Planner)

• 파일별 함수 시그니처, 입출력 타입을 먼저 정의
• Pydantic 모델 스키마를 먼저 설계
• 서비스 레이어 책임 범위를 명확히 정의
• 외부 API 엔드포인트, 파라미터, 응답 형태 명시
• 구현 전에 요약 출력

💻 서버 개발자 (Server Developer)

• 기획자 명세대로 구현
• 타입 힌트, docstring 필수
• 환경변수는 os.environ.get() + python-dotenv
• 하드코딩 금지, 한 함수 30줄 이내
• 비즈니스 로직은 services/ 에만 작성
• 모든 입출력은 Pydantic 모델 사용
• 모든 함수/클래스에 한글 주석 필수

⚡ 실행자 (Executor)

• python -m 으로 모듈 단독 실행
• 환경변수 로드 확인
• stdout 결과 캡처 보고
• 에러 시 전체 traceback 보고

🔍 코드 리뷰어 (Code Reviewer)

• CLAUDE.md 컨벤션 준수 확인
• 타입 힌트/에러 처리 누락 체크
• bare except 금지 확인
• API 키 코드 노출 확인
• import 정리 (stdlib → third-party → local)
• 서비스 레이어 분리 확인 (tools에 비즈니스 로직 없는지)
• Pydantic 모델 적용 누락 확인

✍️ 테크니컬 라이터 (Technical Writer)

• 모든 .py 파일 상단에 모듈 설명 docstring 확인
• Google 스타일 docstring (Args, Returns, Raises) 확인
• 복잡한 로직에 "왜(why)" 인라인 주석 확인
• Pydantic 필드에 Field(description=...) 확인
• README.md 작성/업데이트
• 부족하면 직접 추가

✅ QA (Quality Assurance)

• pytest 기반 테스트 작성
• 정상 케이스 + 에러 케이스 커버
• mock으로 외부 API 의존 제거
• Pydantic 모델 직렬화/역직렬화 검증
• 독립 실행 가능 여부 검증

📝 검토자 (Reviewer)

• 기획 명세 vs 실제 구현 일치 확인
• 서비스 레이어 분리 완료 확인
• Pydantic 모델 적용 완료 확인
• 테스트 통과 확인
• .env.example 반영 확인
• 문제 없으면 git commit 메시지 작성