docs(claude): 에이전트 사용 정책 추가

- 리팩토링, Function Calling 도구 추가 시 병렬 coder 에이전트 필수
- 스키마 마이그레이션, 프로젝트 분석 등 에이전트 타입 명시
- 병렬 처리 권장 시나리오 예시
- 단순 작업은 직접 처리 가이드
This commit is contained in:
kappa
2026-01-19 16:12:21 +09:00
parent 8f3f2d533e
commit c46a7503dc

View File

@@ -17,6 +17,42 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
--- ---
## Agent Usage Policy
**다음 작업은 반드시 Task tool (agent)를 사용:**
| 작업 유형 | 조건 | 에이전트 타입 | 이유 |
|-----------|------|---------------|------|
| **리팩토링** | 3개 이상 파일 수정 | `coder` (병렬) | 일관성, 동시 수정 |
| **Function Calling 도구 추가** | tools/ + openai-service.ts | `coder` (병렬) | 불일치 방지 |
| **스키마 마이그레이션** | D1 스키마 변경 | `coder` | 백업→마이그레이션→검증 |
| **프로젝트 분석** | src/ 전체 분석 | `explorer` | 구조 파악 |
| **코드 리뷰** | 보안/성능 분석 | `reviewer` | 체계적 검증 |
| **다중 도구 수정** | 2개 이상 tools/ 파일 | `coder` (병렬) | 동시 작업 |
**병렬 처리 권장:**
- `src/tools/` 디렉토리 내 여러 파일 수정 → 병렬 coder 에이전트
- routes/ + services/ 동시 수정 → 병렬 coder 에이전트
- 독립적인 Function Calling 도구 여러 개 추가 → 병렬 처리
**예시:**
```typescript
// ❌ 직접 수정 (3개 이상 파일)
Edit tools/weather-tool.ts
Edit tools/search-tool.ts
Edit tools/domain-tool.ts
// ✅ 병렬 에이전트 사용
Task (coder 3 )
```
**단순 작업은 직접 처리:**
- 단일 파일 수정 (버그 수정, 작은 기능 추가)
- 설정 파일 업데이트 (wrangler.toml, package.json)
- 문서 업데이트 (README.md, CLAUDE.md)
---
## Critical Rules ## Critical Rules
**절대 지켜야 할 규칙:** **절대 지켜야 할 규칙:**