에이전트 오케스트레이션
다운로드 후
~/.claude/rules/ 폴더에 복사하여 사용하세요에이전트를 효과적으로 사용하는 규칙입니다.
사용 가능한 에이전트
~/.claude/agents/에 위치:
| 에이전트 | 목적 | 사용 시점 |
|---|---|---|
| planner | 구현 계획 | 복잡한 기능, 리팩토링 |
| architect | 시스템 설계 | 아키텍처 결정 |
| tdd-guide | 테스트 주도 개발 | 새 기능, 버그 수정 |
| code-reviewer | 코드 리뷰 | 코드 작성 후 |
| security-reviewer | 보안 분석 | 커밋 전 |
| build-error-resolver | 빌드 오류 수정 | 빌드 실패 시 |
| e2e-runner | E2E 테스트 | 중요 사용자 흐름 |
| refactor-cleaner | 불필요한 코드 정리 | 코드 유지보수 |
| doc-updater | 문서화 | 문서 업데이트 |
즉시 에이전트 사용
🤖
사용자 프롬프트 없이도 다음 상황에서 에이전트를 사용하세요.
| 상황 | 사용할 에이전트 |
|---|---|
| 복잡한 기능 요청 | planner |
| 코드 작성/수정 완료 | code-reviewer |
| 버그 수정 또는 새 기능 | tdd-guide |
| 아키텍처 결정 | architect |
병렬 작업 실행
⚡
독립적인 작업에는 항상 병렬 Task 실행 사용!
# ✅ 좋음: 병렬 실행
3개 에이전트 병렬 실행:
1. 에이전트 1: auth.ts 보안 분석
2. 에이전트 2: 캐시 시스템 성능 리뷰
3. 에이전트 3: utils.ts 타입 검사
# ❌ 나쁨: 불필요한 순차 실행
먼저 에이전트 1, 그 다음 에이전트 2, 그 다음 에이전트 3다중 관점 분석
복잡한 문제에는 역할 분리 서브 에이전트 사용:
- 사실 검토자 - 정보의 정확성 검증
- 시니어 엔지니어 - 기술적 평가
- 보안 전문가 - 보안 취약점 분석
- 일관성 검토자 - 코드베이스 일관성 확인
- 중복 검사자 - 중복 코드 식별
에이전트 사용 우선순위
1. planner → 무엇을 할지 계획
2. architect → 어떻게 할지 설계
3. tdd-guide → 테스트와 함께 구현
4. code-reviewer → 품질 검토
5. security-reviewer → 보안 검토에이전트 체이닝
기능 구현 시:
planner → 계획 수립
↓
architect → 설계 검토
↓
tdd-guide → 테스트 주도 개발
↓
code-reviewer → 품질 검토
↓
security-reviewer → 보안 검토