From c46a7503dcd05b1e92a5d4b7fce9edf241465214 Mon Sep 17 00:00:00 2001
From: kappa <kappa@inouter.com>
Date: Mon, 19 Jan 2026 16:12:21 +0900
Subject: [PATCH] =?UTF-8?q?docs(claude):=20=EC=97=90=EC=9D=B4=EC=A0=84?=
 =?UTF-8?q?=ED=8A=B8=20=EC=82=AC=EC=9A=A9=20=EC=A0=95=EC=B1=85=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 리팩토링, Function Calling 도구 추가 시 병렬 coder 에이전트 필수
- 스키마 마이그레이션, 프로젝트 분석 등 에이전트 타입 명시
- 병렬 처리 권장 시나리오 예시
- 단순 작업은 직접 처리 가이드
---
 CLAUDE.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

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
 
 **절대 지켜야 할 규칙:**