@kood/claude-code 0.2.5 → 0.3.1

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

@@ -1,108 +1,249 @@
 ---
-description: tsc/eslint 오류 검사 및 하나씩 꼼꼼히 수정. ultrathink + sequential thinking 필수 사용.
-allowed-tools: Bash(tsc:*, npx:*, yarn:*, npm:*, pnpm:*), Read, Edit, mcp__sequential-thinking__sequentialthinking
+description: tsc/eslint 오류 검사 및 하나씩 꼼꼼히 수정. @lint-fixer 에이전트 필수 사용.
+allowed-tools: Task
 argument-hint: [파일/디렉토리 경로...]
 ---
 
 # Lint Fix Command
 
-tsc와 eslint 오류를 검사하고 하나씩 꼼꼼히 수정하는 커맨드.
+> @lint-fixer 에이전트를 사용하여 tsc/eslint 오류를 자동으로 수정.
 
-## CRITICAL: 필수 요구사항
+---
+
+<critical_requirements>
+
+## ⚠️ CRITICAL: 작업 시작 전 필수 확인
 
-| 요구사항 | 설명 |
-|----------|------|
-| **Ultrathink** | 깊은 사고로 오류 분석. 급하게 수정하지 않음 |
-| **Sequential Thinking** | `mcp__sequential-thinking__sequentialthinking` 도구 필수 사용 |
-| **하나씩 수정** | 한 번에 하나의 오류만 집중. 여러 오류 동시 수정 금지 |
+**이 커맨드는 반드시 @lint-fixer 에이전트를 사용해야 합니다.**
 
-## 실행 흐름
+### MANDATORY: Task 도구로 @lint-fixer 호출
 
+```typescript
+Task({
+  subagent_type: 'lint-fixer',
+  description: 'tsc/eslint 오류 수정',
+  prompt: `
+    $ARGUMENTS 처리:
+    ${$ARGUMENTS ? `특정 경로: ${$ARGUMENTS}` : '전체 프로젝트 검사'}
+
+    수행할 작업:
+    1. tsc + eslint 병렬 검사
+    2. 오류 분류 (간단/복잡)
+    3. TodoWrite로 오류 목록 생성
+    4. 간단한 오류: 즉시 수정
+    5. 복잡한 오류: Sequential Thinking으로 분석 후 수정
+    6. 전체 재검사로 완료 확인
+  `
+})
 ```
-1. tsc --noEmit 실행 → 타입 오류 수집
-2. eslint 실행 → 린트 오류 수집
-3. 오류 목록 정리 → TodoWrite로 추적
-4. 각 오류마다:
-   a. Sequential Thinking으로 원인 분석 (최소 3단계)
-   b. 오류의 근본 원인 파악
-   c. 안전한 수정 방안 도출
-   d. 수정 적용
-   e. 수정 후 해당 파일 재검사
-5. 모든 오류 수정 완료 후 전체 재검사
+
+**❌ 절대 금지:**
+- Bash 도구로 tsc/eslint 직접 실행 후 수동 수정
+- @lint-fixer 없이 오류 수정
+- 커맨드 내에서 직접 오류 분석/수정
+
+**✅ 필수:**
+- Task 도구로 @lint-fixer 에이전트 호출
+- 모든 lint 작업을 에이전트에 위임
+- 에이전트가 자동으로 간단/복잡 판단 후 처리
+
+**@lint-fixer 에이전트 장점:**
+- 간단한 오류는 즉시 수정 (Sequential Thinking 불필요)
+- 복잡한 오류만 Sequential Thinking 사용 (효율적)
+- TodoWrite로 진행 상황 자동 추적
+- 우선순위 자동 정렬 (타입 오류 → 린트 오류)
+
+---
+
+**진행 전 자가 점검:**
+```text
+□ Task 도구 사용 준비?
+□ @lint-fixer 에이전트로 작업 위임?
+□ Bash로 tsc/eslint 직접 실행 안 함?
 ```
 
-## Sequential Thinking 사용법
+**⚠️ 위 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
+
+</critical_requirements>
 
-**각 오류마다 반드시 Sequential Thinking 실행:**
+---
 
+<forbidden>
+
+| 분류 | 금지 |
+|------|------|
+| **회피** | `any` 타입, `@ts-ignore`, `eslint-disable` 남발 |
+| **전략** | 여러 오류 동시 수정, 오류 메시지만 보고 급하게 수정 |
+| **분석** | Sequential Thinking 없이 수정 |
+
+</forbidden>
+
+---
+
+<agent_usage>
+
+## @lint-fixer Agent 활용
+
+**언제 사용:**
+- 10개 이상 오류
+- 복잡한 타입 오류 다수
+- 백그라운드에서 자동 수정 원할 때
+
+**호출 방법:**
+```bash
+@lint-fixer
+# 또는 자연어
+"lint 오류 자동으로 수정해줘"
 ```
-오류 분석 시:
-- thoughtNumber: 1 → 오류 메시지 분석 및 이해
-- thoughtNumber: 2 → 관련 코드 컨텍스트 파악
-- thoughtNumber: 3 → 근본 원인 식별
-- thoughtNumber: 4 → 수정 방안 검토 (여러 옵션 고려)
-- thoughtNumber: 5 → 최적 수정 방안 선택 및 적용
+
+**장점:**
+- 간단한 오류는 즉시 수정 (Sequential Thinking 불필요)
+- 복잡한 오류만 Sequential Thinking 사용 (효율적)
+- 독립적 context에서 실행 (메인 작업 병렬 가능)
+
+**직접 수정 vs Agent:**
+
+| 상황 | 권장 방법 |
+|------|----------|
+| 1-5개 오류, 간단 | 직접 수정 (command) |
+| 10개 이상 오류 | @lint-fixer |
+| 복잡한 타입 오류 다수 | @lint-fixer |
+| 빠른 수정 필요 | 직접 수정 |
+| 백그라운드 실행 | @lint-fixer |
+
+</agent_usage>
+
+---
+
+<required>
+
+| 분류 | 필수 |
+|------|------|
+| **Thinking** | Sequential Thinking 3-5단계 (각 오류마다) |
+| **Tracking** | TodoWrite로 오류 목록 추적 |
+| **Strategy** | 하나씩 수정 → 재검사 → 다음 오류 |
+| **Validation** | 각 파일 수정 후 해당 파일 재검사 |
+| **Parallel** | 5개 이상 독립 오류 → Task 도구로 병렬 분석 |
+
+</required>
+
+---
+
+<workflow>
+
+1. **검사**
+   ```bash
+   npx tsc --noEmit
+   npx eslint .
+   ```
+
+2. **TodoWrite 생성**
+   - 오류 목록 정리
+
+3. **순차 수정** (각 오류마다)
+   - Sequential Thinking 3-5단계
+   - 수정 적용
+   - 해당 파일 재검사
+   - TodoWrite 업데이트 (completed)
+
+4. **전체 재검사**
+
+</workflow>
+
+---
+
+<sequential_thinking>
+
+**각 오류마다 필수:**
+
+| 단계 | 내용 |
+|------|------|
+| 1 | 오류 메시지 분석 및 이해 |
+| 2 | 관련 코드 컨텍스트 파악 |
+| 3 | 근본 원인 식별 |
+| 4 | 수정 방안 검토 (여러 옵션 고려) |
+| 5 | 최적 수정 방안 선택 및 적용 |
+
+**파라미터:**
+
+```typescript
+{
+  thought: "현재 사고 내용",
+  nextThoughtNeeded: true | false,
+  thoughtNumber: 1, // 현재 단계
+  totalThoughts: 5  // 예상 총 단계 (동적 조정 가능)
+}
 ```
 
-**Sequential Thinking 파라미터:**
+</sequential_thinking>
 
-| 파라미터 | 설명 |
-|----------|------|
-| `thought` | 현재 사고 내용 |
-| `nextThoughtNeeded` | 추가 분석 필요 여부 |
-| `thoughtNumber` | 현재 단계 번호 |
-| `totalThoughts` | 예상 총 단계 (동적 조정 가능) |
+---
+
+<parallel_strategy>
+
+**5개 이상 오류 시:**
+
+```
+1. 독립적 오류 그룹 식별
+2. Task 도구로 병렬 분석 (단일 메시지에 다중 Task 호출)
+3. 분석 결과 취합 후 순차 수정
+```
 
-## 오류 검사 명령어
+**규칙:**
+
+| 규칙 | 설명 |
+|------|------|
+| 독립성 확인 | 같은 파일/연관 타입 → 순차 처리 |
+| 분석만 병렬 | 수정 적용은 항상 순차 |
+| 결과 검증 | 충돌 시 Sequential Thinking으로 해결 |
+
+**subagent_type:**
+
+| 유형 | 용도 |
+|------|------|
+| `Explore` | 오류 관련 코드 컨텍스트 탐색 |
+| `general-purpose` | 복잡한 타입 오류 심층 분석 |
+
+</parallel_strategy>
+
+---
+
+<commands>
+
+**검사:**
 
-**타입 검사 (tsc):**
 ```bash
-# npm/yarn/pnpm 프로젝트
+# TypeScript (전체)
 npx tsc --noEmit
 
-# 특정 파일만
+# TypeScript (특정 파일)
 npx tsc --noEmit $ARGUMENTS
-```
 
-**린트 검사 (eslint):**
-```bash
-# 전체 프로젝트
+# ESLint (전체)
 npx eslint .
 
-# 특정 파일/디렉토리
+# ESLint (특정 파일/디렉토리)
 npx eslint $ARGUMENTS
 ```
 
-## 수정 원칙
-
-### DO
+**인수 처리:**
 
-- 오류 메시지를 정확히 이해
-- 관련 코드 전체를 파악
-- 타입 정의, 인터페이스 확인
-- 수정 전후 비교 분석
-- 수정이 다른 곳에 영향 주는지 확인
-
-### DON'T
+| 인수 | 동작 |
+|------|------|
+| 없음 | 전체 프로젝트 검사 |
+| 파일 경로 | 해당 파일만 |
+| 디렉토리 | 해당 디렉토리만 |
 
-- 오류 메시지만 보고 급하게 수정
-- `any` 타입으로 회피
-- `// @ts-ignore` 추가
-- `eslint-disable` 남용
-- 여러 오류 한 번에 수정
+</commands>
 
-## 오류 우선순위
+---
 
-| 우선순위 | 유형 |
-|----------|------|
-| 1 | 타입 오류 (컴파일 차단) |
-| 2 | 린트 오류 (error 레벨) |
-| 3 | 린트 경고 (warning 레벨) |
+<examples>
 
-## 예시 워크플로우
+**Example 1: Sequential Thinking 워크플로우**
 
 ```
-1. "npx tsc --noEmit" 실행
+1. npx tsc --noEmit 실행
    → TS2322: Type 'string' is not assignable to type 'number'
 
 2. Sequential Thinking 시작:
@@ -114,57 +255,31 @@ npx eslint $ARGUMENTS
 
 3. Edit으로 수정 적용
 
-4. 해당 파일 재검사
-   → 오류 해결 확인
+4. npx tsc --noEmit $FILE 재검사 → 해결 확인
 
-5. 다음 오류로 이동
+5. TodoWrite 업데이트 (completed) → 다음 오류
 ```
 
-## 병렬 처리 전략
-
-**다수 오류 발견 시 Task 도구로 병렬 분석:**
+**Example 2: 병렬 처리 (5개 이상 오류)**
 
 ```
-오류가 5개 이상일 때:
-1. 오류 목록 수집 후 독립적인 오류 그룹 식별
-2. Task 도구로 각 파일/오류 그룹을 병렬 분석
-3. 분석 결과 취합 후 순차적으로 수정 적용
-```
-
-**Task 도구 활용 예시:**
+독립적 파일 3개의 오류 발견:
 
-```
-# 독립적인 파일들의 오류를 병렬로 분석
-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: "src/utils/api.ts의 TS2322 분석 - 타입 불일치 원인과 수정 방안"
+Task 2: "src/components/Form.tsx의 ESLint no-unused-vars 분석"
+Task 3: "src/hooks/useAuth.ts의 TS2532 분석 - undefined 체크 위치"
 
-→ 3개 Task 병렬 실행 (단일 메시지에 다중 Task 호출)
+→ 3개 Task 병렬 실행 (단일 메시지)
 → 결과 취합 후 Sequential Thinking으로 수정 순서 결정
-→ 순차적으로 수정 적용
+→ 순차 수정 적용
 ```
 
-**병렬 처리 규칙:**
-
-| 규칙 | 설명 |
-|------|------|
-| 독립성 확인 | 같은 파일/연관 타입의 오류는 순차 처리 |
-| 분석만 병렬 | 수정 적용은 항상 순차적으로 |
-| 결과 검증 | 병렬 분석 결과 충돌 시 Sequential Thinking으로 해결 |
-
-**subagent_type 선택:**
+**Example 3: 우선순위**
 
-| 유형 | 용도 |
-|------|------|
-| `Explore` | 오류 관련 코드 컨텍스트 탐색 |
-| `general-purpose` | 복잡한 타입 오류 심층 분석 |
-
-## 인수 처리
-
-| 인수 | 동작 |
-|------|------|
-| 없음 | 전체 프로젝트 검사 |
-| 파일 경로 | 해당 파일만 검사 |
-| 디렉토리 | 해당 디렉토리만 검사 |
+| 우선순위 | 유형 | 예시 |
+|----------|------|------|
+| 1 | 타입 오류 (컴파일 차단) | TS2322, TS2345 |
+| 2 | 린트 오류 (error 레벨) | no-unused-vars |
+| 3 | 린트 경고 (warning 레벨) | prefer-const |
 
-**인수**: $ARGUMENTS
+</examples>