@kood/claude-code 0.5.3 → 0.5.4

package/templates/.claude/skills/plan/SKILL.md

@@ -47,7 +47,7 @@ Task({
 
 - 2-3개 옵션 제시 (장단점, 영향 범위)
 - 추천안 및 근거
-- 선택 후 `.claude/plans/[기능명]-{timestamp}/` 폴더에 여러 문서 자동 생성
+- 선택 후 `.claude/plans/00.[기능명]/` 폴더에 여러 문서 자동 생성
   - OVERVIEW.md, OPTIONS.md, IMPLEMENTATION.md, RISKS.md, REFERENCES.md
 
 </when_to_use>
@@ -634,7 +634,7 @@ Task({
   `
 })
 
-// → 각 모듈별 .claude/plans/ 문서 생성
+// → 각 모듈별 .claude/plans/00.User_모듈/, 01.Payment_모듈/ 문서 생성
 ```
 
 **예시 3: 실시간 기능 기술 조사 (조사 병렬)**
@@ -1019,6 +1019,7 @@ Task({
 | 3. 옵션 도출 | 가능한 접근 4-5개 → 주요 2-3개 선정 | sequentialthinking (2-6단계) |
 | 4. 옵션 제시 | 장단점, 영향 범위, 추천안 제시 | - |
 | 5. 문서 생성 | 옵션 선택 대기 후 계획 문서 병렬 생성 | Task (document-writer) 병렬 |
+| 6. 구현 시작 | 문서 완료 즉시 구현 진행 (확인 불필요) | Skill (execute) |
 
 ### Agent 선택 기준
 
@@ -1046,10 +1047,10 @@ Task({
 
 ### 폴더 구조
 
-옵션 선택 후 `.claude/plans/[기능명]-{timestamp}/` 폴더 생성:
+옵션 선택 후 `.claude/plans/00.[기능명]/` 폴더 생성:
 
 ```
-.claude/plans/realtime-notification-2026-01-24_14-30/
+.claude/plans/00.실시간_알림/
 ├── OVERVIEW.md        # 개요, 현재 상태, 선택된 옵션
 ├── OPTIONS.md         # 모든 옵션 비교 분석 (장단점, 영향 범위)
 ├── IMPLEMENTATION.md  # 구현 단계 상세 계획
@@ -1057,7 +1058,8 @@ Task({
 └── REFERENCES.md      # 참조 자료, 코드베이스 분석 결과
 ```
 
-**폴더명 형식:** `[기능명]-YYYY-MM-DD_HH-MM`
+**폴더명 형식:** `00.[기능명]` (넘버링 + 한글 설명, 언더스코어로 구분)
+**넘버링:** 기존 plans 폴더 목록 조회 → 다음 번호 자동 부여 (00, 01, 02...)
 
 ### 문서 역할
 
@@ -1376,26 +1378,34 @@ Write({ file_path: "OPTIONS.md", ... })   // 대기...
 ### 병렬 생성 워크플로우
 
 ```text
-1. 폴더 생성: .claude/plans/[기능명]-{YYYY-MM-DD_HH-MM}/
-2. document-writer 에이전트 5개 병렬 호출
+1. 넘버링 결정: ls .claude/plans/ → 다음 번호 자동 부여
+2. 폴더 생성: .claude/plans/00.[기능명]/
+3. document-writer 에이전트 5개 병렬 호출
    - OVERVIEW.md (haiku)
    - OPTIONS.md (haiku)
    - IMPLEMENTATION.md (sonnet)
    - RISKS.md (haiku)
    - REFERENCES.md (haiku)
-3. 모든 에이전트 완료 대기
-4. 사용자에게 폴더 경로 안내
+4. 모든 에이전트 완료 대기
+5. 사용자에게 폴더 경로 안내
+6. /execute 스킬 즉시 호출 (확인 불필요)
+   - IMPLEMENTATION.md 기반 자동 구현 시작
 ```
 
 ### 에이전트 호출 예시
 
 ```typescript
 // 옵션 선택 후 실행
-const projectName = "realtime-notification"
-const timestamp = "2026-01-24_14-30"
-const basePath = `.claude/plans/${projectName}-${timestamp}`
+// 1. 넘버링 결정
+Bash("ls .claude/plans/ | grep -E '^[0-9]+' | wc -l")
+const nextNumber = "00" // 결과 기반 계산
+const projectName = "실시간_알림"
+const basePath = `.claude/plans/${nextNumber}.${projectName}`
 
-// 5개 문서 병렬 생성
+// 2. 폴더 생성
+Bash(`mkdir -p ${basePath}`)
+
+// 3. 5개 문서 병렬 생성
 Task({
   subagent_type: 'document-writer',
   model: 'haiku',
@@ -1467,6 +1477,51 @@ Task({
 
 ---
 
+<auto_implementation>
+
+## 자동 구현 시작
+
+계획 문서 생성 완료 후 **사용자 확인 없이** 즉시 구현을 시작합니다.
+
+### 워크플로우
+
+```text
+1. 계획 문서 병렬 생성 완료
+2. IMPLEMENTATION.md 존재 확인
+3. /execute 스킬 즉시 호출
+4. 1단계부터 순차 구현
+```
+
+### 구현 시작 패턴
+
+```typescript
+// 문서 생성 완료 후 즉시 실행
+Skill({
+  skill: 'execute',
+  args: `@.claude/plans/${nextNumber}.${projectName}/IMPLEMENTATION.md 1단계부터 구현`
+})
+```
+
+### 금지 사항
+
+```text
+❌ "구현을 시작할까요?" 물어보기
+❌ "어떤 방식으로 진행할까요?" 선택지 제시
+❌ 사용자 확인 대기
+```
+
+### 허용 사항
+
+```text
+✅ 문서 생성 완료 즉시 /execute 호출
+✅ IMPLEMENTATION.md 1단계부터 자동 시작
+✅ 구현 중 문제 발생 시에만 사용자 확인
+```
+
+</auto_implementation>
+
+---
+
 <examples>
 
 ## 실전 예시
@@ -1491,7 +1546,7 @@ Task({
 3. planner agent 프로세스:
    - 인터뷰: 요구사항, 제약사항, 리스크 허용도 파악
    - 코드베이스 조사: Explore agent로 현재 구조 분석
-   - 계획 생성: .claude/plans/session-auth-{timestamp}/
+   - 계획 생성: .claude/plans/00.세션_인증/
    - 5개 문서 병렬 생성 (OVERVIEW, OPTIONS, IMPLEMENTATION, RISKS, REFERENCES)
    - 사용자 확인 후 핸드오프
 
@@ -1529,12 +1584,17 @@ Task({
 4. 사용자 선택: 1
 
 5. document-writer 에이전트 5개 병렬 호출로 문서 생성
-   - .claude/plans/realtime-notification-2026-01-24_14-30/
+   - .claude/plans/00.실시간_알림/
      ├── OVERVIEW.md
      ├── OPTIONS.md
      ├── IMPLEMENTATION.md
      ├── RISKS.md
      └── REFERENCES.md
+
+6. 구현 자동 시작:
+   Skill({ skill: 'execute' })
+   - IMPLEMENTATION.md 읽고 1단계부터 구현
+   - 확인 절차 없이 즉시 진행
 ```
 
 ### 예시 3: 간단한 리팩토링
@@ -1561,6 +1621,11 @@ Task({
    - 단점: 테스트 필요
 
 4. 사용자 선택 → document-writer 에이전트 병렬 호출로 계획 문서 생성
+   - .claude/plans/00.타입스크립트_전환/
+
+5. 구현 자동 시작:
+   Skill({ skill: 'execute' })
+   - 계획 문서 기반 즉시 구현
 ```
 
 </examples>
@@ -1579,8 +1644,9 @@ Task({
 ✅ 옵션 최소 2개, 권장 3개
 ✅ 각 옵션에 장단점 명시
 ✅ 영향 범위 및 예상 작업량 제시
+✅ 넘버링 자동 결정 (ls .claude/plans/)
 ✅ document-writer 에이전트 병렬 호출로 문서 생성
-✅ .claude/plans/[기능명]-{timestamp}/ 폴더 구조 사용
+✅ .claude/plans/00.[기능명]/ 폴더 구조 사용 (한글 설명)
 ```
 
 절대 금지:
@@ -1590,9 +1656,9 @@ Task({
 ❌ Sequential Thinking 3단계 미만
 ❌ 옵션 1개만 제시
 ❌ 코드 탐색 없이 추측으로 옵션 제시
-❌ 사용자 선택 없이 구현 시작
 ❌ 장단점 없이 옵션만 나열
 ❌ 단일 파일로 문서 생성 (여러 파일로 분리 필수)
+❌ 문서 생성 후 "구현을 시작할까요?" 물어보기 (즉시 진행)
 ```
 
 </validation>

package/templates/.claude/skills/ralph/SKILL.md

@@ -537,17 +537,18 @@ Task(subagent_type="ko-to-en-translator", model="haiku",
 
 ### 문서화 폴더 구조
 
-세션 시작 시 `.claude/ralph/{timestamp}/` 폴더 생성:
+세션 시작 시 `.claude/ralph/00.[작업명]/` 폴더 생성:
 
 ```
-.claude/ralph/2026-01-23_14-30/
+.claude/ralph/00.사용자_인증_구현/
 ├── TASKS.md          # 작업 체크리스트
 ├── PROCESS.md        # 진행 단계 및 의사결정
 ├── VERIFICATION.md   # 검증 결과 기록
 └── NOTES.md          # 추가 메모
 ```
 
-**폴더명 형식:** `YYYY-MM-DD_HH-MM`
+**폴더명 형식:** `00.[작업명]` (넘버링 + 한글 설명, 언더스코어로 구분)
+**넘버링:** 기존 ralph 폴더 목록 조회 → 다음 번호 자동 부여 (00, 01, 02...)
 
 ### 문서 역할
 
@@ -680,7 +681,7 @@ Context compaction 후 세션 재개 시:
 
 ```text
 1. pwd 실행 → 작업 디렉토리 확인
-2. ls .claude/ralph/ → 최신 세션 폴더 식별
+2. ls .claude/ralph/ → 최신 세션 폴더 식별 (가장 큰 번호)
 3. TASKS.md 읽기 → 요구사항 및 진행 상태 파악
 4. PROCESS.md 읽기 → 현재 Phase 및 다음 단계 확인
 5. VERIFICATION.md 읽기 → 검증 결과 확인
@@ -700,12 +701,13 @@ Context compaction 후 세션 재개 시:
 
 ```text
 1. 원본 작업 요구사항 분석
-2. .claude/ralph/{timestamp}/ 폴더 생성
-3. TASKS.md 작성 (체크리스트)
-4. PROCESS.md 작성 (Phase 1 시작 기록)
-5. 구현 실행 (병렬/백그라운드 활용)
-6. 각 요구사항 완료 시 TASKS.md 업데이트
-7. 주요 의사결정 시 PROCESS.md 기록
+2. 넘버링 결정 (ls .claude/ralph/)
+3. .claude/ralph/00.[작업명]/ 폴더 생성 (한글 설명)
+4. TASKS.md 작성 (체크리스트)
+5. PROCESS.md 작성 (Phase 1 시작 기록)
+6. 구현 실행 (병렬/백그라운드 활용)
+7. 각 요구사항 완료 시 TASKS.md 업데이트
+8. 주요 의사결정 시 PROCESS.md 기록
 ```
 
 **병렬 에이전트 활용 예시:**
@@ -1045,16 +1047,17 @@ Task(subagent_type="code-reviewer", model="opus", ...)
 [RALPH MODE ON - 작업 시작]
 ```
 1. 원본 작업(`{{PROMPT}}`) 읽기
-2. `.claude/ralph/{YYYY-MM-DD_HH-MM}/` 폴더 생성
-3. TASKS.md, PROCESS.md, VERIFICATION.md 초기화
-4. 요구사항 분석 후 TASKS.md에 체크리스트 작성
+2. 넘버링 결정 (ls .claude/ralph/ → 다음 번호 자동 부여)
+3. `.claude/ralph/00.[작업명]/` 폴더 생성 (한글 설명)
+4. TASKS.md, PROCESS.md, VERIFICATION.md 초기화
+5. 요구사항 분석 후 TASKS.md에 체크리스트 작성
 
 **Context Compaction 후 재개:**
 ```
 [RALPH MODE ON - 작업 재개]
 ```
 1. `pwd` → 작업 디렉토리 확인
-2. `ls .claude/ralph/` → 최신 세션 폴더 찾기
+2. `ls .claude/ralph/` → 최신 세션 폴더 찾기 (가장 큰 번호)
 3. TASKS.md 읽기 → 요구사항 및 완료 상태
 4. PROCESS.md 읽기 → 현재 Phase 및 다음 단계
 5. VERIFICATION.md 읽기 → 검증 결과

package/templates/.claude/skills/refactor/AGENTS.md

@@ -0,0 +1,269 @@
+# Refactor Skill - Agents
+
+## refactor-advisor
+
+**역할:** 코드 품질 개선을 위한 리팩토링 계획 수립 및 조언 (READ-ONLY)
+
+**도구:**
+- Read: 코드 파일 읽기
+- Grep: 코드 패턴 검색
+- Glob: 파일 목록 조회
+- Bash: git, 메트릭 도구 실행 (읽기 전용)
+- sequentialthinking: 분석 사고 과정
+
+**금지:**
+- Edit: 코드 수정 금지
+- Write: 파일 생성 금지
+- Task: 하위 에이전트 호출 금지
+
+**특징:**
+- 읽기 전용 에이전트
+- 코드 분석 및 개선 방향 조언만 제공
+- 실제 구현은 implementation-executor에게 위임
+
+**사용 시점:**
+- 코드 복잡도, 중복률, 타입 안정성 분석 필요 시
+- 리팩토링 우선순위 결정 필요 시
+- 점진적 개선 전략 수립 필요 시
+
+**권장 모델:** sonnet
+
+---
+
+## implementation-executor
+
+**역할:** 리팩토링 계획을 실제로 구현
+
+**도구:**
+- Read, Edit, Write: 파일 읽기/수정/생성
+- Bash: 테스트, 빌드, git 실행
+- sequentialthinking: 구현 사고 과정
+
+**사용 시점:**
+- refactor-advisor의 계획을 실제로 코드로 구현
+- PLAN.md 기반 단계별 리팩토링 실행
+
+**권장 모델:**
+- 단순 작업 (변수명 변경, 포맷팅): haiku
+- 일반 작업 (함수 분리, 중복 제거): sonnet
+- 복잡한 작업 (아키텍처 변경): opus
+
+---
+
+## code-reviewer
+
+**역할:** 리팩토링 후 품질 검증
+
+**도구:**
+- Read: 변경된 코드 읽기
+- Bash: 테스트, 린트, 타입 체크 실행
+- sequentialthinking: 검토 사고 과정
+
+**금지:**
+- Edit/Write: 검토만 수행, 수정은 하지 않음
+
+**사용 시점:**
+- 리팩토링 완료 후 품질 검증
+- 다중 관점 코드 리뷰 (성능, 보안, 가독성, 유지보수성)
+
+**권장 모델:** opus (세밀한 검토 필요)
+
+---
+
+## architect
+
+**역할:** 아키텍처 분석 및 구조 개선 방향 제시 (READ-ONLY)
+
+**도구:**
+- Read, Grep, Glob: 코드베이스 탐색
+- Bash: 의존성 분석 도구 실행 (읽기 전용)
+- sequentialthinking: 아키텍처 분석
+
+**금지:**
+- Edit/Write: 분석만 수행, 수정은 하지 않음
+
+**사용 시점:**
+- 아키텍처 문제점 분석
+- 모듈 구조 개선 방향 제시
+- 레이어드 아키텍처 전환 전략
+
+**권장 모델:**
+- 일반 분석: sonnet
+- 복잡한 설계: opus
+
+---
+
+## analyst
+
+**역할:** 코드 메트릭 분석, 엣지 케이스 검증
+
+**도구:**
+- Read, Grep, Glob: 코드 분석
+- Bash: 메트릭 도구 실행 (복잡도, 중복률 등)
+- sequentialthinking: 분석 사고 과정
+
+**사용 시점:**
+- 복잡도, 중복률, 타입 안정성 메트릭 수집
+- Before/After 비교 분석
+- 리팩토링 우선순위 결정
+
+**권장 모델:** sonnet
+
+---
+
+## explore
+
+**역할:** 코드베이스 탐색, 의존성 파악
+
+**도구:**
+- Read, Grep, Glob: 파일 탐색
+- Bash: find, tree 등 탐색 명령
+
+**사용 시점:**
+- 중복 코드 패턴 탐색
+- 모듈 간 의존성 그래프 생성
+- any 타입 사용 지점 전수 조사
+
+**권장 모델:** haiku (빠른 탐색)
+
+---
+
+## document-writer
+
+**역할:** 리팩토링 계획 및 결과 문서화
+
+**도구:**
+- Read: 기존 문서 읽기
+- Write: 문서 생성
+- sequentialthinking: 문서 구조화
+
+**사용 시점:**
+- ANALYSIS.md, PLAN.md, METRICS.md 생성
+- 리팩토링 가이드, 마이그레이션 문서 작성
+
+**권장 모델:**
+- 간단한 문서 (ANALYSIS.md, METRICS.md): haiku
+- 복잡한 문서 (PLAN.md, 상세 가이드): sonnet
+
+---
+
+## Model Routing
+
+| 복잡도 | 리팩토링 유형 | Model | Agent | 예시 |
+|--------|--------------|-------|-------|------|
+| **LOW** | 단순 개선 | haiku | implementation-executor, explore, document-writer | 변수명 변경, 코드 포맷팅, 파일 탐색 |
+| **MEDIUM** | 일반 리팩토링 | sonnet | refactor-advisor, implementation-executor, analyst, architect, document-writer | 함수 분리, 중복 제거, 타입 개선, 메트릭 분석 |
+| **HIGH** | 복잡한 구조 변경 | opus | architect, code-reviewer | 아키텍처 재설계, 모듈 분리, 품질 검증 |
+
+---
+
+## Agent 조합 패턴
+
+### 패턴 1: 분석 + 계획
+
+```typescript
+// 코드 분석과 리팩토링 계획 동시 진행
+Task({
+  subagent_type: "refactor-advisor",
+  model: "sonnet",
+  prompt: "코드 분석 및 리팩토링 계획 수립"
+})
+
+Task({
+  subagent_type: "analyst",
+  model: "sonnet",
+  prompt: "복잡도, 중복률 메트릭 수집"
+})
+
+Task({
+  subagent_type: "architect",
+  model: "opus",
+  prompt: "아키텍처 문제점 분석 (READ-ONLY)"
+})
+```
+
+### 패턴 2: 탐색 + 실행
+
+```typescript
+// 의존성 파악과 독립 모듈 리팩토링 동시 진행
+Task({
+  subagent_type: "explore",
+  model: "haiku",
+  prompt: "모듈 간 의존성 그래프 생성"
+})
+
+Task({
+  subagent_type: "implementation-executor",
+  model: "sonnet",
+  prompt: "독립 유틸리티 함수 리팩토링 (의존성 없음)"
+})
+```
+
+### 패턴 3: 구현 + 검증 + 문서
+
+```typescript
+// 리팩토링, 검증, 문서화 동시 진행
+Task({
+  subagent_type: "implementation-executor",
+  model: "sonnet",
+  prompt: "함수 분리 리팩토링 실행"
+})
+
+Task({
+  subagent_type: "code-reviewer",
+  model: "opus",
+  prompt: "리팩토링 후 품질 검증"
+})
+
+Task({
+  subagent_type: "document-writer",
+  model: "haiku",
+  prompt: "리팩토링 변경 사항 문서화"
+})
+```
+
+### 패턴 4: 다중 관점 검증
+
+```typescript
+// 리팩토링 후 여러 관점에서 동시 검증
+Task({
+  subagent_type: "code-reviewer",
+  model: "opus",
+  prompt: "성능 검토: 불필요한 리렌더, N+1 쿼리"
+})
+
+Task({
+  subagent_type: "code-reviewer",
+  model: "opus",
+  prompt: "보안 검토: 타입 안정성, 입력 검증"
+})
+
+Task({
+  subagent_type: "code-reviewer",
+  model: "opus",
+  prompt: "가독성 검토: 명명 규칙, 함수 길이"
+})
+
+Task({
+  subagent_type: "code-reviewer",
+  model: "opus",
+  prompt: "유지보수성 검토: 테스트 커버리지, 확장성"
+})
+```
+
+---
+
+## 주의사항
+
+```text
+✅ 권장:
+- refactor-advisor: READ-ONLY, 조언만 제공
+- 독립적인 모듈/파일 → 병렬 실행
+- 분석 작업 (읽기 전용) → 병렬 실행
+- 다중 관점 검증 → 병렬 실행
+
+❌ 금지:
+- refactor-advisor에서 Edit/Write 사용
+- 같은 파일 동시 수정 (충돌 발생)
+- 순차 의존성 있는 작업 병렬화
+```