htlee
ffde4d6694
- 에이전트 파일 YAML frontmatter 형식 갱신 (explorer, implementer, reviewer) - subagent-policy.md 규칙 추가 - commit-msg hook 패턴 간소화 - COMMON-GUIDE.md API 연동 가이드 보강 - MOCK-TO-API-GUIDE.md mock→API 전환 가이드 추가 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
62 lines
2.2 KiB
Markdown
62 lines
2.2 KiB
Markdown
# 서브에이전트 활용 정책
|
|
|
|
커스텀 에이전트(`.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)**: 계약은 고정, 내부 구현은 자율 → 중간 자율성
|
|
- **같은 파일을 두 에이전트가 동시에 수정하지 않는다**
|
|
- **커밋/푸시는 반드시 메인 세션에서 수행**
|