docs(claude): 컨텍스트 절약을 위한 에이전트 위임 정책 강화

목표: 메인 세션 컨텍스트 절약

변경사항:
- CRITICAL: 모든 코드 작성/수정 작업은 에이전트 사용 필수
- 빌드/배포/테스트도 에이전트로 분리
- 각 에이전트가 독립 컨텍스트 사용 → 요약만 반환
- 메인 세션은 조율/지시만 담당

이유:
- 복잡한 프로젝트에서 컨텍스트 압박 방지
- 토큰 사용량 대폭 절감
- 병렬 처리로 시간 단축

CLAUDE.md

@@ -19,37 +19,48 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Agent Usage Policy
 
-**다음 작업은 반드시 Task tool (agent)를 사용:**
+**🎯 목표: 컨텍스트 절약 - 대부분의 작업을 에이전트에 위임**
+
+**CRITICAL: 다음 작업은 반드시 Task tool (agent)를 사용하여 메인 세션 컨텍스트 절약:**
 
 | 작업 유형 | 조건 | 에이전트 타입 | 이유 |
 |-----------|------|---------------|------|
-| **리팩토링** | 3개 이상 파일 수정 | `coder` (병렬) | 일관성, 동시 수정 |
+| **코드 작성/수정** | 모든 코드 변경 | `coder` | 컨텍스트 절약, 독립 실행 |
-| **Function Calling 도구 추가** | tools/ + openai-service.ts | `coder` (병렬) | 불일치 방지 |
+| **리팩토링** | 파일 수 무관 | `coder` (병렬) | 일관성, 컨텍스트 분리 |
-| **스키마 마이그레이션** | D1 스키마 변경 | `coder` | 백업→마이그레이션→검증 |
+| **Function Calling 도구** | 추가/수정 | `coder` (병렬) | tools/ + openai-service.ts 동시 처리 |
-| **프로젝트 분석** | src/ 전체 분석 | `explorer` | 구조 파악 |
+| **스키마 작업** | D1 마이그레이션 | `coder` | 백업→마이그레이션→검증 전체 위임 |
-| **코드 리뷰** | 보안/성능 분석 | `reviewer` | 체계적 검증 |
+| **프로젝트 분석** | 구조 파악 | `explorer` | 대량 파일 읽기 분리 |
-| **다중 도구 수정** | 2개 이상 tools/ 파일 | `coder` (병렬) | 동시 작업 |
+| **코드 리뷰** | 보안/성능 | `reviewer` | 분석 작업 분리 |
+| **빌드/배포** | npm run, wrangler | `coder` | 긴 로그 출력 분리 |
+| **테스트** | 로컬 테스트 실행 | `coder` | 테스트 출력 분리 |
 
-**병렬 처리 권장:**
+**에이전트 위임의 이점:**
-- `src/tools/` 디렉토리 내 여러 파일 수정 → 병렬 coder 에이전트
+- ✅ 각 에이전트가 독립 컨텍스트 사용 (메인 세션 부담 0)
-- routes/ + services/ 동시 수정 → 병렬 coder 에이전트
+- ✅ 요약만 메인 세션에 반환 (토큰 대폭 절약)
-- 독립적인 Function Calling 도구 여러 개 추가 → 병렬 처리
+- ✅ 병렬 처리 가능 (시간 단축)
+- ✅ 메인 세션은 조율/지시만 담당
+
+**병렬 처리 필수:**
+- 독립적인 파일 여러 개 → 병렬 coder 에이전트
+- 다른 디렉토리 동시 작업 → 병렬 coder 에이전트
+- Function Calling 도구 추가 → tools/{new}.ts + openai-service.ts 병렬
 
 **예시:**
 ```typescript
-// ❌ 직접 수정 (3개 이상 파일)
+// ❌ 직접 수정 (컨텍스트 소모)
-Edit tools/weather-tool.ts
+Read src/tools/weather-tool.ts
-Edit tools/search-tool.ts
+Edit src/tools/weather-tool.ts
-Edit tools/domain-tool.ts
+Read src/openai-service.ts
+Edit src/openai-service.ts
 
-// ✅ 병렬 에이전트 사용
+// ✅ 에이전트 사용 (컨텍스트 절약)
-Task (coder 3개 병렬) → 각 도구 동시 수정
+Task (coder 2개 병렬) → 독립 컨텍스트에서 작업 → 요약만 반환
 ```
 
-**단순 작업은 직접 처리:**
+**직접 처리 (최소화):**
-- 단일 파일 수정 (버그 수정, 작은 기능 추가)
+- 간단한 문서 읽기 (README.md 확인)
-- 설정 파일 업데이트 (wrangler.toml, package.json)
+- 사용자와의 대화/질문
-- 문서 업데이트 (README.md, CLAUDE.md)
+- 에이전트 작업 조율/검토
 
 ---