@kood/claude-code 0.2.4 → 0.3.0

package/templates/.claude/commands/pre-deploy.md

@@ -0,0 +1,242 @@
+---
+description: 배포 전 typecheck/lint/build 검증 및 수정. ultrathink + sequential thinking 필수 사용.
+allowed-tools: Bash(tsc:*, npx:*, yarn:*, npm:*, pnpm:*), Read, Edit, mcp__sequential-thinking__sequentialthinking
+argument-hint: [파일/디렉토리 경로...]
+---
+
+# Pre-Deploy Command
+
+> 배포 전 typecheck/lint/build를 Sequential Thinking으로 검증하고 수정
+
+---
+
+<forbidden>
+
+| 분류 | 금지 |
+|------|------|
+| **회피** | 오류 무시하고 배포, `any` 타입, `@ts-ignore`, `eslint-disable` 남발 |
+| **전략** | 여러 오류 동시 수정, build 생략, 오류 메시지만 보고 급하게 수정 |
+| **분석** | Sequential Thinking 없이 수정 |
+
+</forbidden>
+
+---
+
+<agent_usage>
+
+## @deployment-validator Agent 활용
+
+**언제 사용:**
+- PR 생성 전 전체 검증
+- 배포 전 품질 보증
+- CI/CD 전 로컬 검증
+
+**호출 방법:**
+```bash
+@deployment-validator
+# 또는 자연어
+"배포 준비 완료 체크해줘"
+"pre-deploy 검증해줘"
+```
+
+**장점:**
+- typecheck + lint + build 전체 자동화
+- Build 실패 시 Sequential Thinking으로 원인 자동 분석
+- 배포 가능 여부 최종 판단
+- 독립적 context에서 실행 (메인 작업 병렬 가능)
+
+**직접 검증 vs Agent:**
+
+| 상황 | 권장 방법 |
+|------|----------|
+| 빠른 개발 중 | 직접 검증 (command) |
+| PR 생성 전 | @deployment-validator |
+| 배포 전 최종 확인 | @deployment-validator |
+| CI/CD 전 로컬 확인 | @deployment-validator |
+| 자동화된 검증 | @deployment-validator |
+
+</agent_usage>
+
+---
+
+<required>
+
+| 분류 | 필수 |
+|------|------|
+| **Thinking** | Sequential Thinking 3-5단계 (각 오류마다) |
+| **Tracking** | TodoWrite로 오류 목록 추적 |
+| **Strategy** | typecheck + lint 병렬 실행 → 순차 수정 → build |
+| **Validation** | 각 파일 수정 후 해당 파일 재검사 |
+| **Build** | 모든 오류 해결 후 build 실행 및 성공 확인 |
+
+</required>
+
+---
+
+<workflow>
+
+1. **병렬 검사**
+   ```bash
+   npx tsc --noEmit
+   npx eslint .
+   ```
+
+2. **TodoWrite 생성**
+   - typecheck 오류 목록
+   - lint 오류 목록
+   - 우선순위: 타입 오류 → 린트 오류 → 린트 경고
+
+3. **순차 수정** (각 오류마다)
+   - Sequential Thinking 3-5단계
+   - 수정 적용
+   - 해당 파일 재검사
+   - TodoWrite 업데이트 (completed)
+
+4. **Build 실행**
+   ```bash
+   # package.json scripts 확인 후 실행
+   npm run build  # or yarn build, pnpm build
+   ```
+
+5. **Build 성공 확인**
+   - 오류 발생 시 Sequential Thinking으로 분석 및 수정
+   - 성공 시 배포 준비 완료
+
+</workflow>
+
+---
+
+<sequential_thinking>
+
+**각 오류마다 필수:**
+
+| 단계 | 내용 |
+|------|------|
+| 1 | 오류 메시지 분석 및 이해 |
+| 2 | 관련 코드 컨텍스트 파악 |
+| 3 | 근본 원인 식별 |
+| 4 | 수정 방안 검토 (여러 옵션 고려) |
+| 5 | 최적 수정 방안 선택 및 적용 |
+
+**파라미터:**
+
+```typescript
+{
+  thought: "현재 사고 내용",
+  nextThoughtNeeded: true | false,
+  thoughtNumber: 1, // 현재 단계
+  totalThoughts: 5  // 예상 총 단계 (동적 조정 가능)
+}
+```
+
+</sequential_thinking>
+
+---
+
+<commands>
+
+**검사:**
+
+```bash
+# TypeScript (전체)
+npx tsc --noEmit
+
+# TypeScript (특정 파일)
+npx tsc --noEmit $ARGUMENTS
+
+# ESLint (전체)
+npx eslint .
+
+# ESLint (특정 파일/디렉토리)
+npx eslint $ARGUMENTS
+
+# Build (package.json 확인 필요)
+npm run build
+yarn build
+pnpm build
+```
+
+**인수 처리:**
+
+| 인수 | 동작 |
+|------|------|
+| 없음 | 전체 프로젝트 검사 + build |
+| 파일 경로 | 해당 파일만 검사 (build 생략) |
+| 디렉토리 | 해당 디렉토리만 검사 (build 생략) |
+
+</commands>
+
+---
+
+<examples>
+
+**Example 1: 전체 워크플로우**
+
+```
+1. 병렬 검사 실행
+   npx tsc --noEmit
+   → TS2322: Type 'string' is not assignable to type 'number'
+
+   npx eslint .
+   → error: 'user' is assigned a value but never used (no-unused-vars)
+
+2. TodoWrite 생성
+   - TS2322 오류 수정 (src/utils/calc.ts:15)
+   - no-unused-vars 수정 (src/components/Form.tsx:8)
+
+3. Sequential Thinking (TS2322)
+   thought 1: "TS2322 오류. string을 number에 할당 시도"
+   thought 2: "calc.ts:15의 반환값 타입과 실제 반환값 확인"
+   thought 3: "함수가 parseInt 결과를 반환해야 하는데 toString() 호출 중"
+   thought 4: "수정 옵션: 1) toString() 제거 2) 반환 타입 변경"
+   thought 5: "parseInt는 number를 반환하므로 toString() 제거가 적절"
+
+4. Edit으로 수정 → npx tsc --noEmit src/utils/calc.ts 재검사 → 해결
+
+5. TodoWrite 업데이트 (completed) → 다음 오류
+
+6. 모든 오류 해결 후 build 실행
+   npm run build → ✅ Build successful
+
+7. 배포 준비 완료
+```
+
+**Example 2: 우선순위**
+
+| 우선순위 | 유형 | 예시 |
+|----------|------|------|
+| 1 | 타입 오류 (컴파일 차단) | TS2322, TS2345, TS2339 |
+| 2 | 린트 오류 (error 레벨) | no-unused-vars, no-undef |
+| 3 | 린트 경고 (warning 레벨) | prefer-const, no-console |
+
+**Example 3: Build 실패 시나리오**
+
+```
+1. typecheck + lint 통과
+
+2. npm run build 실행
+   → Error: Cannot find module '@/utils/helper'
+
+3. Sequential Thinking
+   thought 1: "Build 시 import 오류 발생"
+   thought 2: "helper 모듈이 존재하지 않거나 경로 오류"
+   thought 3: "Read로 파일 확인 필요"
+   thought 4: "helper.ts가 아닌 helpers.ts로 존재"
+   thought 5: "import 경로를 '@/utils/helpers'로 수정"
+
+4. Edit으로 수정 → npm run build 재실행 → ✅ 성공
+```
+
+**Example 4: 부분 검사 (인수 제공)**
+
+```bash
+# 특정 파일만 검사 (build 생략)
+/pre-deploy src/utils/calc.ts
+
+→ npx tsc --noEmit src/utils/calc.ts
+→ npx eslint src/utils/calc.ts
+→ 오류 수정
+→ build는 실행하지 않음
+```
+
+</examples>

package/templates/.claude/commands/subagent-creator.md

@@ -0,0 +1,118 @@
+---
+description: Task 도구로 subagent 생성. 복잡한 작업 위임.
+allowed-tools: Task, mcp__sequential-thinking__sequentialthinking
+argument-hint: <생성할 subagent 작업 설명>
+---
+
+# Subagent Creator
+
+> Task 도구를 사용하여 전문 subagent를 생성하고 복잡한 작업을 위임하는 커맨드.
+
+---
+
+<agent_types>
+
+## 주요 Agent Types
+
+| Type | 용도 | 예시 |
+|------|------|------|
+| **Explore** | 코드베이스 구조 탐색, 파일 검색 | "React 컴포넌트 구조 분석" |
+| **Plan** | 구현 전략 수립, 설계 계획 | "마이그레이션 단계별 계획" |
+| **Bash** | Git 작업, 터미널 명령 실행 | "브랜치 생성 및 커밋" |
+| **general-purpose** | 복합 작업, 다단계 조사 | "여러 모듈 의존성 분석" |
+
+</agent_types>
+
+---
+
+<usage_patterns>
+
+## 사용 패턴
+
+### 단일 Subagent
+
+```typescript
+Task({
+  subagent_type: 'Explore',
+  description: '인증 구조 분석',
+  prompt: `
+    현재 인증 관련 코드 분석:
+    - 사용 중인 라이브러리
+    - 세션 관리 방식
+    - 관련 파일 위치
+  `
+})
+```
+
+### 병렬 Subagent (독립 작업)
+
+```typescript
+// 단일 메시지에 여러 Task 호출
+Task({
+  subagent_type: 'Explore',
+  description: '프론트엔드 구조',
+  prompt: '프론트엔드 인증 흐름 분석'
+})
+
+Task({
+  subagent_type: 'Explore',
+  description: '백엔드 API',
+  prompt: '백엔드 인증 엔드포인트 분석'
+})
+
+Task({
+  subagent_type: 'Bash',
+  description: 'Git 이력 확인',
+  prompt: 'git log --grep="auth" 최근 커밋 조사'
+})
+```
+
+### Model 선택 (선택적)
+
+```typescript
+Task({
+  subagent_type: 'Explore',
+  description: '간단한 파일 탐색',
+  prompt: 'config 파일 위치 찾기',
+  model: 'haiku'  // 빠르고 저렴한 작업
+})
+```
+
+</usage_patterns>
+
+---
+
+<quick_tips>
+
+## Quick Tips
+
+| 팁 | 설명 |
+|----|------|
+| **description** | 3-5단어로 작업 요약 (사용자에게 표시) |
+| **prompt** | 구체적 작업 내용, 명확한 목표 |
+| **병렬 실행** | 독립적 작업은 단일 메시지에 여러 Task 호출 |
+| **model** | 간단한 작업 → `haiku`, 복잡한 작업 → 생략(sonnet) |
+| **Sequential Thinking** | agent 생성 전 복잡도 판단 권장 (3-5단계) |
+
+</quick_tips>
+
+---
+
+<validation>
+
+## 체크리스트
+
+```text
+✅ 작업이 복잡하여 subagent 필요
+✅ description 3-5단어 (사용자 표시용)
+✅ prompt 명확하고 구체적
+✅ 독립 작업 → 병렬 실행 (단일 메시지)
+✅ 의존 작업 → 순차 실행 (결과 대기)
+
+❌ 단순 파일 읽기에 Task 사용 (Read 직접)
+❌ 특정 클래스 검색에 Task 사용 (Glob 직접)
+❌ 의존 작업을 병렬로 실행
+❌ placeholder 값 전달 (결과 대기 후 전달)
+```
+
+</validation>

package/templates/.claude/commands/version-update.md

@@ -1,88 +1,76 @@
 ---
 description: 프로젝트 버전 업데이트 및 커밋
-allowed-tools: Bash(git:*), Read, Edit
-argument-hint: <new-version | +1>
+allowed-tools: Bash, Read, Edit
+argument-hint: <new-version | +1 | +minor | +major>
 ---
 
+@../instructions/git-rules.md
+
+# Version Update Command
+
 프로젝트 전체 버전을 업데이트하고 커밋.
 
-**인수**: `$ARGUMENTS`
+**인수**: $ARGUMENTS
 
-## 인수 처리
+<version_rules>
 
 | 인수 | 동작 | 예시 |
 |------|------|------|
-| `+1` | patch 버전 +1 | 0.1.13 → 0.1.14 |
-| `+minor` | minor 버전 +1 | 0.1.13 → 0.2.0 |
-| `+major` | major 버전 +1 | 0.1.13 → 1.0.0 |
-| `x.x.x` | 해당 버전으로 설정 | 0.1.13 → 2.0.0 |
-
-## 실행 흐름
+| `+1` | patch +1 | 0.1.13 → 0.1.14 |
+| `+minor` | minor +1 | 0.1.13 → 0.2.0 |
+| `+major` | major +1 | 0.1.13 → 1.0.0 |
+| `x.x.x` | 직접 지정 | 0.1.13 → 2.0.0 |
 
-```
-1. 현재 버전 확인 (병렬로 버전 파일들 읽기)
-2. 인수에 따라 새 버전 계산
-3. 모든 버전 파일 업데이트
-4. git add + git commit
-```
+</version_rules>
 
-## 버전 파일 목록
+<workflow>
 
-| 파일 | 필드 |
-|------|------|
-| `packages/claude-code/package.json` | `"version": "x.x.x"` |
-| `packages/claude-code/src/index.ts` | `.version('x.x.x')` |
+1. **현재 버전 확인** (병렬 읽기)
+   - packages/claude-code/package.json
+   - packages/claude-code/src/index.ts
 
-## 병렬 실행
+2. **새 버전 계산**
 
-**초기 확인 단계에서 병렬 실행 필수:**
+3. **모든 파일 Edit로 업데이트**
 
-```
-Read: packages/claude-code/package.json
-Read: packages/claude-code/src/index.ts
-```
+4. **스테이징**
+   ```bash
+   git add packages/claude-code/package.json packages/claude-code/src/index.ts
+   ```
 
-## 업데이트 절차
+5. **커밋**
+   ```bash
+   git commit -m "chore: 버전 X.X.X로 업데이트"
+   ```
 
-1. **버전 검증**: semver 형식 확인 (예: 0.1.14, 1.0.0)
-2. **Edit 도구로 각 파일 수정**:
-   - `package.json`: `"version": "이전버전"` → `"version": "새버전"`
-   - `index.ts`: `.version('이전버전')` → `.version('새버전')`
-3. **git add + git commit**
+6. **완료 확인**
+   ```bash
+   git status
+   ```
 
-## 커밋 규칙
+</workflow>
 
-**형식**: `chore: 버전 X.X.X로 업데이트`
+<update_targets>
 
-## CRITICAL: 절대 금지
+| 파일 | 수정 위치 |
+|------|----------|
+| `package.json` | `"version": "x.x.x"` |
+| `src/index.ts` | `.version('x.x.x')` |
 
-| 금지 항목 |
-|----------|
-| "Generated with Claude Code" 포함 |
-| "🤖" 또는 AI 관련 이모지 |
-| "Co-Authored-By:" 헤더 |
-| AI/봇 작성 표시 일체 |
-| 여러 줄 커밋 메시지 |
-| 커밋 메시지에 마침표(.) |
+</update_targets>
 
-## 예시
+<examples>
 
 ```bash
-# patch 버전 증가 (가장 일반적)
 /version-update +1
-# 0.1.13 → 0.1.14
+→ 0.1.13 → 0.1.14
+→ chore: 버전 0.1.14로 업데이트
 
-# minor 버전 증가
 /version-update +minor
-# 0.1.13 → 0.2.0
-
-# major 버전 증가
-/version-update +major
-# 0.1.13 → 1.0.0
+→ 0.1.13 → 0.2.0
 
-# 직접 버전 지정
 /version-update 2.0.0
-
-# 커밋 결과
-chore: 버전 0.1.14로 업데이트
+→ 직접 지정
 ```
+
+</examples>