# 에이전트 오케스트레이션

## 사용 가능한 에이전트

`~/.claude/agents/`에 위치:

| 에이전트 | 용도 | 사용 시점 |
|---------|------|----------|
| planner | 구현 계획 | 복잡한 기능, 리팩토링 |
| architect | 시스템 설계 | 아키텍처 의사결정 |
| tdd-guide | 테스트 주도 개발 | 새 기능, 버그 수정 |
| code-reviewer | 코드 리뷰 | 코드 작성 후 |
| security-reviewer | 보안 분석 | 커밋 전 |
| build-error-resolver | 빌드 에러 수정 | 빌드 실패 시 |
| e2e-runner | E2E 테스팅 | 핵심 사용자 흐름 |
| database-reviewer | 데이터베이스 스키마/쿼리 리뷰 | 스키마 설계, 쿼리 최적화 |
| go-reviewer | Go 코드 리뷰 | Go 코드 작성 또는 수정 후 |
| go-build-resolver | Go 빌드 에러 수정 | `go build` 또는 `go vet` 실패 시 |
| refactor-cleaner | 사용하지 않는 코드 정리 | 코드 유지보수 |
| doc-updater | 문서 관리 | 문서 업데이트 |

## 즉시 에이전트 사용

사용자 프롬프트 불필요:
1. 복잡한 기능 요청 - **planner** 에이전트 사용
2. 코드 작성/수정 직후 - **code-reviewer** 에이전트 사용
3. 버그 수정 또는 새 기능 - **tdd-guide** 에이전트 사용
4. 아키텍처 의사결정 - **architect** 에이전트 사용

## 병렬 Task 실행

독립적인 작업에는 항상 병렬 Task 실행 사용:

```markdown
# 좋음: 병렬 실행
3개 에이전트를 병렬로 실행:
1. 에이전트 1: 인증 모듈 보안 분석
2. 에이전트 2: 캐시 시스템 성능 리뷰
3. 에이전트 3: 유틸리티 타입 검사

# 나쁨: 불필요하게 순차 실행
먼저 에이전트 1, 그다음 에이전트 2, 그다음 에이전트 3
```

## 다중 관점 분석

복잡한 문제에는 역할 분리 서브에이전트 사용:
- 사실 검증 리뷰어
- 시니어 엔지니어
- 보안 전문가
- 일관성 검토자
- 중복 검사자