From 9b633ea38b3df6e9798f432c1a6e9d3196deac07 Mon Sep 17 00:00:00 2001 From: kappa Date: Mon, 19 Jan 2026 16:18:41 +0900 Subject: [PATCH] =?UTF-8?q?docs(claude):=20=EC=8B=A4=EC=A0=9C=20=EC=97=90?= =?UTF-8?q?=EC=9D=B4=EC=A0=84=ED=8A=B8=20=ED=83=80=EC=9E=85=EC=9C=BC?= =?UTF-8?q?=EB=A1=9C=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 변경사항: - coder → general-purpose (Claude Code 표준 에이전트) - reviewer → Explore + general-purpose - explorer → Explore (대문자) - 프로젝트 특성 명시 (TypeScript, Cloudflare Workers) - 사용 가능한 에이전트 타입 명시 이유: - Claude Code의 실제 에이전트 타입 사용 - 프로젝트별 구체적인 에이전트 매핑 - SuperClaude PERSONAS.md의 coder는 이 프로젝트 전용 --- CLAUDE.md | 34 +++++++++++++++++++++++----------- 1 file changed, 23 insertions(+), 11 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 8dba276..1521f73 100644 --- a/CLAUDE.md +++ b/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)를 사용하여 메인 세션 컨텍스트 절약:** | 작업 유형 | 조건 | 에이전트 타입 | 이유 | |-----------|------|---------------|------| -| **코드 작성/수정** | 모든 코드 변경 | `coder` | 컨텍스트 절약, 독립 실행 | -| **리팩토링** | 파일 수 무관 | `coder` (병렬) | 일관성, 컨텍스트 분리 | -| **Function Calling 도구** | 추가/수정 | `coder` (병렬) | tools/ + openai-service.ts 동시 처리 | -| **스키마 작업** | D1 마이그레이션 | `coder` | 백업→마이그레이션→검증 전체 위임 | -| **프로젝트 분석** | 구조 파악 | `explorer` | 대량 파일 읽기 분리 | -| **코드 리뷰** | 보안/성능 | `reviewer` | 분석 작업 분리 | -| **빌드/배포** | npm run, wrangler | `coder` | 긴 로그 출력 분리 | -| **테스트** | 로컬 테스트 실행 | `coder` | 테스트 출력 분리 | +| **코드 작성/수정** | 모든 코드 변경 | `general-purpose` | 컨텍스트 절약, 독립 실행 | +| **리팩토링** | 파일 수 무관 | `general-purpose` (병렬) | 일관성, 컨텍스트 분리 | +| **Function Calling 도구** | 추가/수정 | `general-purpose` (병렬) | tools/ + openai-service.ts 동시 처리 | +| **스키마 작업** | D1 마이그레이션 | `general-purpose` | 백업→마이그레이션→검증 전체 위임 | +| **프로젝트 분석** | 구조 파악 | `Explore` (thorough) | 대량 파일 읽기 분리 | +| **코드 리뷰** | 보안/성능 | `Explore` + `general-purpose` | 분석 후 개선 제안 | +| **빌드/배포** | npm run, wrangler | `Bash` | 긴 로그 출력 분리 | +| **테스트** | 로컬 테스트 실행 | `Bash` | 테스트 출력 분리 | **에이전트 위임의 이점:** - ✅ 각 에이전트가 독립 컨텍스트 사용 (메인 세션 부담 0) @@ -41,8 +52,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co - ✅ 메인 세션은 조율/지시만 담당 **병렬 처리 필수:** -- 독립적인 파일 여러 개 → 병렬 coder 에이전트 -- 다른 디렉토리 동시 작업 → 병렬 coder 에이전트 +- 독립적인 파일 여러 개 → 병렬 general-purpose 에이전트 +- 다른 디렉토리 동시 작업 → 병렬 general-purpose 에이전트 - Function Calling 도구 추가 → tools/{new}.ts + openai-service.ts 병렬 **예시:** @@ -54,7 +65,8 @@ Read src/openai-service.ts Edit src/openai-service.ts // ✅ 에이전트 사용 (컨텍스트 절약) -Task (coder 2개 병렬) → 독립 컨텍스트에서 작업 → 요약만 반환 +Task (subagent_type: "general-purpose", 2개 병렬) + → 독립 컨텍스트에서 작업 → 요약만 반환 ``` **직접 처리 (최소화):**