htlee
ed7620285b
- explorer: 코드베이스 탐색/분석 (sonnet, 읽기 전용, 높은 자율성) - implementer: 모듈 단위 구현 (sonnet, 계약 기반, 중간 자율성) - reviewer: 코드 리뷰/품질 검증 (sonnet, 체크리스트 기반, 높은 자율성) - subagent-policy.md: 서브에이전트 활용 정책 rules 추가 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2.2 KiB
2.2 KiB
서브에이전트 활용 정책
커스텀 에이전트(.claude/agents/)를 활용하여 컨텍스트를 보호하고 병렬 작업을 수행한다.
메인 세션은 리더 역할(설계, 조율, 최종 판단)에 집중하고, 실제 작업은 서브에이전트에 위임한다.
에이전트 구성
| 에이전트 | 역할 | 자율성 | 모델 |
|---|---|---|---|
| explorer | 코드베이스 탐색/분석 (읽기 전용) | 높음 | sonnet |
| implementer | 모듈 단위 코드 구현 | 중간 | sonnet |
| reviewer | 코드 리뷰/품질 검증 (읽기 전용) | 높음 | sonnet |
사용 시점
explorer
- 3개 이상의 파일/디렉토리를 탐색해야 할 때
- 프로젝트 구조나 패턴을 파악할 때
- 의존성 체인, 임포트 관계를 추적할 때
implementer
- 독립 모듈/컴포넌트를 구현할 때
- 여러 모듈을 병렬로 구현할 때 (각각 별도 implementer)
- 반복 패턴을 여러 파일에 적용할 때
reviewer
- 구현 완료 후 커밋 전 검증
- MR 생성 전 자체 리뷰
- 변경 범위가 클 때 (5개 이상 파일)
사용하지 않는 경우
- 단일 파일의 간단한 수정
- 위치를 이미 아는 코드 수정
- 설정 파일 변경
메인 세션 작업 흐름
단일 모듈
- 메인: 계약(인터페이스, 타입) 설계
- implementer: 계약 기반 구현 + 자체 검증
- reviewer: 변경 파일 리뷰
- 메인: 결과 확인 → 커밋
다중 모듈 (병렬)
- 메인: 모듈 간 공유 인터페이스 확정
- implementer A + B: 각 모듈 동시 구현
- 메인: 통합 확인 (인터페이스 일치)
- reviewer: 전체 변경 리뷰
- 메인: 최종 확인 → 커밋
분석
- explorer: 탐색 영역 + 목적 전달 → 분석 결과 반환
- 메인: "추정" 항목만 직접 확인 → 판단
핵심 원칙
- 읽기 전용 에이전트(explorer/reviewer): 결과가 부정확해도 손해 없음 → 높은 자율성 부여
- 쓰기 에이전트(implementer): 계약은 고정, 내부 구현은 자율 → 중간 자율성
- 같은 파일을 두 에이전트가 동시에 수정하지 않는다
- 커밋/푸시는 반드시 메인 세션에서 수행