diff --git a/CLAUDE.md b/CLAUDE.md index 7b45ebb..8dba276 100644 --- a/CLAUDE.md +++ b/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` (병렬) | 일관성, 동시 수정 | -| **Function Calling 도구 추가** | tools/ + openai-service.ts | `coder` (병렬) | 불일치 방지 | -| **스키마 마이그레이션** | D1 스키마 변경 | `coder` | 백업→마이그레이션→검증 | -| **프로젝트 분석** | src/ 전체 분석 | `explorer` | 구조 파악 | -| **코드 리뷰** | 보안/성능 분석 | `reviewer` | 체계적 검증 | -| **다중 도구 수정** | 2개 이상 tools/ 파일 | `coder` (병렬) | 동시 작업 | +| **코드 작성/수정** | 모든 코드 변경 | `coder` | 컨텍스트 절약, 독립 실행 | +| **리팩토링** | 파일 수 무관 | `coder` (병렬) | 일관성, 컨텍스트 분리 | +| **Function Calling 도구** | 추가/수정 | `coder` (병렬) | tools/ + openai-service.ts 동시 처리 | +| **스키마 작업** | D1 마이그레이션 | `coder` | 백업→마이그레이션→검증 전체 위임 | +| **프로젝트 분석** | 구조 파악 | `explorer` | 대량 파일 읽기 분리 | +| **코드 리뷰** | 보안/성능 | `reviewer` | 분석 작업 분리 | +| **빌드/배포** | npm run, wrangler | `coder` | 긴 로그 출력 분리 | +| **테스트** | 로컬 테스트 실행 | `coder` | 테스트 출력 분리 | -**병렬 처리 권장:** -- `src/tools/` 디렉토리 내 여러 파일 수정 → 병렬 coder 에이전트 -- routes/ + services/ 동시 수정 → 병렬 coder 에이전트 -- 독립적인 Function Calling 도구 여러 개 추가 → 병렬 처리 +**에이전트 위임의 이점:** +- ✅ 각 에이전트가 독립 컨텍스트 사용 (메인 세션 부담 0) +- ✅ 요약만 메인 세션에 반환 (토큰 대폭 절약) +- ✅ 병렬 처리 가능 (시간 단축) +- ✅ 메인 세션은 조율/지시만 담당 + +**병렬 처리 필수:** +- 독립적인 파일 여러 개 → 병렬 coder 에이전트 +- 다른 디렉토리 동시 작업 → 병렬 coder 에이전트 +- Function Calling 도구 추가 → tools/{new}.ts + openai-service.ts 병렬 **예시:** ```typescript -// ❌ 직접 수정 (3개 이상 파일) -Edit tools/weather-tool.ts -Edit tools/search-tool.ts -Edit tools/domain-tool.ts +// ❌ 직접 수정 (컨텍스트 소모) +Read src/tools/weather-tool.ts +Edit src/tools/weather-tool.ts +Read src/openai-service.ts +Edit src/openai-service.ts -// ✅ 병렬 에이전트 사용 -Task (coder 3개 병렬) → 각 도구 동시 수정 +// ✅ 에이전트 사용 (컨텍스트 절약) +Task (coder 2개 병렬) → 독립 컨텍스트에서 작업 → 요약만 반환 ``` -**단순 작업은 직접 처리:** -- 단일 파일 수정 (버그 수정, 작은 기능 추가) -- 설정 파일 업데이트 (wrangler.toml, package.json) -- 문서 업데이트 (README.md, CLAUDE.md) +**직접 처리 (최소화):** +- 간단한 문서 읽기 (README.md 확인) +- 사용자와의 대화/질문 +- 에이전트 작업 조율/검토 ---