# 서브에이전트 활용 정책

커스텀 에이전트(`.claude/agents/`)를 활용하여 컨텍스트를 보호하고 병렬 작업을 수행한다.
메인 세션은 리더 역할(설계, 조율, 최종 판단)에 집중하고, 실제 작업은 서브에이전트에 위임한다.

## 에이전트 구성

| 에이전트 | 역할 | 자율성 | 모델 |
|----------|------|--------|------|
| explorer | 코드베이스 탐색/분석 (읽기 전용) | 높음 | sonnet |
| implementer | 모듈 단위 코드 구현 | 중간 | sonnet |
| reviewer | 코드 리뷰/품질 검증 (읽기 전용) | 높음 | sonnet |

## 사용 시점

### explorer
- 3개 이상의 파일/디렉토리를 탐색해야 할 때
- 프로젝트 구조나 패턴을 파악할 때
- 의존성 체인, 임포트 관계를 추적할 때

### implementer
- 독립 모듈/컴포넌트를 구현할 때
- 여러 모듈을 병렬로 구현할 때 (각각 별도 implementer)
- 반복 패턴을 여러 파일에 적용할 때

### reviewer
- 구현 완료 후 커밋 전 검증
- MR 생성 전 자체 리뷰
- 변경 범위가 클 때 (5개 이상 파일)

## 사용하지 않는 경우

- 단일 파일의 간단한 수정
- 위치를 이미 아는 코드 수정
- 설정 파일 변경

## 메인 세션 작업 흐름

### 단일 모듈
1. 메인: 계약(인터페이스, 타입) 설계
2. implementer: 계약 기반 구현 + 자체 검증
3. reviewer: 변경 파일 리뷰
4. 메인: 결과 확인 → 커밋

### 다중 모듈 (병렬)
1. 메인: 모듈 간 공유 인터페이스 확정
2. implementer A + B: 각 모듈 동시 구현
3. 메인: 통합 확인 (인터페이스 일치)
4. reviewer: 전체 변경 리뷰
5. 메인: 최종 확인 → 커밋

### 분석
1. explorer: 탐색 영역 + 목적 전달 → 분석 결과 반환
2. 메인: "추정" 항목만 직접 확인 → 판단

## 핵심 원칙

- **읽기 전용 에이전트(explorer/reviewer)**: 결과가 부정확해도 손해 없음 → 높은 자율성 부여
- **쓰기 에이전트(implementer)**: 계약은 고정, 내부 구현은 자율 → 중간 자율성
- **같은 파일을 두 에이전트가 동시에 수정하지 않는다**
- **커밋/푸시는 반드시 메인 세션에서 수행**
