docs(claude): 에이전트 사용 정책 추가
- 리팩토링, Function Calling 도구 추가 시 병렬 coder 에이전트 필수 - 스키마 마이그레이션, 프로젝트 분석 등 에이전트 타입 명시 - 병렬 처리 권장 시나리오 예시 - 단순 작업은 직접 처리 가이드
This commit is contained in:
36
CLAUDE.md
36
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
|
||||
|
||||
**절대 지켜야 할 규칙:**
|
||||
|
||||
Reference in New Issue
Block a user