@choblue/claude-code-toolkit 1.2.0 → 1.2.2

package/.claude/.project-map-cache

@@ -1 +1 @@
-c4f4456d258ba2495e49caea5ceb3690f7ab2732
+af82e0967a0412bdcaa636fa0ab9e4f750d49608

package/.claude/CLAUDE.md

@@ -46,10 +46,12 @@ TDD/Review를 생략하고 핵심 단계만 수행한다.
 3. **Commit**: `git-manager`로 커밋/PR 생성
 
 ### L 티어 (complex)
-풀 프로세스를 따른다.
-1. **Planning**: 요구사항 정리 → `explore`로 탐색 → 사용자 승인
-2. **Implementation + Test**: `implementer`에 구현+테스트 동시 위임 → 테스트 통과 확인
-3. **Review**: `code-reviewer`로 리뷰 → `git-manager`로 커밋/PR
+파일 기반 설계 후 구현한다.
+1. **Research**: `explore`로 탐색 → `research.md` 작성 (관련 코드 분석, 제약 조건)
+2. **Plan**: `plan.md` 작성 (접근 방식, 변경 파일, 트레이드 오프, 작업 순서)
+3. **주석 사이클**: 사용자가 plan.md에 메모 → 반영 → **승인 전까지 구현 금지**
+4. **Implementation + Test**: `implementer`에 plan.md 전달하여 구현+테스트 동시 위임
+5. **Review**: `code-reviewer`로 리뷰 → `git-manager`로 커밋/PR
 
 ### 풀스택 작업 (FE + BE 동시 변경)
 티어는 영향도 기준으로 판단하되, 위임 순서는 BE 선행 → FE 후행을 따른다.

package/.claude/skills/Planning/SKILL.md

@@ -13,32 +13,65 @@
 3. **설계 결정**: 새로운 아키텍처/패턴 도입이 필요한가? → Yes면 L
 4. **위 모두 No**: 파일 수와 변경 단순성으로 S/M 판단
 
-## 2. 작업 분해 템플릿
+## 2. L 티어 Planning: 파일 기반 설계
 
-### 요구사항 정리
-- [ ] 사용자가 원하는 최종 결과물은?
-- [ ] 변경되는 레이어는? (UI / API / Domain / DB)
-- [ ] 기존 코드에 영향을 주는 범위는?
+L 티어는 채팅이 아닌 **파일 기반**으로 설계를 진행한다. 세션이 끝나도 기록이 남고, 사용자가 에디터에서 직접 수정할 수 있다.
 
-### 작업 단위 분해
-각 작업 단위는 **독립적으로 테스트 가능한 단위**로 나눈다:
-```
-1. [작업명] - [대상 파일/모듈] - [티어]
-2. [작업명] - [대상 파일/모듈] - [티어]
+### Step 1: research.md 작성
+관련 코드베이스를 **깊이 분석**하여 파일로 작성한다.
+```markdown
+# Research: [기능명]
+
+## 관련 코드 분석
+- [파일경로]: [역할 및 현재 동작]
+
+## 기존 패턴
+- [프로젝트에서 사용 중인 관련 패턴]
+
+## 제약 조건
+- [기술적 제약, 호환성 이슈 등]
 ```
 
-### 의존성 확인
-- [ ] 작업 간 순서 의존성이 있는가? (예: BE API 먼저 → FE 연동)
-- [ ] 외부 의존성이 있는가? (패키지 설치, DB 마이그레이션 등)
+### Step 2: plan.md 작성
+research 기반으로 구현 계획을 작성한다.
+```markdown
+# Plan: [기능명]
+
+## 접근 방식
+- [선택한 방식과 이유]
+
+## 변경 파일
+- `path/to/file.ts` - [변경 내용]
+
+## 트레이드 오프
+- [장점] vs [단점]
 
-## 3. 계획 출력 형식
+## 작업 순서
+1. [작업] → [담당 에이전트]
+2. [작업] → [담당 에이전트]
+```
 
-사용자에게 계획을 제시할 때 다음 형식을 따른다:
+### Step 3: 주석 사이클
+1. 사용자가 plan.md를 에디터에서 열어 메모/수정을 남긴다
+2. Claude가 메모를 반영하여 plan.md를 업데이트한다
+3. **사용자가 승인할 때까지 구현하지 않는다**
+4. 승인 후 implementer 에이전트에 plan.md를 전달하여 구현한다
 
+## 3. M 티어 Planning: 채팅 기반
+
+M 티어는 파일 없이 채팅에서 간단히 계획을 제시한다:
 ```
-**티어**: S / M / L
+**티어**: M
 **변경 범위**: [레이어 목록]
 **작업 목록**:
 1. [작업] → [담당 에이전트]
 2. [작업] → [담당 에이전트]
-```
+```
+
+## 4. 작업 분해 체크리스트
+
+- [ ] 사용자가 원하는 최종 결과물은?
+- [ ] 변경되는 레이어는? (UI / API / Domain / DB)
+- [ ] 기존 코드에 영향을 주는 범위는?
+- [ ] 작업 간 순서 의존성이 있는가?
+- [ ] 외부 의존성이 있는가? (패키지 설치, DB 마이그레이션 등)

package/install.sh

@@ -237,6 +237,7 @@ copy_common() {
   copy_file "skills/Coding/SKILL.md"
   copy_dir "skills/TypeScript"
   copy_dir "skills/Git"
+  copy_dir "skills/Planning"
   copy_file "skills/TDD/SKILL.md"
 
   # hooks
@@ -254,7 +255,7 @@ copy_fe() {
 
   # FE 에이전트
   copy_file "agents/code-writer-fe.md"
-  copy_file "agents/test-writer-fe.md"
+  copy_file "agents/implementer-fe.md"
 
   # FE 스킬 (디렉토리 전체)
   copy_dir "skills/React"
@@ -275,7 +276,7 @@ copy_be() {
 
   # BE 에이전트
   copy_file "agents/code-writer-be.md"
-  copy_file "agents/test-writer-be.md"
+  copy_file "agents/implementer-be.md"
 
   # BE 스킬 (디렉토리 전체)
   copy_dir "skills/TypeORM"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@choblue/claude-code-toolkit",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Claude Code 서브에이전트 위임 툴킷 - npx로 바로 설치",
   "bin": {
     "claude-code-toolkit": "bin/cli.js"