diff --git a/CLAUDE.md b/CLAUDE.md index d7523ab..7b45ebb 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 **절대 지켜야 할 규칙:**