@kood/claude-code 0.1.9 → 0.1.11

package/templates/hono/docs/commands/git-session.md

@@ -0,0 +1,91 @@
+---
+description: 현재 세션에서 수정한 파일만 커밋 후 푸시
+allowed-tools: Bash(git:*)
+---
+
+이 세션에서 수정한 파일만 논리적 단위로 분리하여 커밋 후 푸시.
+
+## 실행 흐름
+
+```
+1. git status + git diff (병렬 실행)
+2. 대화 맥락에서 이 세션에 수정한 파일 목록 파악
+3. 해당 파일만 논리적 단위로 git add + git commit (반복)
+4. git status (완료 확인)
+5. git push
+```
+
+## 세션 파일 판별
+
+**대화 맥락에서 Edit/Write 도구로 수정한 파일만 대상**
+
+- 이 세션에서 직접 수정하지 않은 파일은 절대 stage하지 않음
+- 다른 변경사항은 unstaged 상태로 유지
+
+## 병렬 실행
+
+**초기 분석 단계에서 병렬 실행 필수:**
+
+```bash
+# 동시에 실행 (두 Bash 호출을 하나의 응답에서)
+git status
+git diff
+```
+
+## CRITICAL: 절대 금지
+
+| 금지 항목 |
+|----------|
+| "Generated with Claude Code" 포함 |
+| "🤖" 또는 AI 관련 이모지 |
+| "Co-Authored-By:" 헤더 |
+| AI/봇 작성 표시 일체 |
+| 여러 줄 커밋 메시지 |
+| 커밋 메시지에 마침표(.) |
+| 여러 작업 하나로 퉁치기 |
+| 세션에서 수정하지 않은 파일 커밋 |
+
+## 커밋 규칙
+
+**형식**: `<prefix>: <설명>` (한 줄, 본문/푸터 없음)
+
+**핵심 원칙**: 하나의 커밋 = 하나의 논리적 변경
+
+### Prefix
+
+| Prefix | 용도 |
+|--------|------|
+| feat | 새 기능 |
+| fix | 버그 수정 |
+| refactor | 리팩토링 |
+| style | 코드 스타일 |
+| docs | 문서 수정 |
+| test | 테스트 |
+| chore | 빌드/설정 |
+| perf | 성능 개선 |
+| ci | CI/CD |
+
+### 분리 기준
+
+| 분리 필요 | 묶어도 됨 |
+|----------|----------|
+| 서로 다른 기능 | 동일 기능의 관련 파일들 |
+| 버그 수정 + 새 기능 | 동일 기능의 타입 + 구현 |
+| 코드 변경 + 문서 변경 | |
+| 리팩토링 + 기능 추가 | |
+
+## 예시
+
+```bash
+# ✅ 올바른
+feat: 사용자 로그인 기능 추가
+fix: 세션 만료 오류 수정
+refactor: 서비스 클래스 구조 개선
+
+# ❌ 잘못된
+사용자 인증 기능 추가함     # prefix 없음
+feat: 사용자 인증 추가.     # 마침표
+FEAT: 사용자 인증 추가      # 대문자
+feat(auth): 인증 추가       # scope 불필요
+feat: 로그인, 회원가입, 프로필  # 여러 작업 퉁침
+```

package/templates/hono/docs/commands/git.md

@@ -0,0 +1,86 @@
+---
+description: Git 상태 확인 및 커밋 작업
+allowed-tools: Bash(git:*)
+argument-hint: [push|pull|커밋 지시사항...]
+---
+
+Git 상태 확인 후 아래 규칙에 따라 작업 진행.
+
+**지시사항**: $ARGUMENTS
+
+## 실행 흐름
+
+```
+$ARGUMENTS 있음 → 해당 지시 우선 수행
+$ARGUMENTS 없음 → 기본 동작:
+  1. git status + git diff (병렬 실행)
+  2. 논리적 단위로 분리하여 git add + git commit
+  3. git status (완료 확인)
+```
+
+## 병렬 실행
+
+**초기 분석 단계에서 병렬 실행 필수:**
+
+```bash
+# 동시에 실행 (두 Bash 호출을 하나의 응답에서)
+git status
+git diff
+```
+
+## CRITICAL: 절대 금지
+
+| 금지 항목 |
+|----------|
+| "Generated with Claude Code" 포함 |
+| "🤖" 또는 AI 관련 이모지 |
+| "Co-Authored-By:" 헤더 |
+| AI/봇 작성 표시 일체 |
+| 여러 줄 커밋 메시지 |
+| 커밋 메시지에 마침표(.) |
+| 여러 작업 하나로 퉁치기 |
+
+## 커밋 규칙
+
+**형식**: `<prefix>: <설명>` (한 줄, 본문/푸터 없음)
+
+**핵심 원칙**: 하나의 커밋 = 하나의 논리적 변경
+
+### Prefix
+
+| Prefix | 용도 |
+|--------|------|
+| feat | 새 기능 |
+| fix | 버그 수정 |
+| refactor | 리팩토링 |
+| style | 코드 스타일 |
+| docs | 문서 수정 |
+| test | 테스트 |
+| chore | 빌드/설정 |
+| perf | 성능 개선 |
+| ci | CI/CD |
+
+### 분리 기준
+
+| 분리 필요 | 묶어도 됨 |
+|----------|----------|
+| 서로 다른 기능 | 동일 기능의 관련 파일들 |
+| 버그 수정 + 새 기능 | 동일 기능의 타입 + 구현 |
+| 코드 변경 + 문서 변경 | |
+| 리팩토링 + 기능 추가 | |
+
+## 예시
+
+```bash
+# ✅ 올바른
+feat: 사용자 로그인 기능 추가
+fix: 세션 만료 오류 수정
+refactor: 서비스 클래스 구조 개선
+
+# ❌ 잘못된
+사용자 인증 기능 추가함     # prefix 없음
+feat: 사용자 인증 추가.     # 마침표
+FEAT: 사용자 인증 추가      # 대문자
+feat(auth): 인증 추가       # scope 불필요
+feat: 로그인, 회원가입, 프로필  # 여러 작업 퉁침
+```

package/templates/hono/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/hono/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 스크립트 추가 제안
+- [ ] 테스트 실행 안내