@kood/claude-code 0.3.7 → 0.3.9

package/templates/.claude/commands/prd.md

@@ -1,30 +1,46 @@
 ---
 description: PRD(Product Requirements Document) 생성
 allowed-tools: Read, Write, Glob, Grep, Task, mcp__sequential-thinking__sequentialthinking
-argument-hint: <기능/제품 설명>
+argument-hint: <feature/product description>
 ---
 
+<critical_instruction>
+
+**CRITICAL: 사용자와의 모든 커뮤니케이션은 반드시 한국어로 작성하세요.**
+
+- 내부 사고와 분석은 영어로 해도 됨
+- 설명, 요약, 보고서, 피드백 등 사용자에게 전달하는 모든 내용은 반드시 한국어
+- 사용자가 영어로 말하더라도 답변은 한국어로
+- 진행 상황 업데이트와 상태 보고는 반드시 한국어
+
+이 규칙은 절대적이며 예외가 없습니다.
+
+</critical_instruction>
+
+---
+
+
 @../instructions/sequential-thinking-guide.md
 
 # PRD Command
 
-기능/제품의 요구사항 문서(PRD)를 작성.
+Write Product Requirements Document (PRD) for feature/product.
 
-**대상**: $ARGUMENTS
+**Target**: $ARGUMENTS
 
 ---
 
 <workflow>
 
-## 실행 흐름
+## Execution Flow
 
-| 단계 | 작업 | 도구 |
+| Step | Task | Tool |
 |------|------|------|
-| 1. 입력 확인 | ARGUMENT 검증, 없으면 질문 | - |
-| 2. Sequential Thinking | 3-5단계로 PRD 구조 분석 | sequentialthinking |
-| 3. 코드베이스 확인 | 관련 코드/문서 탐색 (필요시) | Task (Explore) |
-| 4. PRD 작성 | 15개 섹션 구조로 작성 | Write |
-| 5. 저장 | `.claude/plans/` 또는 `docs/prd/` | - |
+| 1. Validate input | Verify ARGUMENT, ask if missing | - |
+| 2. Sequential Thinking | Analyze PRD structure in 3-5 steps | sequentialthinking |
+| 3. Check codebase | Explore related code/documents (if needed) | Task (Explore) |
+| 4. Write PRD | Write in 15-section structure | Write |
+| 5. Save | Save to `.claude/plans/` or `docs/prd/` | - |
 
 </workflow>
 
@@ -32,12 +48,12 @@ argument-hint: <기능/제품 설명>
 
 <forbidden>
 
-| 분류 | 금지 |
-|------|------|
-| **문제 정의** | 솔루션/기능 목록 포함 |
-| **범위** | In/Out 구분 없이 나열 |
-| **표현** | 모호한 표현 ("좋은 UX", "빠르게") |
-| **스타일** | 마케팅 문구, 과도한 수식어 |
+| Category | Forbidden |
+|----------|-----------|
+| **Problem definition** | Include solutions/feature list |
+| **Scope** | List without In/Out distinction |
+| **Expression** | Vague expressions ("good UX", "fast") |
+| **Style** | Marketing language, excessive adjectives |
 
 </forbidden>
 
@@ -45,13 +61,13 @@ argument-hint: <기능/제품 설명>
 
 <required>
 
-| 분류 | 필수 |
-|------|------|
-| **구조** | 15개 섹션 (메타데이터~템플릿) |
-| **기능 요구사항** | User Stories + Functional + Non-functional |
-| **지표** | 현재값 → 목표값 형태 |
-| **가정/리스크** | 별도 섹션으로 명시 |
-| **스타일** | 짧고 명확한 문장, 구체적 예시 |
+| Category | Required |
+|----------|----------|
+| **Structure** | 15 sections (metadata ~ template) |
+| **Feature requirements** | User Stories + Functional + Non-functional |
+| **Metrics** | Current value → target value format |
+| **Assumptions/Risks** | Specify in separate section |
+| **Style** | Short clear sentences, concrete examples |
 
 </required>
 

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

@@ -1,22 +1,38 @@
 ---
 description: 배포 전 typecheck/lint/build 검증 및 수정. ultrathink + sequential thinking 필수 사용.
 allowed-tools: Bash(tsc:*, npx:*, yarn:*, npm:*, pnpm:*), Read, Edit, mcp__sequential-thinking__sequentialthinking
-argument-hint: [파일/디렉토리 경로...]
+argument-hint: [file/directory paths...]
 ---
 
+<critical_instruction>
+
+**CRITICAL: 사용자와의 모든 커뮤니케이션은 반드시 한국어로 작성하세요.**
+
+- 내부 사고와 분석은 영어로 해도 됨
+- 설명, 요약, 보고서, 피드백 등 사용자에게 전달하는 모든 내용은 반드시 한국어
+- 사용자가 영어로 말하더라도 답변은 한국어로
+- 진행 상황 업데이트와 상태 보고는 반드시 한국어
+
+이 규칙은 절대적이며 예외가 없습니다.
+
+</critical_instruction>
+
+---
+
+
 # Pre-Deploy Command
 
-> 배포 전 typecheck/lint/build를 Sequential Thinking으로 검증하고 수정
+> Verify and fix typecheck/lint/build before deployment with Sequential Thinking
 
 ---
 
 <forbidden>
 
-| 분류 | 금지 |
-|------|------|
-| **회피** | 오류 무시하고 배포, `any` 타입, `@ts-ignore`, `eslint-disable` 남발 |
-| **전략** | 여러 오류 동시 수정, build 생략, 오류 메시지만 보고 급하게 수정 |
-| **분석** | Sequential Thinking 없이 수정 |
+| 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 |
 
 </forbidden>
 
@@ -24,36 +40,36 @@ argument-hint: [파일/디렉토리 경로...]
 
 <agent_usage>
 
-## @deployment-validator Agent 활용
+## @deployment-validator Agent Usage
 
-**언제 사용:**
-- PR 생성 전 전체 검증
-- 배포 전 품질 보증
-- CI/CD 전 로컬 검증
+**When to use:**
+- Full validation before PR creation
+- Quality assurance before deployment
+- Local validation before CI/CD
 
-**호출 방법:**
+**How to call:**
 ```bash
 @deployment-validator
-# 또는 자연어
-"배포 준비 완료 체크해줘"
-"pre-deploy 검증해줘"
+# or natural language
+"Check if ready to deploy"
+"Validate pre-deploy"
 ```
 
-**장점:**
-- typecheck + lint + build 전체 자동화
-- Build 실패 시 Sequential Thinking으로 원인 자동 분석
-- 배포 가능 여부 최종 판단
-- 독립적 context에서 실행 (메인 작업 병렬 가능)
+**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)
 
-**직접 검증 vs Agent:**
+**Direct validation vs Agent:**
 
-| 상황 | 권장 방법 |
-|------|----------|
-| 빠른 개발 중 | 직접 검증 (command) |
-| PR 생성 전 | @deployment-validator |
-| 배포 전 최종 확인 | @deployment-validator |
-| CI/CD 전 로컬 확인 | @deployment-validator |
-| 자동화된 검증 | @deployment-validator |
+| 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 |
 
 </agent_usage>
 
@@ -61,13 +77,13 @@ argument-hint: [파일/디렉토리 경로...]
 
 <required>
 
-| 분류 | 필수 |
-|------|------|
-| **Thinking** | Sequential Thinking 3-5단계 (각 오류마다) |
-| **Tracking** | TodoWrite로 오류 목록 추적 |
-| **Strategy** | typecheck + lint 병렬 실행 → 순차 수정 → build |
-| **Validation** | 각 파일 수정 후 해당 파일 재검사 |
-| **Build** | 모든 오류 해결 후 build 실행 및 성공 확인 |
+| 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 |
 
 </required>
 
@@ -75,32 +91,32 @@ argument-hint: [파일/디렉토리 경로...]
 
 <workflow>
 
-1. **병렬 검사**
+1. **Parallel check**
    ```bash
    npx tsc --noEmit
    npx eslint .
    ```
 
-2. **TodoWrite 생성**
-   - typecheck 오류 목록
-   - lint 오류 목록
-   - 우선순위: 타입 오류 → 린트 오류 → 린트 경고
+2. **Create TodoWrite**
+   - List typecheck errors
+   - List lint errors
+   - Priority: type errors → lint errors → lint warnings
 
-3. **순차 수정** (각 오류마다)
-   - Sequential Thinking 3-5단계
-   - 수정 적용
-   - 해당 파일 재검사
-   - TodoWrite 업데이트 (completed)
+3. **Sequential fix** (per error)
+   - Sequential Thinking 3-5 steps
+   - Apply fix
+   - Recheck file
+   - Update TodoWrite (completed)
 
-4. **Build 실행**
+4. **Run build**
    ```bash
-   # package.json scripts 확인 후 실행
+   # Verify package.json scripts then run
    npm run build  # or yarn build, pnpm build
    ```
 
-5. **Build 성공 확인**
-   - 오류 발생 시 Sequential Thinking으로 분석 및 수정
-   - 성공 시 배포 준비 완료
+5. **Verify build success**
+   - If errors occur, analyze and fix with Sequential Thinking
+   - If successful, ready for deployment
 
 </workflow>
 
@@ -108,24 +124,24 @@ argument-hint: [파일/디렉토리 경로...]
 
 <sequential_thinking>
 
-**각 오류마다 필수:**
+**Required for each error:**
 
-| 단계 | 내용 |
-|------|------|
-| 1 | 오류 메시지 분석 및 이해 |
-| 2 | 관련 코드 컨텍스트 파악 |
-| 3 | 근본 원인 식별 |
-| 4 | 수정 방안 검토 (여러 옵션 고려) |
-| 5 | 최적 수정 방안 선택 및 적용 |
+| 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 |
 
-**파라미터:**
+**Parameters:**
 
 ```typescript
 {
-  thought: "현재 사고 내용",
+  thought: "Current thinking content",
   nextThoughtNeeded: true | false,
-  thoughtNumber: 1, // 현재 단계
-  totalThoughts: 5  // 예상 총 단계 (동적 조정 가능)
+  thoughtNumber: 1, // current step
+  totalThoughts: 5  // expected total steps (dynamic)
 }
 ```
 
@@ -135,34 +151,34 @@ argument-hint: [파일/디렉토리 경로...]
 
 <commands>
 
-**검사:**
+**Check:**
 
 ```bash
-# TypeScript (전체)
+# TypeScript (all)
 npx tsc --noEmit
 
-# TypeScript (특정 파일)
+# TypeScript (specific file)
 npx tsc --noEmit $ARGUMENTS
 
-# ESLint (전체)
+# ESLint (all)
 npx eslint .
 
-# ESLint (특정 파일/디렉토리)
+# ESLint (specific file/directory)
 npx eslint $ARGUMENTS
 
-# Build (package.json 확인 필요)
+# Build (requires package.json check)
 npm run build
 yarn build
 pnpm build
 ```
 
-**인수 처리:**
+**Argument handling:**
 
-| 인수 | 동작 |
-|------|------|
-| 없음 | 전체 프로젝트 검사 + build |
-| 파일 경로 | 해당 파일만 검사 (build 생략) |
-| 디렉토리 | 해당 디렉토리만 검사 (build 생략) |
+| Argument | Action |
+|----------|--------|
+| None | Check entire project + build |
+| File path | Check that file only (skip build) |
+| Directory | Check that directory only (skip build) |
 
 </commands>
 
@@ -170,73 +186,73 @@ pnpm build
 
 <examples>
 
-**Example 1: 전체 워크플로우**
+**Example 1: Full workflow**
 
 ```
-1. 병렬 검사 실행
+1. Run parallel check
    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)
+2. Create TodoWrite
+   - Fix TS2322 error (src/utils/calc.ts:15)
+   - Fix 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() 제거가 적절"
+   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"
 
-4. Edit으로 수정 → npx tsc --noEmit src/utils/calc.ts 재검사 → 해결
+4. Fix with Edit → recheck with npx tsc --noEmit src/utils/calc.ts → resolved
 
-5. TodoWrite 업데이트 (completed) → 다음 오류
+5. Update TodoWrite (completed) → next error
 
-6. 모든 오류 해결 후 build 실행
+6. After all errors resolved, run build
    npm run build → ✅ Build successful
 
-7. 배포 준비 완료
+7. Ready for deployment
 ```
 
-**Example 2: 우선순위**
+**Example 2: Priority**
 
-| 우선순위 | 유형 | 예시 |
-|----------|------|------|
-| 1 | 타입 오류 (컴파일 차단) | TS2322, TS2345, TS2339 |
-| 2 | 린트 오류 (error 레벨) | no-unused-vars, no-undef |
-| 3 | 린트 경고 (warning 레벨) | prefer-const, no-console |
+| 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 |
 
-**Example 3: Build 실패 시나리오**
+**Example 3: Build failure scenario**
 
 ```
-1. typecheck + lint 통과
+1. typecheck + lint pass
 
-2. npm run build 실행
+2. Run 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'로 수정"
+   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'"
 
-4. Edit으로 수정 → npm run build 재실행 → ✅ 성공
+4. Fix with Edit → rerun npm run build → ✅ success
 ```
 
-**Example 4: 부분 검사 (인수 제공)**
+**Example 4: Partial check (with arguments)**
 
 ```bash
-# 특정 파일만 검사 (build 생략)
+# Check only specific file (skip build)
 /pre-deploy src/utils/calc.ts
 
 → npx tsc --noEmit src/utils/calc.ts
 → npx eslint src/utils/calc.ts
-→ 오류 수정
-→ build는 실행하지 않음
+→ Fix errors
+→ Don't run build
 ```
 
 </examples>