@kood/claude-code 0.4.1 → 0.5.1

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

@@ -1,38 +1,22 @@
 ---
 description: 배포 전 typecheck/lint/build 검증 및 수정. ultrathink + sequential thinking 필수 사용.
 allowed-tools: Bash(tsc:*, npx:*, yarn:*, npm:*, pnpm:*), Read, Edit, mcp__sequential-thinking__sequentialthinking
-argument-hint: [file/directory paths...]
+argument-hint: [파일/디렉토리 경로...]
 ---
 
-<critical_instruction>
-
-**CRITICAL: 사용자와의 모든 커뮤니케이션은 반드시 한국어로 작성하세요.**
-
-- 내부 사고와 분석은 영어로 해도 됨
-- 설명, 요약, 보고서, 피드백 등 사용자에게 전달하는 모든 내용은 반드시 한국어
-- 사용자가 영어로 말하더라도 답변은 한국어로
-- 진행 상황 업데이트와 상태 보고는 반드시 한국어
-
-이 규칙은 절대적이며 예외가 없습니다.
-
-</critical_instruction>
-
----
-
-
 # Pre-Deploy Command
 
-> Verify and fix typecheck/lint/build before deployment with Sequential Thinking
+> 배포 전 typecheck/lint/build를 Sequential Thinking으로 검증하고 수정
 
 ---
 
 <forbidden>
 
-| Category | Forbidden |
-|----------|-----------|
-| **Avoidance** | Deploy with errors, excessive `any` type, `@ts-ignore`, `eslint-disable` |
-| **Strategy** | Fix multiple errors simultaneously, skip build, fix hastily based on error message |
-| **Analysis** | Fix without Sequential Thinking |
+| 분류 | 금지 |
+|------|------|
+| **회피** | 오류 무시하고 배포, `any` 타입, `@ts-ignore`, `eslint-disable` 남발 |
+| **전략** | 여러 오류 동시 수정, build 생략, 오류 메시지만 보고 급하게 수정 |
+| **분석** | Sequential Thinking 없이 수정 |
 
 </forbidden>
 
@@ -40,50 +24,132 @@ argument-hint: [file/directory paths...]
 
 <agent_usage>
 
-## @deployment-validator Agent Usage
+## @deployment-validator Agent 활용
 
-**When to use:**
-- Full validation before PR creation
-- Quality assurance before deployment
-- Local validation before CI/CD
+**언제 사용:**
+- PR 생성 전 전체 검증
+- 배포 전 품질 보증
+- CI/CD 전 로컬 검증
 
-**How to call:**
+**호출 방법:**
 ```bash
 @deployment-validator
-# or natural language
-"Check if ready to deploy"
-"Validate pre-deploy"
+# 또는 자연어
+"배포 준비 완료 체크해줘"
+"pre-deploy 검증해줘"
 ```
 
-**Benefits:**
-- Full automation of typecheck + lint + build
-- Auto-analyze cause of build failure with Sequential Thinking
-- Final judgment on deployment readiness
-- Run in independent context (can parallelize with main work)
+**장점:**
+- typecheck + lint + build 전체 자동화
+- Build 실패 시 Sequential Thinking으로 원인 자동 분석
+- 배포 가능 여부 최종 판단
+- 독립적 context에서 실행 (메인 작업 병렬 가능)
 
-**Direct validation vs Agent:**
+**직접 검증 vs Agent:**
 
-| Situation | Recommended |
-|-----------|-------------|
-| During rapid development | Direct validation (command) |
-| Before PR creation | @deployment-validator |
-| Final check before deployment | @deployment-validator |
-| Local check before CI/CD | @deployment-validator |
-| Automated validation | @deployment-validator |
+| 상황 | 권장 방법 |
+|------|----------|
+| 빠른 개발 중 | 직접 검증 (command) |
+| PR 생성 전 | @deployment-validator |
+| 배포 전 최종 확인 | @deployment-validator |
+| CI/CD 전 로컬 확인 | @deployment-validator |
+| 자동화된 검증 | @deployment-validator |
 
 </agent_usage>
 
 ---
 
+<parallel_agent_execution>
+
+## 병렬 Agent 실행
+
+**권장 Agent:**
+
+| Agent | 모델 | 용도 |
+|-------|------|------|
+| @deployment-validator | sonnet/opus | 전체 검증 자동화 (typecheck + lint + build) |
+| @lint-fixer | haiku/sonnet | 린트 오류 자동 수정 |
+| @code-reviewer | sonnet | 배포 전 코드 품질 리뷰 |
+
+**병렬 실행 패턴:**
+
+| 작업 유형 | 실행 방식 | 이유 |
+|----------|----------|------|
+| typecheck + lint 검사 | ✅ 병렬 가능 | 읽기 전용, 파일 충돌 없음 |
+| 오류 수정 | ❌ 순차 실행 | 동일 파일 동시 수정 방지 |
+| 검증 + 문서화 | ✅ 병렬 가능 | validator + document-writer 독립적 |
+| build + test | ❌ 순차 실행 | build 완료 후 test 실행 |
+
+**모델 라우팅:**
+
+| 복잡도 | 모델 | 사용 시나리오 |
+|--------|------|-------------|
+| LOW | haiku | 간단한 린트 오류, 단순 검증 |
+| MEDIUM | sonnet | 일반적인 typecheck/lint 검증, 수정 |
+| HIGH | opus | 복잡한 타입 오류, 아키텍처 영향 분석 |
+
+**실전 예시:**
+
+```typescript
+// ✅ 병렬 검사 (읽기 전용)
+Task({
+  subagent_type: "deployment-validator",
+  model: "sonnet",
+  prompt: "typecheck 실행 및 검증"
+})
+Task({
+  subagent_type: "deployment-validator",
+  model: "sonnet",
+  prompt: "lint 실행 및 검증"
+})
+
+// ✅ 검증 + 문서화 병렬
+Task({
+  subagent_type: "deployment-validator",
+  model: "sonnet",
+  prompt: "배포 전 전체 검증"
+})
+Task({
+  subagent_type: "document-writer",
+  model: "haiku",
+  prompt: "CHANGELOG.md 업데이트"
+})
+
+// ❌ 수정 작업은 순차 실행 (충돌 방지)
+// 잘못된 예시:
+Task({ prompt: "src/utils/calc.ts 타입 오류 수정" })
+Task({ prompt: "src/utils/calc.ts 린트 오류 수정" })
+// → 동일 파일 동시 수정으로 충돌 발생
+
+// ✅ 올바른 순차 실행:
+// 1. typecheck + lint 병렬 검사
+// 2. 오류 목록 파악
+// 3. 파일별 순차 수정
+// 4. build 실행
+```
+
+**Agent 조합 권장:**
+
+| 목표 | Agent 조합 | 실행 방식 |
+|------|-----------|----------|
+| 빠른 검증 | @deployment-validator (haiku) | 단독 실행 |
+| 전체 검증 + 수정 | @deployment-validator (sonnet) → @lint-fixer (haiku) | 순차 |
+| 배포 준비 | @deployment-validator (sonnet) + @code-reviewer (sonnet) | 병렬 |
+| 자동화된 CI | @deployment-validator (opus) | 단독 실행 |
+
+</parallel_agent_execution>
+
+---
+
 <required>
 
-| Category | Required |
-|----------|----------|
-| **Thinking** | Sequential Thinking 3-5 steps per error |
-| **Tracking** | Track error list with TodoWrite |
-| **Strategy** | Run typecheck + lint in parallel → sequential fix → build |
-| **Validation** | Recheck each file after fixing |
-| **Build** | Run build after all errors resolved and verify success |
+| 분류 | 필수 |
+|------|------|
+| **Thinking** | Sequential Thinking 3-5단계 (각 오류마다) |
+| **Tracking** | TodoWrite로 오류 목록 추적 |
+| **Strategy** | typecheck + lint 병렬 실행 → 순차 수정 → build |
+| **Validation** | 각 파일 수정 후 해당 파일 재검사 |
+| **Build** | 모든 오류 해결 후 build 실행 및 성공 확인 |
 
 </required>
 
@@ -91,32 +157,32 @@ argument-hint: [file/directory paths...]
 
 <workflow>
 
-1. **Parallel check**
+1. **병렬 검사**
    ```bash
    npx tsc --noEmit
    npx eslint .
    ```
 
-2. **Create TodoWrite**
-   - List typecheck errors
-   - List lint errors
-   - Priority: type errors → lint errors → lint warnings
+2. **TodoWrite 생성**
+   - typecheck 오류 목록
+   - lint 오류 목록
+   - 우선순위: 타입 오류 → 린트 오류 → 린트 경고
 
-3. **Sequential fix** (per error)
-   - Sequential Thinking 3-5 steps
-   - Apply fix
-   - Recheck file
-   - Update TodoWrite (completed)
+3. **순차 수정** (각 오류마다)
+   - Sequential Thinking 3-5단계
+   - 수정 적용
+   - 해당 파일 재검사
+   - TodoWrite 업데이트 (completed)
 
-4. **Run build**
+4. **Build 실행**
    ```bash
-   # Verify package.json scripts then run
+   # package.json scripts 확인 후 실행
    npm run build  # or yarn build, pnpm build
    ```
 
-5. **Verify build success**
-   - If errors occur, analyze and fix with Sequential Thinking
-   - If successful, ready for deployment
+5. **Build 성공 확인**
+   - 오류 발생 시 Sequential Thinking으로 분석 및 수정
+   - 성공 시 배포 준비 완료
 
 </workflow>
 
@@ -124,24 +190,24 @@ argument-hint: [file/directory paths...]
 
 <sequential_thinking>
 
-**Required for each error:**
+**각 오류마다 필수:**
 
-| Step | Content |
-|------|---------|
-| 1 | Analyze and understand error message |
-| 2 | Identify relevant code context |
-| 3 | Identify root cause |
-| 4 | Review fix options (consider multiple) |
-| 5 | Select and apply optimal fix |
+| 단계 | 내용 |
+|------|------|
+| 1 | 오류 메시지 분석 및 이해 |
+| 2 | 관련 코드 컨텍스트 파악 |
+| 3 | 근본 원인 식별 |
+| 4 | 수정 방안 검토 (여러 옵션 고려) |
+| 5 | 최적 수정 방안 선택 및 적용 |
 
-**Parameters:**
+**파라미터:**
 
 ```typescript
 {
-  thought: "Current thinking content",
+  thought: "현재 사고 내용",
   nextThoughtNeeded: true | false,
-  thoughtNumber: 1, // current step
-  totalThoughts: 5  // expected total steps (dynamic)
+  thoughtNumber: 1, // 현재 단계
+  totalThoughts: 5  // 예상 총 단계 (동적 조정 가능)
 }
 ```
 
@@ -151,34 +217,34 @@ argument-hint: [file/directory paths...]
 
 <commands>
 
-**Check:**
+**검사:**
 
 ```bash
-# TypeScript (all)
+# TypeScript (전체)
 npx tsc --noEmit
 
-# TypeScript (specific file)
+# TypeScript (특정 파일)
 npx tsc --noEmit $ARGUMENTS
 
-# ESLint (all)
+# ESLint (전체)
 npx eslint .
 
-# ESLint (specific file/directory)
+# ESLint (특정 파일/디렉토리)
 npx eslint $ARGUMENTS
 
-# Build (requires package.json check)
+# Build (package.json 확인 필요)
 npm run build
 yarn build
 pnpm build
 ```
 
-**Argument handling:**
+**인수 처리:**
 
-| Argument | Action |
-|----------|--------|
-| None | Check entire project + build |
-| File path | Check that file only (skip build) |
-| Directory | Check that directory only (skip build) |
+| 인수 | 동작 |
+|------|------|
+| 없음 | 전체 프로젝트 검사 + build |
+| 파일 경로 | 해당 파일만 검사 (build 생략) |
+| 디렉토리 | 해당 디렉토리만 검사 (build 생략) |
 
 </commands>
 
@@ -186,73 +252,73 @@ pnpm build
 
 <examples>
 
-**Example 1: Full workflow**
+**Example 1: 전체 워크플로우**
 
 ```
-1. Run parallel check
+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. Create TodoWrite
-   - Fix TS2322 error (src/utils/calc.ts:15)
-   - Fix no-unused-vars (src/components/Form.tsx:8)
+2. TodoWrite 생성
+   - TS2322 오류 수정 (src/utils/calc.ts:15)
+   - no-unused-vars 수정 (src/components/Form.tsx:8)
 
 3. Sequential Thinking (TS2322)
-   thought 1: "TS2322 error. Assigning string to number"
-   thought 2: "Check return value type and actual return in calc.ts:15"
-   thought 3: "Function should return parseInt result but calling toString()"
-   thought 4: "Fix options: 1) Remove toString() 2) Change return type"
-   thought 5: "parseInt returns number so removing toString() is appropriate"
+   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. Fix with Edit → recheck with npx tsc --noEmit src/utils/calc.ts → resolved
+4. Edit으로 수정 → npx tsc --noEmit src/utils/calc.ts 재검사 → 해결
 
-5. Update TodoWrite (completed) → next error
+5. TodoWrite 업데이트 (completed) → 다음 오류
 
-6. After all errors resolved, run build
+6. 모든 오류 해결 후 build 실행
    npm run build → ✅ Build successful
 
-7. Ready for deployment
+7. 배포 준비 완료
 ```
 
-**Example 2: Priority**
+**Example 2: 우선순위**
 
-| Priority | Type | Example |
-|----------|------|---------|
-| 1 | Type errors (blocks compile) | TS2322, TS2345, TS2339 |
-| 2 | Lint errors (error level) | no-unused-vars, no-undef |
-| 3 | Lint warnings (warning level) | prefer-const, no-console |
+| 우선순위 | 유형 | 예시 |
+|----------|------|------|
+| 1 | 타입 오류 (컴파일 차단) | TS2322, TS2345, TS2339 |
+| 2 | 린트 오류 (error 레벨) | no-unused-vars, no-undef |
+| 3 | 린트 경고 (warning 레벨) | prefer-const, no-console |
 
-**Example 3: Build failure scenario**
+**Example 3: Build 실패 시나리오**
 
 ```
-1. typecheck + lint pass
+1. typecheck + lint 통과
 
-2. Run npm run build
+2. npm run build 실행
    → Error: Cannot find module '@/utils/helper'
 
 3. Sequential Thinking
-   thought 1: "Import error during build"
-   thought 2: "helper module doesn't exist or path error"
-   thought 3: "Need to check file with Read"
-   thought 4: "helper.ts doesn't exist, only helpers.ts"
-   thought 5: "Fix import path to '@/utils/helpers'"
+   thought 1: "Build 시 import 오류 발생"
+   thought 2: "helper 모듈이 존재하지 않거나 경로 오류"
+   thought 3: "Read로 파일 확인 필요"
+   thought 4: "helper.ts가 아닌 helpers.ts로 존재"
+   thought 5: "import 경로를 '@/utils/helpers'로 수정"
 
-4. Fix with Edit → rerun npm run build → ✅ success
+4. Edit으로 수정 → npm run build 재실행 → ✅ 성공
 ```
 
-**Example 4: Partial check (with arguments)**
+**Example 4: 부분 검사 (인수 제공)**
 
 ```bash
-# Check only specific file (skip build)
+# 특정 파일만 검사 (build 생략)
 /pre-deploy src/utils/calc.ts
 
 → npx tsc --noEmit src/utils/calc.ts
 → npx eslint src/utils/calc.ts
-→ Fix errors
-→ Don't run build
+→ 오류 수정
+→ build는 실행하지 않음
 ```
 
 </examples>