@kood/claude-code 0.3.7 → 0.3.9

package/templates/.claude/commands/lint-fix.md

@@ -1,68 +1,84 @@
 ---
 description: tsc/eslint 오류 검사 및 하나씩 꼼꼼히 수정. @lint-fixer 에이전트 필수 사용.
 allowed-tools: Task
-argument-hint: [파일/디렉토리 경로...]
+argument-hint: [file/directory paths...]
 ---
 
+<critical_instruction>
+
+**CRITICAL: 사용자와의 모든 커뮤니케이션은 반드시 한국어로 작성하세요.**
+
+- 내부 사고와 분석은 영어로 해도 됨
+- 설명, 요약, 보고서, 피드백 등 사용자에게 전달하는 모든 내용은 반드시 한국어
+- 사용자가 영어로 말하더라도 답변은 한국어로
+- 진행 상황 업데이트와 상태 보고는 반드시 한국어
+
+이 규칙은 절대적이며 예외가 없습니다.
+
+</critical_instruction>
+
+---
+
+
 # Lint Fix Command
 
-> @lint-fixer 에이전트를 사용하여 tsc/eslint 오류를 자동으로 수정.
+> Automatically fix tsc/eslint errors using the @lint-fixer agent.
 
 ---
 
 <critical_requirements>
 
-## ⚠️ CRITICAL: 작업 시작 전 필수 확인
+## ⚠️ CRITICAL: Required checks before proceeding
 
-**이 커맨드는 반드시 @lint-fixer 에이전트를 사용해야 합니다.**
+**This command must use the @lint-fixer agent.**
 
-### MANDATORY: Task 도구로 @lint-fixer 호출
+### MANDATORY: Call @lint-fixer with Task tool
 
 ```typescript
 Task({
   subagent_type: 'lint-fixer',
-  description: 'tsc/eslint 오류 수정',
+  description: 'Fix tsc/eslint errors',
   prompt: `
-    $ARGUMENTS 처리:
-    ${$ARGUMENTS ? `특정 경로: ${$ARGUMENTS}` : '전체 프로젝트 검사'}
-
-    수행할 작업:
-    1. tsc + eslint 병렬 검사
-    2. 오류 분류 (간단/복잡)
-    3. TodoWrite로 오류 목록 생성
-    4. 간단한 오류: 즉시 수정
-    5. 복잡한 오류: Sequential Thinking으로 분석 후 수정
-    6. 전체 재검사로 완료 확인
+    Handle $ARGUMENTS:
+    ${$ARGUMENTS ? `Specific paths: ${$ARGUMENTS}` : 'Check entire project'}
+
+    Tasks to perform:
+    1. Run tsc + eslint in parallel
+    2. Classify errors (simple/complex)
+    3. Create error list with TodoWrite
+    4. Simple errors: fix immediately
+    5. Complex errors: analyze with Sequential Thinking then fix
+    6. Verify with full recheck
   `
 })
 ```
 
-**❌ 절대 금지:**
-- Bash 도구로 tsc/eslint 직접 실행 후 수동 수정
-- @lint-fixer 없이 오류 수정
-- 커맨드 내에서 직접 오류 분석/수정
+**❌ Absolutely forbidden:**
+- Execute tsc/eslint directly with Bash tool and manually fix
+- Fix errors without @lint-fixer
+- Analyze/fix errors directly in command
 
-**✅ 필수:**
-- Task 도구로 @lint-fixer 에이전트 호출
-- 모든 lint 작업을 에이전트에 위임
-- 에이전트가 자동으로 간단/복잡 판단 후 처리
+**✅ Required:**
+- Call @lint-fixer agent with Task tool
+- Delegate all lint work to agent
+- Agent automatically judges simple/complex and handles accordingly
 
-**@lint-fixer 에이전트 장점:**
-- 간단한 오류는 즉시 수정 (Sequential Thinking 불필요)
-- 복잡한 오류만 Sequential Thinking 사용 (효율적)
-- TodoWrite로 진행 상황 자동 추적
-- 우선순위 자동 정렬 (타입 오류 → 린트 오류)
+**@lint-fixer agent benefits:**
+- Simple errors fixed immediately (no Sequential Thinking needed)
+- Complex errors analyzed with Sequential Thinking only (efficient)
+- Auto-track progress with TodoWrite
+- Auto-prioritize (type errors → lint errors)
 
 ---
 
-**진행 전 자가 점검:**
+**Self-check before proceeding:**
 ```text
-□ Task 도구 사용 준비?
-□ @lint-fixer 에이전트로 작업 위임?
-□ Bash로 tsc/eslint 직접 실행 안 함?
+□ Task tool ready to use?
+□ Delegating work to @lint-fixer agent?
+□ Not executing tsc/eslint directly with Bash?
 ```
 
-**⚠️ 위 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
+**⚠️ Do not start if checklist is not complete.**
 
 </critical_requirements>
 
@@ -70,11 +86,11 @@ Task({
 
 <forbidden>
 
-| 분류 | 금지 |
-|------|------|
-| **회피** | `any` 타입, `@ts-ignore`, `eslint-disable` 남발 |
-| **전략** | 여러 오류 동시 수정, 오류 메시지만 보고 급하게 수정 |
-| **분석** | Sequential Thinking 없이 수정 |
+| Category | Forbidden |
+|----------|-----------|
+| **Avoidance** | Excessive `any` type, `@ts-ignore`, `eslint-disable` |
+| **Strategy** | Fix multiple errors simultaneously, fix hastily based on error message alone |
+| **Analysis** | Fix without Sequential Thinking |
 
 </forbidden>
 
@@ -82,34 +98,34 @@ Task({
 
 <agent_usage>
 
-## @lint-fixer Agent 활용
+## @lint-fixer Agent Usage
 
-**언제 사용:**
-- 10개 이상 오류
-- 복잡한 타입 오류 다수
-- 백그라운드에서 자동 수정 원할 때
+**When to use:**
+- 10+ errors
+- Multiple complex type errors
+- Want automatic fixing in background
 
-**호출 방법:**
+**How to call:**
 ```bash
 @lint-fixer
-# 또는 자연어
-"lint 오류 자동으로 수정해줘"
+# or natural language
+"Fix lint errors automatically"
 ```
 
-**장점:**
-- 간단한 오류는 즉시 수정 (Sequential Thinking 불필요)
-- 복잡한 오류만 Sequential Thinking 사용 (효율적)
-- 독립적 context에서 실행 (메인 작업 병렬 가능)
+**Benefits:**
+- Simple errors fixed immediately (no Sequential Thinking needed)
+- Complex errors analyzed with Sequential Thinking only (efficient)
+- Run in independent context (can parallelize with main work)
 
-**직접 수정 vs Agent:**
+**Direct fix vs Agent:**
 
-| 상황 | 권장 방법 |
-|------|----------|
-| 1-5개 오류, 간단 | 직접 수정 (command) |
-| 10개 이상 오류 | @lint-fixer |
-| 복잡한 타입 오류 다수 | @lint-fixer |
-| 빠른 수정 필요 | 직접 수정 |
-| 백그라운드 실행 | @lint-fixer |
+| Situation | Recommended |
+|-----------|-------------|
+| 1-5 simple errors | Direct fix (command) |
+| 10+ errors | @lint-fixer |
+| Multiple complex type errors | @lint-fixer |
+| Quick fix needed | Direct fix |
+| Background execution | @lint-fixer |
 
 </agent_usage>
 
@@ -117,13 +133,13 @@ Task({
 
 <required>
 
-| 분류 | 필수 |
-|------|------|
-| **Thinking** | Sequential Thinking 3-5단계 (각 오류마다) |
-| **Tracking** | TodoWrite로 오류 목록 추적 |
-| **Strategy** | 하나씩 수정 → 재검사 → 다음 오류 |
-| **Validation** | 각 파일 수정 후 해당 파일 재검사 |
-| **Parallel** | 5개 이상 독립 오류 → Task 도구로 병렬 분석 |
+| Category | Required |
+|----------|----------|
+| **Thinking** | Sequential Thinking 3-5 steps per error |
+| **Tracking** | Track error list with TodoWrite |
+| **Strategy** | Fix one → recheck → next error |
+| **Validation** | Recheck each file after fixing |
+| **Parallel** | 5+ independent errors → parallel analysis with Task |
 
 </required>
 
@@ -131,22 +147,22 @@ Task({
 
 <workflow>
 
-1. **검사**
+1. **Check**
    ```bash
    npx tsc --noEmit
    npx eslint .
    ```
 
-2. **TodoWrite 생성**
-   - 오류 목록 정리
+2. **Create TodoWrite**
+   - Organize error list
 
-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. **전체 재검사**
+4. **Full recheck**
 
 </workflow>
 
@@ -154,24 +170,24 @@ Task({
 
 <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)
 }
 ```
 
@@ -181,28 +197,28 @@ Task({
 
 <parallel_strategy>
 
-**5개 이상 오류 시:**
+**With 5+ errors:**
 
 ```
-1. 독립적 오류 그룹 식별
-2. Task 도구로 병렬 분석 (단일 메시지에 다중 Task 호출)
-3. 분석 결과 취합 후 순차 수정
+1. Identify independent error groups
+2. Parallel analysis with Task (multiple Task calls in single message)
+3. Combine results then sequential fix
 ```
 
-**규칙:**
+**Rules:**
 
-| 규칙 | 설명 |
-|------|------|
-| 독립성 확인 | 같은 파일/연관 타입 → 순차 처리 |
-| 분석만 병렬 | 수정 적용은 항상 순차 |
-| 결과 검증 | 충돌 시 Sequential Thinking으로 해결 |
+| Rule | Description |
+|------|-------------|
+| Check independence | Same file/related type → sequential |
+| Parallel analysis only | Always sequential fix application |
+| Validate results | Conflicts → resolve with Sequential Thinking |
 
 **subagent_type:**
 
-| 유형 | 용도 |
-|------|------|
-| `Explore` | 오류 관련 코드 컨텍스트 탐색 |
-| `general-purpose` | 복잡한 타입 오류 심층 분석 |
+| Type | Purpose |
+|------|---------|
+| `Explore` | Explore code context related to error |
+| `general-purpose` | Deep analysis of complex type errors |
 
 </parallel_strategy>
 
@@ -210,29 +226,29 @@ Task({
 
 <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
 ```
 
-**인수 처리:**
+**Argument handling:**
 
-| 인수 | 동작 |
-|------|------|
-| 없음 | 전체 프로젝트 검사 |
-| 파일 경로 | 해당 파일만 |
-| 디렉토리 | 해당 디렉토리만 |
+| Argument | Action |
+|----------|--------|
+| None | Check entire project |
+| File path | Check that file only |
+| Directory | Check that directory only |
 
 </commands>
 
@@ -240,46 +256,46 @@ npx eslint $ARGUMENTS
 
 <examples>
 
-**Example 1: Sequential Thinking 워크플로우**
+**Example 1: Sequential Thinking workflow**
 
 ```
-1. npx tsc --noEmit 실행
+1. Run npx tsc --noEmit
    → TS2322: Type 'string' is not assignable to type 'number'
 
-2. Sequential Thinking 시작:
-   thought 1: "TS2322 오류. string을 number에 할당 시도"
-   thought 2: "해당 파일의 변수 타입과 값 확인 필요"
-   thought 3: "함수 반환 타입이 number인데 string 반환 중"
-   thought 4: "수정 옵션: 1) 반환값 수정 2) 타입 수정"
-   thought 5: "반환값을 올바른 number로 수정하는 것이 적절"
+2. Start Sequential Thinking:
+   thought 1: "TS2322 error. Assigning string to number"
+   thought 2: "Need to check variable type and value in file"
+   thought 3: "Function return type is number but returning string"
+   thought 4: "Fix options: 1) Fix return value 2) Change type"
+   thought 5: "Fixing return value to correct number is appropriate"
 
-3. Edit으로 수정 적용
+3. Apply fix with Edit
 
-4. npx tsc --noEmit $FILE 재검사 → 해결 확인
+4. Recheck with npx tsc --noEmit $FILE → confirm resolution
 
-5. TodoWrite 업데이트 (completed) → 다음 오류
+5. Update TodoWrite (completed) → next error
 ```
 
-**Example 2: 병렬 처리 (5개 이상 오류)**
+**Example 2: Parallel processing (5+ errors)**
 
 ```
-독립적 파일 3개의 오류 발견:
+Found 3 independent file errors:
 
-Task 1: "src/utils/api.ts의 TS2322 분석 - 타입 불일치 원인과 수정 방안"
-Task 2: "src/components/Form.tsx의 ESLint no-unused-vars 분석"
-Task 3: "src/hooks/useAuth.ts의 TS2532 분석 - undefined 체크 위치"
+Task 1: "Analyze TS2322 in src/utils/api.ts - type mismatch cause and fix"
+Task 2: "Analyze ESLint no-unused-vars in src/components/Form.tsx"
+Task 3: "Analyze TS2532 in src/hooks/useAuth.ts - undefined check location"
 
-→ 3개 Task 병렬 실행 (단일 메시지)
-→ 결과 취합 후 Sequential Thinking으로 수정 순서 결정
-→ 순차 수정 적용
+→ Run 3 Tasks in parallel (single message)
+→ Combine results then use Sequential Thinking to determine fix order
+→ Apply sequential fixes
 ```
 
-**Example 3: 우선순위**
+**Example 3: Priority**
 
-| 우선순위 | 유형 | 예시 |
-|----------|------|------|
-| 1 | 타입 오류 (컴파일 차단) | TS2322, TS2345 |
-| 2 | 린트 오류 (error 레벨) | no-unused-vars |
-| 3 | 린트 경고 (warning 레벨) | prefer-const |
+| Priority | Type | Example |
+|----------|------|---------|
+| 1 | Type errors (blocks compile) | TS2322, TS2345 |
+| 2 | Lint errors (error level) | no-unused-vars |
+| 3 | Lint warnings (warning level) | prefer-const |
 
 </examples>