@kood/claude-code 0.1.10 → 0.1.12

package/templates/tanstack-start/docs/commands/lint-fix.md

@@ -0,0 +1,170 @@
+---
+description: tsc/eslint 오류 검사 및 하나씩 꼼꼼히 수정. ultrathink + sequential thinking 필수 사용.
+allowed-tools: Bash(tsc:*, npx:*, yarn:*, npm:*, pnpm:*), Read, Edit, mcp__sequential-thinking__sequentialthinking
+argument-hint: [파일/디렉토리 경로...]
+---
+
+# Lint Fix Command
+
+tsc와 eslint 오류를 검사하고 하나씩 꼼꼼히 수정하는 커맨드.
+
+## CRITICAL: 필수 요구사항
+
+| 요구사항 | 설명 |
+|----------|------|
+| **Ultrathink** | 깊은 사고로 오류 분석. 급하게 수정하지 않음 |
+| **Sequential Thinking** | `mcp__sequential-thinking__sequentialthinking` 도구 필수 사용 |
+| **하나씩 수정** | 한 번에 하나의 오류만 집중. 여러 오류 동시 수정 금지 |
+
+## 실행 흐름
+
+```
+1. tsc --noEmit 실행 → 타입 오류 수집
+2. eslint 실행 → 린트 오류 수집
+3. 오류 목록 정리 → TodoWrite로 추적
+4. 각 오류마다:
+   a. Sequential Thinking으로 원인 분석 (최소 3단계)
+   b. 오류의 근본 원인 파악
+   c. 안전한 수정 방안 도출
+   d. 수정 적용
+   e. 수정 후 해당 파일 재검사
+5. 모든 오류 수정 완료 후 전체 재검사
+```
+
+## Sequential Thinking 사용법
+
+**각 오류마다 반드시 Sequential Thinking 실행:**
+
+```
+오류 분석 시:
+- thoughtNumber: 1 → 오류 메시지 분석 및 이해
+- thoughtNumber: 2 → 관련 코드 컨텍스트 파악
+- thoughtNumber: 3 → 근본 원인 식별
+- thoughtNumber: 4 → 수정 방안 검토 (여러 옵션 고려)
+- thoughtNumber: 5 → 최적 수정 방안 선택 및 적용
+```
+
+**Sequential Thinking 파라미터:**
+
+| 파라미터 | 설명 |
+|----------|------|
+| `thought` | 현재 사고 내용 |
+| `nextThoughtNeeded` | 추가 분석 필요 여부 |
+| `thoughtNumber` | 현재 단계 번호 |
+| `totalThoughts` | 예상 총 단계 (동적 조정 가능) |
+
+## 오류 검사 명령어
+
+**타입 검사 (tsc):**
+```bash
+# npm/yarn/pnpm 프로젝트
+npx tsc --noEmit
+
+# 특정 파일만
+npx tsc --noEmit $ARGUMENTS
+```
+
+**린트 검사 (eslint):**
+```bash
+# 전체 프로젝트
+npx eslint .
+
+# 특정 파일/디렉토리
+npx eslint $ARGUMENTS
+```
+
+## 수정 원칙
+
+### DO
+
+- 오류 메시지를 정확히 이해
+- 관련 코드 전체를 파악
+- 타입 정의, 인터페이스 확인
+- 수정 전후 비교 분석
+- 수정이 다른 곳에 영향 주는지 확인
+
+### DON'T
+
+- 오류 메시지만 보고 급하게 수정
+- `any` 타입으로 회피
+- `// @ts-ignore` 추가
+- `eslint-disable` 남용
+- 여러 오류 한 번에 수정
+
+## 오류 우선순위
+
+| 우선순위 | 유형 |
+|----------|------|
+| 1 | 타입 오류 (컴파일 차단) |
+| 2 | 린트 오류 (error 레벨) |
+| 3 | 린트 경고 (warning 레벨) |
+
+## 예시 워크플로우
+
+```
+1. "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로 수정하는 것이 적절"
+
+3. Edit으로 수정 적용
+
+4. 해당 파일 재검사
+   → 오류 해결 확인
+
+5. 다음 오류로 이동
+```
+
+## 병렬 처리 전략
+
+**다수 오류 발견 시 Task 도구로 병렬 분석:**
+
+```
+오류가 5개 이상일 때:
+1. 오류 목록 수집 후 독립적인 오류 그룹 식별
+2. Task 도구로 각 파일/오류 그룹을 병렬 분석
+3. 분석 결과 취합 후 순차적으로 수정 적용
+```
+
+**Task 도구 활용 예시:**
+
+```
+# 독립적인 파일들의 오류를 병렬로 분석
+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 호출)
+→ 결과 취합 후 Sequential Thinking으로 수정 순서 결정
+→ 순차적으로 수정 적용
+```
+
+**병렬 처리 규칙:**
+
+| 규칙 | 설명 |
+|------|------|
+| 독립성 확인 | 같은 파일/연관 타입의 오류는 순차 처리 |
+| 분석만 병렬 | 수정 적용은 항상 순차적으로 |
+| 결과 검증 | 병렬 분석 결과 충돌 시 Sequential Thinking으로 해결 |
+
+**subagent_type 선택:**
+
+| 유형 | 용도 |
+|------|------|
+| `Explore` | 오류 관련 코드 컨텍스트 탐색 |
+| `general-purpose` | 복잡한 타입 오류 심층 분석 |
+
+## 인수 처리
+
+| 인수 | 동작 |
+|------|------|
+| 없음 | 전체 프로젝트 검사 |
+| 파일 경로 | 해당 파일만 검사 |
+| 디렉토리 | 해당 디렉토리만 검사 |
+
+**인수**: $ARGUMENTS

package/templates/tanstack-start/docs/commands/lint-init.md

@@ -0,0 +1,300 @@
+---
+description: 프로젝트 분석 후 ESLint flat config 설정. Sequential Thinking 필수.
+allowed-tools: Read, Write, Edit, Glob, Bash(npm:*, yarn:*, pnpm:*, npx:*, node:*), mcp__sequential-thinking__sequentialthinking
+---
+
+# Lint Init Command
+
+프로젝트 구조를 분석하고 ESLint flat config를 설정하는 커맨드.
+
+## CRITICAL: 필수 요구사항
+
+| 요구사항 | 설명 |
+|----------|------|
+| **Sequential Thinking** | `mcp__sequential-thinking__sequentialthinking` 도구로 프로젝트 분석 |
+| **Flat Config** | ESLint v9+ flat config (`eslint.config.js`) 사용 |
+| **기존 설정 확인** | 기존 ESLint 설정 존재 시 사용자 확인 |
+
+## 실행 흐름
+
+```
+1. Sequential Thinking으로 프로젝트 분석 시작 (최소 5단계)
+2. 핵심 파일 수집:
+   - package.json (의존성, 스크립트)
+   - tsconfig.json (TypeScript 설정)
+   - 기존 ESLint 설정 (.eslintrc.*, eslint.config.*)
+3. 프로젝트 특성 파악:
+   - 언어: TypeScript / JavaScript
+   - 런타임: Node.js / Browser / 둘 다
+   - 프레임워크: React, Vue, Next.js, Express 등
+4. 적절한 ESLint 설정 생성
+5. 필요 패키지 목록 제공
+6. 설치 명령어 안내
+```
+
+## Sequential Thinking 단계
+
+```
+thought 1: package.json 분석 - 의존성에서 프레임워크/라이브러리 파악
+thought 2: tsconfig.json 분석 - TypeScript 설정 확인
+thought 3: 디렉토리 구조 분석 - src/, app/, pages/ 등 패턴 파악
+thought 4: 기존 ESLint 설정 확인 - 마이그레이션 필요 여부 판단
+thought 5: 최적 ESLint 설정 결정 - 감지된 특성에 맞는 규칙 선택
+```
+
+## 프로젝트 특성 감지
+
+### 언어 감지
+
+| 파일/설정 | 판단 |
+|-----------|------|
+| `tsconfig.json` 존재 | TypeScript |
+| `devDependencies.typescript` | TypeScript |
+| `*.ts`, `*.tsx` 파일 | TypeScript |
+| 그 외 | JavaScript |
+
+### 프레임워크 감지
+
+| 의존성 | 프레임워크 |
+|--------|-----------|
+| `react`, `react-dom` | React |
+| `next` | Next.js |
+| `vue` | Vue |
+| `@angular/core` | Angular |
+| `express` | Express |
+| `hono` | Hono |
+| `fastify` | Fastify |
+
+### 런타임 감지
+
+| 조건 | 런타임 |
+|------|--------|
+| `express`, `fastify`, `hono` | Node.js |
+| `react`, `vue`, `angular` | Browser |
+| `next`, `nuxt` | 둘 다 |
+| `package.json` type: "module" | ESM |
+
+## ESLint Flat Config 템플릿
+
+### TypeScript + Node.js
+
+```javascript
+import eslint from '@eslint/js';
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsparser from '@typescript-eslint/parser';
+import globals from 'globals';
+
+export default [
+  {
+    ignores: ['dist/**', 'node_modules/**'],
+  },
+  eslint.configs.recommended,
+  {
+    files: ['src/**/*.ts'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+        project: './tsconfig.json',
+      },
+      globals: {
+        ...globals.node,
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+    },
+    rules: {
+      ...tseslint.configs.recommended.rules,
+      '@typescript-eslint/explicit-function-return-type': 'warn',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+      ],
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/consistent-type-imports': [
+        'error',
+        { prefer: 'type-imports' },
+      ],
+      'no-unused-vars': 'off',
+      'no-undef': 'off',
+      'prefer-const': 'error',
+      'no-var': 'error',
+      eqeqeq: ['error', 'always'],
+    },
+  },
+];
+```
+
+### TypeScript + React
+
+```javascript
+import eslint from '@eslint/js';
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsparser from '@typescript-eslint/parser';
+import reactPlugin from 'eslint-plugin-react';
+import reactHooksPlugin from 'eslint-plugin-react-hooks';
+import globals from 'globals';
+
+export default [
+  {
+    ignores: ['dist/**', 'node_modules/**', 'build/**'],
+  },
+  eslint.configs.recommended,
+  {
+    files: ['src/**/*.{ts,tsx}'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+        project: './tsconfig.json',
+        ecmaFeatures: {
+          jsx: true,
+        },
+      },
+      globals: {
+        ...globals.browser,
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+      'react': reactPlugin,
+      'react-hooks': reactHooksPlugin,
+    },
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+    rules: {
+      ...tseslint.configs.recommended.rules,
+      ...reactPlugin.configs.recommended.rules,
+      ...reactHooksPlugin.configs.recommended.rules,
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+      ],
+      '@typescript-eslint/no-explicit-any': 'error',
+      'react/react-in-jsx-scope': 'off',
+      'react/prop-types': 'off',
+      'no-unused-vars': 'off',
+      'no-undef': 'off',
+    },
+  },
+];
+```
+
+### JavaScript + Node.js
+
+```javascript
+import eslint from '@eslint/js';
+import globals from 'globals';
+
+export default [
+  {
+    ignores: ['dist/**', 'node_modules/**'],
+  },
+  eslint.configs.recommended,
+  {
+    files: ['src/**/*.js'],
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      globals: {
+        ...globals.node,
+      },
+    },
+    rules: {
+      'no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+      ],
+      'prefer-const': 'error',
+      'no-var': 'error',
+      eqeqeq: ['error', 'always'],
+    },
+  },
+];
+```
+
+## 필요 패키지
+
+### 기본 (모든 프로젝트)
+
+```bash
+npm install -D eslint @eslint/js globals
+```
+
+### TypeScript 추가
+
+```bash
+npm install -D @typescript-eslint/parser @typescript-eslint/eslint-plugin
+```
+
+### React 추가
+
+```bash
+npm install -D eslint-plugin-react eslint-plugin-react-hooks
+```
+
+### Vue 추가
+
+```bash
+npm install -D eslint-plugin-vue vue-eslint-parser
+```
+
+## 기존 설정 처리
+
+### .eslintrc.* 마이그레이션
+
+기존 `.eslintrc.json`, `.eslintrc.js` 등 발견 시:
+1. 사용자에게 마이그레이션 제안
+2. 기존 규칙을 flat config 형식으로 변환
+3. 기존 파일 백업 후 삭제
+
+### package.json eslintConfig
+
+`package.json` 내 `eslintConfig` 발견 시:
+1. 해당 설정을 flat config로 변환
+2. `package.json`에서 `eslintConfig` 제거
+
+## package.json 스크립트
+
+설정 완료 후 추가할 스크립트:
+
+```json
+{
+  "scripts": {
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  }
+}
+```
+
+## 체크리스트
+
+### 분석 단계
+
+- [ ] package.json 읽기
+- [ ] tsconfig.json 확인
+- [ ] 기존 ESLint 설정 확인
+- [ ] 디렉토리 구조 파악
+- [ ] 소스 파일 패턴 확인
+
+### 설정 단계
+
+- [ ] 적절한 템플릿 선택
+- [ ] ignores 패턴 설정
+- [ ] 파일 패턴 (files) 설정
+- [ ] globals 설정
+- [ ] 규칙 커스터마이징
+
+### 완료 단계
+
+- [ ] eslint.config.js 생성
+- [ ] 필요 패키지 목록 제공
+- [ ] 설치 명령어 안내
+- [ ] package.json 스크립트 추가 제안
+- [ ] 테스트 실행 안내

package/templates/tanstack-start/docs/commands/ts-fix.md

@@ -0,0 +1,176 @@
+---
+description: tsc 타입 오류 검사 및 하나씩 꼼꼼히 수정. ultrathink + sequential thinking 필수 사용.
+allowed-tools: Bash(tsc:*, npx:*, yarn:*, npm:*, pnpm:*), Read, Edit, mcp__sequential-thinking__sequentialthinking
+argument-hint: [파일/디렉토리 경로...]
+---
+
+# TypeScript Fix Command
+
+tsc 타입 오류만 검사하고 하나씩 꼼꼼히 수정하는 커맨드.
+
+## CRITICAL: 필수 요구사항
+
+| 요구사항 | 설명 |
+|----------|------|
+| **Ultrathink** | 깊은 사고로 오류 분석. 급하게 수정하지 않음 |
+| **Sequential Thinking** | `mcp__sequential-thinking__sequentialthinking` 도구 필수 사용 |
+| **하나씩 수정** | 한 번에 하나의 오류만 집중. 여러 오류 동시 수정 금지 |
+
+## 실행 흐름
+
+```
+1. tsc --noEmit 실행 → 타입 오류 수집
+2. 오류 목록 정리 → TodoWrite로 추적
+3. 각 오류마다:
+   a. Sequential Thinking으로 원인 분석 (최소 3단계)
+   b. 오류의 근본 원인 파악
+   c. 안전한 수정 방안 도출
+   d. 수정 적용
+   e. 수정 후 해당 파일 재검사
+4. 모든 오류 수정 완료 후 전체 재검사
+```
+
+## Sequential Thinking 사용법
+
+**각 오류마다 반드시 Sequential Thinking 실행:**
+
+```
+오류 분석 시:
+- thoughtNumber: 1 → 오류 메시지 분석 및 이해
+- thoughtNumber: 2 → 관련 코드 컨텍스트 파악
+- thoughtNumber: 3 → 근본 원인 식별
+- thoughtNumber: 4 → 수정 방안 검토 (여러 옵션 고려)
+- thoughtNumber: 5 → 최적 수정 방안 선택 및 적용
+```
+
+**Sequential Thinking 파라미터:**
+
+| 파라미터 | 설명 |
+|----------|------|
+| `thought` | 현재 사고 내용 |
+| `nextThoughtNeeded` | 추가 분석 필요 여부 |
+| `thoughtNumber` | 현재 단계 번호 |
+| `totalThoughts` | 예상 총 단계 (동적 조정 가능) |
+
+## 오류 검사 명령어
+
+```bash
+# npm/yarn/pnpm 프로젝트
+npx tsc --noEmit
+
+# 특정 파일만
+npx tsc --noEmit $ARGUMENTS
+```
+
+## 수정 원칙
+
+### DO
+
+- 오류 메시지를 정확히 이해
+- 관련 코드 전체를 파악
+- 타입 정의, 인터페이스 확인
+- 제네릭 타입 파라미터 추적
+- import된 타입 출처 확인
+- 수정 전후 비교 분석
+- 수정이 다른 곳에 영향 주는지 확인
+
+### DON'T
+
+- 오류 메시지만 보고 급하게 수정
+- `any` 타입으로 회피
+- `// @ts-ignore` 추가
+- `// @ts-expect-error` 남용
+- `as unknown as T` 강제 캐스팅
+- 여러 오류 한 번에 수정
+
+## 주요 타입 오류 유형
+
+| 코드 | 설명 | 일반적 원인 |
+|------|------|-------------|
+| TS2322 | 할당 불가 | 타입 불일치 |
+| TS2345 | 인수 타입 오류 | 함수 호출 시 타입 불일치 |
+| TS2339 | 속성 없음 | 객체에 해당 속성 미존재 |
+| TS2304 | 이름 찾을 수 없음 | import 누락 또는 오타 |
+| TS2769 | 오버로드 매칭 실패 | 함수 시그니처 불일치 |
+| TS2741 | 필수 속성 누락 | 객체 리터럴에 속성 누락 |
+| TS2532 | undefined 가능성 | null/undefined 체크 필요 |
+
+## 예시 워크플로우
+
+```
+1. "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로 수정하는 것이 적절"
+
+3. Edit으로 수정 적용
+
+4. 해당 파일 재검사
+   → 오류 해결 확인
+
+5. 다음 오류로 이동
+```
+
+## 병렬 처리 전략
+
+**다수 타입 오류 발견 시 Task 도구로 병렬 분석:**
+
+```
+오류가 5개 이상일 때:
+1. 오류 목록 수집 후 독립적인 오류 그룹 식별
+2. Task 도구로 각 파일/오류 그룹을 병렬 분석
+3. 분석 결과 취합 후 순차적으로 수정 적용
+```
+
+**Task 도구 활용 예시:**
+
+```
+# 독립적인 파일들의 타입 오류를 병렬로 분석
+Task 1: "src/types/user.ts의 TS2322 분석 - 인터페이스 정의와 실제 사용 비교"
+Task 2: "src/api/client.ts의 TS2345 분석 - 함수 시그니처와 호출부 타입 확인"
+Task 3: "src/utils/format.ts의 TS2339 분석 - 객체 속성 존재 여부 및 타입 확인"
+
+→ 3개 Task 병렬 실행 (단일 메시지에 다중 Task 호출)
+→ 결과 취합 후 Sequential Thinking으로 수정 순서 결정
+→ 순차적으로 수정 적용
+```
+
+**병렬 처리 규칙:**
+
+| 규칙 | 설명 |
+|------|------|
+| 독립성 확인 | 같은 타입/인터페이스 참조 오류는 순차 처리 |
+| 분석만 병렬 | 수정 적용은 항상 순차적으로 |
+| 타입 전파 주의 | 한 타입 수정이 다른 오류에 영향 줄 수 있음 |
+| 결과 검증 | 병렬 분석 결과 충돌 시 Sequential Thinking으로 해결 |
+
+**subagent_type 선택:**
+
+| 유형 | 용도 |
+|------|------|
+| `Explore` | 타입 정의 및 사용처 탐색 |
+| `general-purpose` | 복잡한 제네릭/조건부 타입 분석 |
+
+**타입 의존성 그래프 고려:**
+
+```
+예시: UserDTO → UserService → UserController
+     ↓
+하위 타입 오류가 상위에 영향 → 하위부터 수정
+→ 병렬 분석 시에도 의존 관계 파악 필수
+```
+
+## 인수 처리
+
+| 인수 | 동작 |
+|------|------|
+| 없음 | 전체 프로젝트 검사 |
+| 파일 경로 | 해당 파일만 검사 |
+| 디렉토리 | 해당 디렉토리만 검사 |
+
+**인수**: $ARGUMENTS