agents

에이전트 오케스트레이션

사용 가능한 에이전트

~/.claude/agents/ 위치:

에이전트	목적	사용 시점
planner	구현 계획 수립	복잡한 기능 개발, 리팩토링
architect	시스템 설계	아키텍처 의사결정
tdd-guide	테스트 주도 개발	새로운 기능, 버그 수정
code-reviewer	코드 리뷰	코드 작성 후
security-reviewer	보안 분석	커밋 전
build-error-resolver	빌드 오류 해결	빌드 실패 시
e2e-runner	E2E 테스트	핵심 사용자 흐름 검증
refactor-cleaner	죽은 코드 정리	코드 유지보수
doc-updater	문서화	문서 업데이트

즉각적인 에이전트 사용

사용자 요청 없이도 사용해야 할 때:

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

병렬 작업 실행

독립적인 작업에 대해서는 항상 병렬 작업 실행을 사용하세요:

# 좋음: 병렬 실행
3개의 에이전트를 병렬로 실행:
1. 에이전트 1: auth.ts 보안 분석
2. 에이전트 2: 캐시 시스템 성능 검토
3. 에이전트 3: utils.ts 타입 검사

# 나쁨: 불필요한 순차 실행
에이전트 1 실행 후, 에이전트 2, 그 다음 에이전트 3

다각적 관점 분석

복잡한 문제의 경우, 역할을 분담한 서브 에이전트를 사용하세요:

• 사실 검증 검토자
• 시니어 엔지니어
• 보안 전문가
• 일관성 검토자
• 중복 검사자