@kood/claude-code 0.1.12 → 0.1.13

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

@@ -1,170 +0,0 @@
----
-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

@@ -1,300 +0,0 @@
----
-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

@@ -1,176 +0,0 @@
----
-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