@kood/claude-code 0.1.3 → 0.1.5

package/dist/index.js

@@ -183,6 +183,58 @@ var checkExistingSkills = async (targetDir, skills) => {
   }
   return existingSkills;
 };
+var getCommandsPath = (template) => {
+  return path.join(getTemplatePath(template), "docs", "commands");
+};
+var listAvailableCommands = async (template) => {
+  const commandsPath = getCommandsPath(template);
+  if (!await fs.pathExists(commandsPath)) {
+    return [];
+  }
+  const items = await fs.readdir(commandsPath);
+  const commands = [];
+  for (const item of items) {
+    const itemPath = path.join(commandsPath, item);
+    const stat = await fs.stat(itemPath);
+    if (stat.isFile() && item.endsWith(".md")) {
+      commands.push(item.replace(".md", ""));
+    }
+  }
+  return commands;
+};
+var copyCommands = async (template, targetDir) => {
+  const commandsPath = getCommandsPath(template);
+  const targetCommandsDir = path.join(targetDir, ".claude", "commands");
+  if (!await fs.pathExists(commandsPath)) {
+    return { files: 0, commands: [] };
+  }
+  let files = 0;
+  const installedCommands = [];
+  await fs.ensureDir(targetCommandsDir);
+  const items = await fs.readdir(commandsPath);
+  for (const item of items) {
+    const srcPath = path.join(commandsPath, item);
+    const stat = await fs.stat(srcPath);
+    if (stat.isFile() && item.endsWith(".md")) {
+      const destPath = path.join(targetCommandsDir, item);
+      await fs.copy(srcPath, destPath);
+      files++;
+      installedCommands.push(item.replace(".md", ""));
+    }
+  }
+  return { files, commands: installedCommands };
+};
+var checkExistingCommands = async (targetDir, commands) => {
+  const existingCommands = [];
+  const targetCommandsDir = path.join(targetDir, ".claude", "commands");
+  for (const command of commands) {
+    const commandPath = path.join(targetCommandsDir, `${command}.md`);
+    if (await fs.pathExists(commandPath)) {
+      existingCommands.push(command);
+    }
+  }
+  return existingCommands;
+};
 
 // src/commands/init.ts
 var TEMPLATE_DESCRIPTIONS = {
@@ -245,6 +297,7 @@ var init = async (options) => {
   let totalFiles = 0;
   let totalDirectories = 0;
   const allSkills = [];
+  const allCommands = [];
   logger.blank();
   try {
     if (isSingleTemplate) {
@@ -258,6 +311,8 @@ var init = async (options) => {
       logger.success(`${template}: ${result.files} files copied`);
       const availableSkills = await listAvailableSkills(template);
       allSkills.push(...availableSkills);
+      const availableCommands = await listAvailableCommands(template);
+      allCommands.push(...availableCommands);
     } else {
       logger.info(`Installing ${templates.length} templates...`);
       logger.step(`Target: ${targetDir}/docs/`);
@@ -273,6 +328,12 @@ var init = async (options) => {
             allSkills.push(skill);
           }
         }
+        const availableCommands = await listAvailableCommands(template);
+        for (const command of availableCommands) {
+          if (!allCommands.includes(command)) {
+            allCommands.push(command);
+          }
+        }
       }
     }
   } catch (error) {
@@ -318,6 +379,44 @@ var init = async (options) => {
       logger.blank();
     }
   }
+  if (allCommands.length > 0) {
+    let installCommands = options.commands;
+    if (installCommands === void 0) {
+      logger.blank();
+      const response = await prompts({
+        type: "confirm",
+        name: "installCommands",
+        message: `Install Claude Code commands? (${allCommands.join(", ")})`,
+        initial: true
+      });
+      installCommands = response.installCommands;
+    }
+    if (installCommands) {
+      const existingCommands = await checkExistingCommands(
+        targetDir,
+        allCommands
+      );
+      if (existingCommands.length > 0 && !options.force) {
+        logger.warn("The following commands already exist:");
+        existingCommands.forEach((c) => logger.step(c));
+        logger.blank();
+        const response = await prompts({
+          type: "confirm",
+          name: "overwrite",
+          message: "Overwrite existing commands?",
+          initial: false
+        });
+        if (!response.overwrite) {
+          logger.info("Skipping commands installation.");
+        } else {
+          await installAllCommands(templates, targetDir);
+        }
+      } else {
+        await installAllCommands(templates, targetDir);
+      }
+      logger.blank();
+    }
+  }
   logger.success("Claude Code documentation installed!");
   logger.blank();
   logger.info("Installed templates:");
@@ -343,14 +442,29 @@ var installAllSkills = async (templates, targetDir) => {
     logger.step(`Location: .claude/skills/`);
   }
 };
+var installAllCommands = async (templates, targetDir) => {
+  const installedCommands = [];
+  for (const template of templates) {
+    const commandsResult = await copyCommands(template, targetDir);
+    for (const command of commandsResult.commands) {
+      if (!installedCommands.includes(command)) {
+        installedCommands.push(command);
+      }
+    }
+  }
+  if (installedCommands.length > 0) {
+    logger.success(`Commands installed: ${installedCommands.join(", ")}`);
+    logger.step(`Location: .claude/commands/`);
+  }
+};
 
 // src/index.ts
 var program = new Command();
-program.name("claude-code").description("Claude Code documentation installer for projects").version("0.1.2");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.1.5");
 program.option(
   "-t, --template <names>",
   "template names (comma-separated: tanstack-start,hono)"
-).option("-f, --force", "overwrite existing files without prompting").option("-s, --skills", "install Claude Code skills").option("--no-skills", "skip skills installation").option("--cwd <path>", "target directory (default: current directory)").option("--list", "list available templates").action(async (options) => {
+).option("-f, --force", "overwrite existing files without prompting").option("-s, --skills", "install Claude Code skills").option("--no-skills", "skip skills installation").option("-c, --commands", "install Claude Code commands").option("--no-commands", "skip commands installation").option("--cwd <path>", "target directory (default: current directory)").option("--list", "list available templates").action(async (options) => {
   banner();
   if (options.list) {
     const templates = await listAvailableTemplates();
@@ -363,7 +477,8 @@ program.option(
     templates: options.template?.split(",").map((t) => t.trim()),
     force: options.force,
     cwd: options.cwd,
-    skills: options.skills
+    skills: options.skills,
+    commands: options.commands
   });
 });
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kood/claude-code",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/hono/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/hono/docs/deployment/cloudflare.md

@@ -176,7 +176,7 @@ npm install -g wrangler
 wrangler login
 
 # 빌드
-pnpm build
+yarn build
 
 # 배포
 wrangler deploy
@@ -195,7 +195,7 @@ wrangler dev
 2. **빌드 설정**
    ```
    Framework preset: None
-   Build command: pnpm build
+   Build command: yarn build
    Build output directory: .output/public
    ```
 
@@ -463,22 +463,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 Cloudflare Workers
         uses: cloudflare/wrangler-action@v3
@@ -503,22 +498,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 Cloudflare Pages
         uses: cloudflare/pages-action@v1

package/templates/hono/docs/deployment/docker.md

@@ -14,14 +14,14 @@ FROM node:20-alpine AS base
 
 FROM base AS deps
 WORKDIR /app
-COPY package.json pnpm-lock.yaml ./
-RUN corepack enable pnpm && pnpm install --frozen-lockfile
+COPY package.json yarn.lock ./
+RUN yarn install --frozen-lockfile
 
 FROM base AS builder
 WORKDIR /app
 COPY --from=deps /app/node_modules ./node_modules
 COPY . .
-RUN corepack enable pnpm && pnpm run build
+RUN yarn build
 
 FROM base AS runner
 WORKDIR /app
@@ -105,11 +105,10 @@ FROM base AS deps
 WORKDIR /app
 
 # 패키지 매니저 파일 복사
-COPY package.json pnpm-lock.yaml ./
+COPY package.json yarn.lock ./
 
-# pnpm 활성화 및 의존성 설치
-RUN corepack enable pnpm && \
-    pnpm install --frozen-lockfile --prod=false
+# yarn 의존성 설치
+RUN yarn install --frozen-lockfile
 
 # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 # Stage 3: 빌드
@@ -124,9 +123,7 @@ COPY --from=deps /app/node_modules ./node_modules
 COPY . .
 
 # Nitro 빌드
-RUN corepack enable pnpm && \
-    pnpm run build && \
-    pnpm store prune
+RUN yarn build
 
 # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 # Stage 4: 프로덕션 러너
@@ -333,17 +330,17 @@ FROM node:20-alpine
 WORKDIR /app
 
 # 패키지 파일 복사
-COPY package.json pnpm-lock.yaml ./
+COPY package.json yarn.lock ./
 
-# pnpm 설치 및 의존성 설치
-RUN corepack enable pnpm && pnpm install
+# yarn 의존성 설치
+RUN yarn install
 
 # 소스 코드는 볼륨으로 마운트됨
 
 EXPOSE 3000
 
 # 개발 서버 실행
-CMD ["pnpm", "run", "dev"]
+CMD ["yarn", "dev"]
 ```
 
 ---
@@ -449,7 +446,7 @@ FROM node:20-alpine
 # 불필요한 파일 제외 (.dockerignore 활용)
 
 # 프로덕션 의존성만 설치
-RUN pnpm install --prod
+RUN yarn install --production
 
 # 빌드 결과물만 최종 이미지에 포함
 COPY --from=builder /app/.output ./.output
@@ -459,12 +456,12 @@ COPY --from=builder /app/.output ./.output
 
 ```dockerfile
 # 의존성 파일 먼저 복사 (캐시 활용)
-COPY package.json pnpm-lock.yaml ./
-RUN pnpm install
+COPY package.json yarn.lock ./
+RUN yarn install --frozen-lockfile
 
 # 소스 코드는 나중에 복사
 COPY . .
-RUN pnpm build
+RUN yarn build
 ```
 
 ### 보안 강화

package/templates/hono/docs/deployment/index.md

@@ -58,9 +58,6 @@ npm install nitro@3
 
 # yarn
 yarn add nitro@3
-
-# pnpm
-pnpm add nitro@3
 ```
 
 ### 2. 기본 설정 파일

package/templates/hono/docs/deployment/railway.md

@@ -135,10 +135,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
@@ -161,7 +161,7 @@ CMD ["node", ".output/server/index.mjs"]
 [build]
 # 빌드 명령어
 builder = "nixpacks"
-buildCommand = "pnpm install && pnpm build"
+buildCommand = "yarn install && yarn build"
 
 [deploy]
 # 시작 명령어
@@ -387,7 +387,7 @@ Railway 대시보드에서 설정:
 
 | 문제 | 원인 | 해결 |
 |------|------|------|
-| 빌드 실패 | 의존성 오류 | `pnpm-lock.yaml` 커밋 확인 |
+| 빌드 실패 | 의존성 오류 | `yarn.lock` 커밋 확인 |
 | 포트 바인딩 실패 | 하드코딩된 포트 | `process.env.PORT` 사용 |
 | 메모리 초과 | 메모리 누수 | 리소스 제한 증가 또는 코드 최적화 |
 | 헬스체크 실패 | 엔드포인트 없음 | `/health` 엔드포인트 추가 |
@@ -396,7 +396,7 @@ Railway 대시보드에서 설정:
 
 ```bash
 # 로컬에서 Railway 환경 시뮬레이션
-railway run pnpm dev
+railway run yarn dev
 
 # 환경 변수 확인
 railway variables

package/templates/hono/docs/deployment/vercel.md

@@ -102,10 +102,10 @@ export default defineNitroConfig({
 ```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"
 }
 ```
 
@@ -114,7 +114,7 @@ export default defineNitroConfig({
 ```json
 {
   "$schema": "https://openapi.vercel.sh/vercel.json",
-  "buildCommand": "pnpm build",
+  "buildCommand": "yarn build",
   "outputDirectory": ".vercel/output",
 
   "functions": {
@@ -152,9 +152,9 @@ export default defineNitroConfig({
 
 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
@@ -452,22 +452,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
@@ -528,7 +523,7 @@ export default app;
 | Function Timeout | 실행 시간 초과 | `maxDuration` 증가 또는 최적화 |
 | Edge 호환성 오류 | Node.js API 사용 | Edge 호환 API로 변경 |
 | 환경 변수 누락 | 설정 안됨 | Vercel 대시보드에서 설정 |
-| 빌드 실패 | 의존성 문제 | `pnpm-lock.yaml` 확인 |
+| 빌드 실패 | 의존성 문제 | `yarn.lock` 확인 |
 
 ### 디버깅
 

package/templates/hono/docs/library/hono/index.md

@@ -21,9 +21,6 @@ bun add hono
 
 # yarn
 yarn add hono
-
-# pnpm
-pnpm add hono
 ```
 
 ---