@kood/claude-code 0.1.3 → 0.1.5

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

@@ -0,0 +1,145 @@
+현재 git 상태를 확인하고, 아래 규칙에 따라 작업을 진행해주세요.
+
+**추가 지시사항**: $ARGUMENTS
+
+---
+
+## 실행 절차
+
+### 추가 지시사항이 없는 경우 (기본 동작)
+1. `git status`로 현재 상태 확인
+2. `git diff`로 변경 내용 분석
+3. 스테이징 안 된 변경사항 → `git add`
+4. 커밋 안 된 변경사항 → 논리적 단위로 분리하여 `git commit`
+5. 최종 `git status`로 완료 확인
+
+### 추가 지시사항이 있는 경우
+- 사용자의 지시사항을 우선적으로 따름
+- 예: `/git push` → push 진행, `/git 특정파일만 커밋` → 해당 파일만 처리
+
+---
+
+## ⛔ NEVER (절대 금지)
+
+```
+❌ 커밋에 "Generated with Claude Code" 포함
+❌ 커밋에 "🤖" 또는 AI 관련 이모지 포함
+❌ 커밋에 "Co-Authored-By:" 헤더 포함
+❌ 커밋에 AI/봇이 작성했다는 어떤 표시도 포함
+❌ 커밋 메시지 여러 줄 작성
+❌ 커밋 메시지에 이모지 사용
+❌ 커밋 메시지에 마침표(.) 사용
+❌ 여러 작업을 하나의 커밋으로 퉁치기
+```
+
+---
+
+## ✅ ALWAYS (필수)
+
+### 커밋 형식
+
+```
+<prefix>: <설명>
+```
+
+**한 줄로 간결하게** 작성합니다. 본문이나 푸터는 작성하지 않습니다.
+
+### ⭐ 커밋 분리 원칙
+
+**하나의 커밋 = 하나의 논리적 변경 단위**
+
+```bash
+# ❌ 잘못된 방식: 모든 작업을 하나로 퉁침
+git add .
+git commit -m "feat: 여러 기능 추가"
+
+# ✅ 올바른 방식: 논리적 단위로 분리
+git add src/auth/
+git commit -m "feat: 사용자 인증 기능 추가"
+
+git add src/users/
+git commit -m "feat: 사용자 관리 기능 추가"
+
+git add docs/
+git commit -m "docs: API 문서 업데이트"
+```
+
+---
+
+## 🏷 Prefix 목록
+
+| Prefix | 용도 | 예시 |
+|--------|------|------|
+| `feat` | 새로운 기능 | `feat: 사용자 인증 기능 추가` |
+| `fix` | 버그 수정 | `fix: 토큰 검증 오류 수정` |
+| `refactor` | 리팩토링 | `refactor: 인증 로직 분리` |
+| `style` | 코드 스타일 | `style: prettier 적용` |
+| `docs` | 문서 수정 | `docs: API 문서 업데이트` |
+| `test` | 테스트 | `test: 인증 테스트 추가` |
+| `chore` | 빌드/설정 | `chore: 의존성 업데이트` |
+| `perf` | 성능 개선 | `perf: 쿼리 최적화` |
+| `ci` | CI/CD | `ci: GitHub Actions 추가` |
+
+---
+
+## ✅ 올바른 예시
+
+```bash
+feat: 사용자 로그인 기능 추가
+fix: 세션 만료 오류 수정
+refactor: 서비스 클래스 구조 개선
+docs: README 설치 가이드 추가
+chore: 의존성 버전 업그레이드
+```
+
+---
+
+## ❌ 잘못된 예시
+
+```bash
+# prefix 없음
+사용자 인증 기능 추가함
+
+# 마침표 불필요
+feat: 사용자 인증 추가.
+
+# 대문자 사용
+FEAT: 사용자 인증 추가
+
+# scope 불필요
+feat(auth): 인증 추가
+
+# AI 작성 표시 (절대 금지!)
+feat: 로그인 기능 추가
+
+🤖 Generated with Claude Code
+
+# Co-Author 표시 (절대 금지!)
+feat: 로그인 기능 추가
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+
+# 여러 줄 본문 (금지)
+feat: 로그인 기능 추가
+
+- 이메일 인증 추가
+- 세션 관리 구현
+
+# 여러 작업을 하나로 퉁침 (금지)
+feat: 로그인, 회원가입, 프로필 기능 추가
+```
+
+---
+
+## 📦 커밋 분리 가이드
+
+### 언제 커밋을 분리해야 하나요?
+
+| 상황 | 커밋 분리 |
+|------|----------|
+| 서로 다른 기능 구현 | ✅ 분리 |
+| 버그 수정 + 새 기능 | ✅ 분리 |
+| 코드 변경 + 문서 변경 | ✅ 분리 |
+| 리팩토링 + 기능 추가 | ✅ 분리 |
+| 동일 기능의 관련 파일들 | 🔄 묶어도 됨 |
+| 동일 기능의 타입 + 구현 | 🔄 묶어도 됨 |

package/templates/tanstack-start/docs/commands/git.md

@@ -0,0 +1,145 @@
+현재 git 상태를 확인하고, 아래 규칙에 따라 작업을 진행해주세요.
+
+**추가 지시사항**: $ARGUMENTS
+
+---
+
+## 실행 절차
+
+### 추가 지시사항이 없는 경우 (기본 동작)
+1. `git status`로 현재 상태 확인
+2. `git diff`로 변경 내용 분석
+3. 스테이징 안 된 변경사항 → `git add`
+4. 커밋 안 된 변경사항 → 논리적 단위로 분리하여 `git commit`
+5. 최종 `git status`로 완료 확인
+
+### 추가 지시사항이 있는 경우
+- 사용자의 지시사항을 우선적으로 따름
+- 예: `/git push` → push 진행, `/git 특정파일만 커밋` → 해당 파일만 처리
+
+---
+
+## ⛔ NEVER (절대 금지)
+
+```
+❌ 커밋에 "Generated with Claude Code" 포함
+❌ 커밋에 "🤖" 또는 AI 관련 이모지 포함
+❌ 커밋에 "Co-Authored-By:" 헤더 포함
+❌ 커밋에 AI/봇이 작성했다는 어떤 표시도 포함
+❌ 커밋 메시지 여러 줄 작성
+❌ 커밋 메시지에 이모지 사용
+❌ 커밋 메시지에 마침표(.) 사용
+❌ 여러 작업을 하나의 커밋으로 퉁치기
+```
+
+---
+
+## ✅ ALWAYS (필수)
+
+### 커밋 형식
+
+```
+<prefix>: <설명>
+```
+
+**한 줄로 간결하게** 작성합니다. 본문이나 푸터는 작성하지 않습니다.
+
+### ⭐ 커밋 분리 원칙
+
+**하나의 커밋 = 하나의 논리적 변경 단위**
+
+```bash
+# ❌ 잘못된 방식: 모든 작업을 하나로 퉁침
+git add .
+git commit -m "feat: 여러 기능 추가"
+
+# ✅ 올바른 방식: 논리적 단위로 분리
+git add src/auth/
+git commit -m "feat: 사용자 인증 기능 추가"
+
+git add src/users/
+git commit -m "feat: 사용자 관리 기능 추가"
+
+git add docs/
+git commit -m "docs: API 문서 업데이트"
+```
+
+---
+
+## 🏷 Prefix 목록
+
+| Prefix | 용도 | 예시 |
+|--------|------|------|
+| `feat` | 새로운 기능 | `feat: 사용자 인증 기능 추가` |
+| `fix` | 버그 수정 | `fix: 토큰 검증 오류 수정` |
+| `refactor` | 리팩토링 | `refactor: 인증 로직 분리` |
+| `style` | 코드 스타일 | `style: prettier 적용` |
+| `docs` | 문서 수정 | `docs: API 문서 업데이트` |
+| `test` | 테스트 | `test: 인증 테스트 추가` |
+| `chore` | 빌드/설정 | `chore: 의존성 업데이트` |
+| `perf` | 성능 개선 | `perf: 쿼리 최적화` |
+| `ci` | CI/CD | `ci: GitHub Actions 추가` |
+
+---
+
+## ✅ 올바른 예시
+
+```bash
+feat: 사용자 로그인 기능 추가
+fix: 세션 만료 오류 수정
+refactor: 서비스 클래스 구조 개선
+docs: README 설치 가이드 추가
+chore: 의존성 버전 업그레이드
+```
+
+---
+
+## ❌ 잘못된 예시
+
+```bash
+# prefix 없음
+사용자 인증 기능 추가함
+
+# 마침표 불필요
+feat: 사용자 인증 추가.
+
+# 대문자 사용
+FEAT: 사용자 인증 추가
+
+# scope 불필요
+feat(auth): 인증 추가
+
+# AI 작성 표시 (절대 금지!)
+feat: 로그인 기능 추가
+
+🤖 Generated with Claude Code
+
+# Co-Author 표시 (절대 금지!)
+feat: 로그인 기능 추가
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+
+# 여러 줄 본문 (금지)
+feat: 로그인 기능 추가
+
+- 이메일 인증 추가
+- 세션 관리 구현
+
+# 여러 작업을 하나로 퉁침 (금지)
+feat: 로그인, 회원가입, 프로필 기능 추가
+```
+
+---
+
+## 📦 커밋 분리 가이드
+
+### 언제 커밋을 분리해야 하나요?
+
+| 상황 | 커밋 분리 |
+|------|----------|
+| 서로 다른 기능 구현 | ✅ 분리 |
+| 버그 수정 + 새 기능 | ✅ 분리 |
+| 코드 변경 + 문서 변경 | ✅ 분리 |
+| 리팩토링 + 기능 추가 | ✅ 분리 |
+| 동일 기능의 관련 파일들 | 🔄 묶어도 됨 |
+| 동일 기능의 타입 + 구현 | 🔄 묶어도 됨 |

package/templates/tanstack-start/docs/deployment/cloudflare.md

@@ -39,7 +39,7 @@ export default defineConfig({
 ```
 
 ```bash
-pnpm build && wrangler deploy
+yarn build && wrangler deploy
 ```
 
 ---
@@ -60,7 +60,7 @@ TanStack Start 공식 권장 방식입니다.
 ### 1. 패키지 설치
 
 ```bash
-pnpm add -D @cloudflare/vite-plugin wrangler
+yarn add -D @cloudflare/vite-plugin wrangler
 ```
 
 ### 2. Vite 설정
@@ -98,13 +98,13 @@ export default defineConfig({
 
 ```bash
 # 빌드
-pnpm build
+yarn build
 
 # 배포
 wrangler deploy
 
 # 또는 한번에
-pnpm build && wrangler deploy
+yarn build && wrangler deploy
 ```
 
 ---
@@ -116,7 +116,7 @@ Nitro 배포 레이어를 사용하는 방식입니다.
 ### 1. Nitro 설치
 
 ```bash
-pnpm add nitro@3
+yarn add nitro@3
 ```
 
 ### 2. Vite 설정
@@ -160,7 +160,7 @@ export default defineNitroConfig({
 
 ```bash
 # 빌드
-pnpm build
+yarn build
 
 # Pages 배포
 wrangler pages deploy .output/public
@@ -439,22 +439,17 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v2
-        with:
-          version: 8
-
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '20'
-          cache: 'pnpm'
+          cache: 'yarn'
 
       - name: Install dependencies
-        run: pnpm install
+        run: yarn install --frozen-lockfile
 
       - name: Build
-        run: pnpm build
+        run: yarn build
 
       - name: Deploy to Workers
         uses: cloudflare/wrangler-action@v3
@@ -478,22 +473,17 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v2
-        with:
-          version: 8
-
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '20'
-          cache: 'pnpm'
+          cache: 'yarn'
 
       - name: Install dependencies
-        run: pnpm install
+        run: yarn install --frozen-lockfile
 
       - name: Build
-        run: pnpm build
+        run: yarn build
 
       - name: Deploy to Pages
         uses: cloudflare/wrangler-action@v3
@@ -512,7 +502,7 @@ jobs:
     "dev": "vite dev",
     "build": "vite build && tsc --noEmit",
     "preview": "vite preview",
-    "deploy": "pnpm build && wrangler deploy"
+    "deploy": "yarn build && wrangler deploy"
   }
 }
 ```

package/templates/tanstack-start/docs/deployment/index.md

@@ -50,7 +50,7 @@ Cloudflare Workers 배포 시 공식 권장 방식입니다.
 ### 1. 패키지 설치
 
 ```bash
-pnpm add -D @cloudflare/vite-plugin wrangler
+yarn add -D @cloudflare/vite-plugin wrangler
 ```
 
 ### 2. Vite 설정
@@ -88,7 +88,7 @@ export default defineConfig({
 
 ```bash
 # 빌드 및 배포
-pnpm build && wrangler deploy
+yarn build && wrangler deploy
 ```
 
 ---
@@ -100,7 +100,7 @@ pnpm build && wrangler deploy
 ### 1. Nitro 설치
 
 ```bash
-pnpm add nitro@3
+yarn add nitro@3
 ```
 
 ### 2. Vite 설정
@@ -140,10 +140,10 @@ export default defineNitroConfig({
 
 ```bash
 # 빌드
-pnpm build
+yarn build
 
 # 또는 환경변수로 preset 지정
-NITRO_PRESET=vercel pnpm build
+NITRO_PRESET=vercel yarn build
 ```
 
 ---
@@ -195,7 +195,7 @@ export default defineConfig({
     "build": "vite build && tsc --noEmit",
     "start": "node .output/server/index.mjs",
     "preview": "vite preview",
-    "deploy": "pnpm build && wrangler deploy"
+    "deploy": "yarn build && wrangler deploy"
   }
 }
 ```

package/templates/tanstack-start/docs/deployment/nitro.md

@@ -21,8 +21,8 @@ export default defineNitroConfig({
 
 ```bash
 # 설치 및 빌드
-pnpm add nitro@3
-pnpm build
+yarn add nitro@3
+yarn build
 ```
 
 ---
@@ -30,8 +30,8 @@ pnpm build
 ## 설치
 
 ```bash
-# pnpm
-pnpm add nitro@3
+# yarn
+yarn add nitro@3
 
 # npm
 npm install nitro@3
@@ -124,7 +124,7 @@ export default defineNitroConfig({
 
 ```bash
 # 빌드 시 환경변수로 지정
-NITRO_PRESET=cloudflare_pages pnpm build
+NITRO_PRESET=cloudflare_pages yarn build
 
 # 또는 CLI 옵션
 nitro build --preset cloudflare_pages
@@ -352,16 +352,16 @@ export default defineHandler(() => {
 
 ```bash
 # 개발 서버
-pnpm dev
+yarn dev
 
 # 프로덕션 빌드
-pnpm build
+yarn build
 
 # 빌드 결과 미리보기
-pnpm preview
+yarn preview
 
 # 특정 preset으로 빌드
-NITRO_PRESET=vercel pnpm build
+NITRO_PRESET=vercel yarn build
 ```
 
 ---
@@ -372,7 +372,7 @@ NITRO_PRESET=vercel pnpm build
 
 ```bash
 # 상세 로그 출력
-DEBUG=nitro:* pnpm build
+DEBUG=nitro:* yarn build
 ```
 
 ### 출력 검사

package/templates/tanstack-start/docs/deployment/railway.md

@@ -106,7 +106,7 @@ export default defineConfig({
   "$schema": "https://railway.app/railway.schema.json",
   "build": {
     "builder": "NIXPACKS",
-    "buildCommand": "pnpm install && pnpm build"
+    "buildCommand": "yarn install && yarn build"
   },
   "deploy": {
     "startCommand": "node .output/server/index.mjs",
@@ -124,7 +124,7 @@ export default defineConfig({
 # railway.toml
 [build]
 builder = "nixpacks"
-buildCommand = "pnpm install && pnpm build"
+buildCommand = "yarn install && yarn build"
 
 [deploy]
 startCommand = "node .output/server/index.mjs"
@@ -141,10 +141,10 @@ restartPolicyMaxRetries = 3
 nixPkgs = ["nodejs_20"]
 
 [phases.install]
-cmds = ["corepack enable pnpm", "pnpm install"]
+cmds = ["yarn install"]
 
 [phases.build]
-cmds = ["pnpm build"]
+cmds = ["yarn build"]
 
 [start]
 cmd = "node .output/server/index.mjs"
@@ -200,10 +200,10 @@ Railway는 Dockerfile을 자동으로 감지합니다.
 # Dockerfile
 FROM node:20-alpine AS builder
 WORKDIR /app
-COPY package.json pnpm-lock.yaml ./
-RUN corepack enable pnpm && pnpm install
+COPY package.json yarn.lock ./
+RUN yarn install --frozen-lockfile
 COPY . .
-RUN pnpm build
+RUN yarn build
 
 FROM node:20-alpine
 WORKDIR /app
@@ -449,7 +449,7 @@ Railway 대시보드에서 설정:
 
 | 문제 | 원인 | 해결 |
 |------|------|------|
-| 빌드 실패 | 의존성 오류 | `pnpm-lock.yaml` 커밋 확인 |
+| 빌드 실패 | 의존성 오류 | `yarn.lock` 커밋 확인 |
 | 포트 바인딩 실패 | 하드코딩된 포트 | `process.env.PORT` 사용 |
 | 메모리 초과 | 메모리 누수 | 리소스 제한 증가 또는 코드 최적화 |
 | 헬스체크 실패 | 엔드포인트 없음 | `/health` 엔드포인트 추가 |
@@ -458,7 +458,7 @@ Railway 대시보드에서 설정:
 
 ```bash
 # 로컬에서 Railway 환경 시뮬레이션
-railway run pnpm dev
+railway run yarn dev
 
 # 환경 변수 확인
 railway variables

package/templates/tanstack-start/docs/deployment/vercel.md

@@ -22,7 +22,7 @@ export default defineNitroConfig({
 ```json
 // vercel.json
 {
-  "buildCommand": "pnpm build",
+  "buildCommand": "yarn build",
   "outputDirectory": ".vercel/output"
 }
 ```
@@ -115,10 +115,10 @@ export default defineConfig({
 ```json
 {
   "$schema": "https://openapi.vercel.sh/vercel.json",
-  "buildCommand": "pnpm build",
+  "buildCommand": "yarn build",
   "outputDirectory": ".vercel/output",
   "framework": null,
-  "installCommand": "pnpm install"
+  "installCommand": "yarn install"
 }
 ```
 
@@ -127,7 +127,7 @@ export default defineConfig({
 ```json
 {
   "$schema": "https://openapi.vercel.sh/vercel.json",
-  "buildCommand": "pnpm build",
+  "buildCommand": "yarn build",
   "outputDirectory": ".vercel/output",
 
   "functions": {
@@ -165,9 +165,9 @@ export default defineConfig({
 
 2. **빌드 설정**
    - Framework Preset: "Other"
-   - Build Command: `pnpm build`
+   - Build Command: `yarn build`
    - Output Directory: `.vercel/output`
-   - Install Command: `pnpm install`
+   - Install Command: `yarn install`
 
 3. **환경 변수 설정**
    - Vercel 대시보드에서 Settings → Environment Variables
@@ -355,8 +355,8 @@ export default defineNitroConfig({
 ```json
 {
   "$schema": "https://openapi.vercel.sh/vercel.json",
-  "installCommand": "pnpm install",
-  "buildCommand": "pnpm --filter web build",
+  "installCommand": "yarn install",
+  "buildCommand": "yarn workspace web build",
   "outputDirectory": "apps/web/.vercel/output"
 }
 ```
@@ -410,22 +410,17 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v2
-        with:
-          version: 8
-
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '20'
-          cache: 'pnpm'
+          cache: 'yarn'
 
       - name: Install dependencies
-        run: pnpm install
+        run: yarn install --frozen-lockfile
 
       - name: Build
-        run: pnpm build
+        run: yarn build
 
       - name: Deploy to Vercel
         uses: amondnet/vercel-action@v25
@@ -498,7 +493,7 @@ vercel domains inspect example.com
 | Function Timeout | 실행 시간 초과 | `maxDuration` 증가 또는 최적화 |
 | Edge 호환성 오류 | Node.js API 사용 | Edge 호환 API로 변경 |
 | 환경 변수 누락 | 설정 안됨 | Vercel 대시보드에서 설정 |
-| 빌드 실패 | 의존성 문제 | `pnpm-lock.yaml` 확인 |
+| 빌드 실패 | 의존성 문제 | `yarn.lock` 확인 |
 
 ### 디버깅
 

package/templates/tanstack-start/docs/library/prisma/index.md

@@ -66,10 +66,6 @@ npm install -D prisma@7
 yarn add @prisma/client@7
 yarn add -D prisma@7
 
-# pnpm
-pnpm add @prisma/client@7
-pnpm add -D prisma@7
-
 # 초기화
 npx prisma init
 ```

package/templates/tanstack-start/docs/library/prisma/setup.md

@@ -13,10 +13,6 @@ npm install -D prisma@7
 yarn add @prisma/client@7
 yarn add -D prisma@7
 
-# pnpm
-pnpm add @prisma/client@7
-pnpm add -D prisma@7
-
 # bun
 bun add @prisma/client@7
 bun add prisma@7 --dev
@@ -34,9 +30,6 @@ npm install -D prisma@7
 
 # yarn
 yarn up prisma@7 @prisma/client@7
-
-# pnpm
-pnpm upgrade prisma@7 @prisma/client@7
 ```
 
 ### Generator 변경 (필수)