docs(claude): 실제 에이전트 타입으로 수정
변경사항: - coder → general-purpose (Claude Code 표준 에이전트) - reviewer → Explore + general-purpose - explorer → Explore (대문자) - 프로젝트 특성 명시 (TypeScript, Cloudflare Workers) - 사용 가능한 에이전트 타입 명시 이유: - Claude Code의 실제 에이전트 타입 사용 - 프로젝트별 구체적인 에이전트 매핑 - SuperClaude PERSONAS.md의 coder는 이 프로젝트 전용
This commit is contained in:
34
CLAUDE.md
34
CLAUDE.md
@@ -21,18 +21,29 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
|||||||
|
|
||||||
**🎯 목표: 컨텍스트 절약 - 대부분의 작업을 에이전트에 위임**
|
**🎯 목표: 컨텍스트 절약 - 대부분의 작업을 에이전트에 위임**
|
||||||
|
|
||||||
|
**프로젝트 특성:**
|
||||||
|
- 언어: TypeScript (strict mode)
|
||||||
|
- 런타임: Cloudflare Workers
|
||||||
|
- 프레임워크: Wrangler, Workers AI, D1
|
||||||
|
- 주요 디렉토리: `src/tools/`, `src/routes/`, `src/services/`
|
||||||
|
|
||||||
|
**사용 가능한 에이전트 타입:**
|
||||||
|
- `general-purpose`: 범용 작업, 코드 작성/수정
|
||||||
|
- `Explore`: 프로젝트 구조 분석 (thorough 레벨)
|
||||||
|
- `Bash`: 빌드/배포/테스트 실행
|
||||||
|
|
||||||
**CRITICAL: 다음 작업은 반드시 Task tool (agent)를 사용하여 메인 세션 컨텍스트 절약:**
|
**CRITICAL: 다음 작업은 반드시 Task tool (agent)를 사용하여 메인 세션 컨텍스트 절약:**
|
||||||
|
|
||||||
| 작업 유형 | 조건 | 에이전트 타입 | 이유 |
|
| 작업 유형 | 조건 | 에이전트 타입 | 이유 |
|
||||||
|-----------|------|---------------|------|
|
|-----------|------|---------------|------|
|
||||||
| **코드 작성/수정** | 모든 코드 변경 | `coder` | 컨텍스트 절약, 독립 실행 |
|
| **코드 작성/수정** | 모든 코드 변경 | `general-purpose` | 컨텍스트 절약, 독립 실행 |
|
||||||
| **리팩토링** | 파일 수 무관 | `coder` (병렬) | 일관성, 컨텍스트 분리 |
|
| **리팩토링** | 파일 수 무관 | `general-purpose` (병렬) | 일관성, 컨텍스트 분리 |
|
||||||
| **Function Calling 도구** | 추가/수정 | `coder` (병렬) | tools/ + openai-service.ts 동시 처리 |
|
| **Function Calling 도구** | 추가/수정 | `general-purpose` (병렬) | tools/ + openai-service.ts 동시 처리 |
|
||||||
| **스키마 작업** | D1 마이그레이션 | `coder` | 백업→마이그레이션→검증 전체 위임 |
|
| **스키마 작업** | D1 마이그레이션 | `general-purpose` | 백업→마이그레이션→검증 전체 위임 |
|
||||||
| **프로젝트 분석** | 구조 파악 | `explorer` | 대량 파일 읽기 분리 |
|
| **프로젝트 분석** | 구조 파악 | `Explore` (thorough) | 대량 파일 읽기 분리 |
|
||||||
| **코드 리뷰** | 보안/성능 | `reviewer` | 분석 작업 분리 |
|
| **코드 리뷰** | 보안/성능 | `Explore` + `general-purpose` | 분석 후 개선 제안 |
|
||||||
| **빌드/배포** | npm run, wrangler | `coder` | 긴 로그 출력 분리 |
|
| **빌드/배포** | npm run, wrangler | `Bash` | 긴 로그 출력 분리 |
|
||||||
| **테스트** | 로컬 테스트 실행 | `coder` | 테스트 출력 분리 |
|
| **테스트** | 로컬 테스트 실행 | `Bash` | 테스트 출력 분리 |
|
||||||
|
|
||||||
**에이전트 위임의 이점:**
|
**에이전트 위임의 이점:**
|
||||||
- ✅ 각 에이전트가 독립 컨텍스트 사용 (메인 세션 부담 0)
|
- ✅ 각 에이전트가 독립 컨텍스트 사용 (메인 세션 부담 0)
|
||||||
@@ -41,8 +52,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
|||||||
- ✅ 메인 세션은 조율/지시만 담당
|
- ✅ 메인 세션은 조율/지시만 담당
|
||||||
|
|
||||||
**병렬 처리 필수:**
|
**병렬 처리 필수:**
|
||||||
- 독립적인 파일 여러 개 → 병렬 coder 에이전트
|
- 독립적인 파일 여러 개 → 병렬 general-purpose 에이전트
|
||||||
- 다른 디렉토리 동시 작업 → 병렬 coder 에이전트
|
- 다른 디렉토리 동시 작업 → 병렬 general-purpose 에이전트
|
||||||
- Function Calling 도구 추가 → tools/{new}.ts + openai-service.ts 병렬
|
- Function Calling 도구 추가 → tools/{new}.ts + openai-service.ts 병렬
|
||||||
|
|
||||||
**예시:**
|
**예시:**
|
||||||
@@ -54,7 +65,8 @@ Read src/openai-service.ts
|
|||||||
Edit src/openai-service.ts
|
Edit src/openai-service.ts
|
||||||
|
|
||||||
// ✅ 에이전트 사용 (컨텍스트 절약)
|
// ✅ 에이전트 사용 (컨텍스트 절약)
|
||||||
Task (coder 2개 병렬) → 독립 컨텍스트에서 작업 → 요약만 반환
|
Task (subagent_type: "general-purpose", 2개 병렬)
|
||||||
|
→ 독립 컨텍스트에서 작업 → 요약만 반환
|
||||||
```
|
```
|
||||||
|
|
||||||
**직접 처리 (최소화):**
|
**직접 처리 (최소화):**
|
||||||
|
|||||||
Reference in New Issue
Block a user