@kood/claude-code 0.2.5 → 0.3.1

package/templates/npx/docs/references/patterns.md

@@ -1,25 +1,35 @@
 # NPX CLI Patterns
 
-> 복사용 코드 패턴 모음
+> CLI 구현 통합 패턴
 
-## CLI Entry Point
+<patterns>
+
+## CLI 진입점
 
 ```typescript
 #!/usr/bin/env node
 import { Command } from 'commander';
+import { logger } from './utils/logger.js';
+import { initCommand } from './commands/init.js';
 
 const program = new Command();
 
 program
   .name('my-cli')
-  .description('CLI description')
+  .description('CLI tool description')
   .version('1.0.0');
 
 program
   .option('-t, --template <name>', 'template name')
   .option('-f, --force', 'overwrite existing files')
   .action(async (options) => {
-    // 명령어 실행
+    try {
+      await initCommand(options);
+      logger.success('Done!');
+    } catch (error) {
+      logger.error(`Failed: ${error.message}`);
+      process.exit(1);
+    }
   });
 
 program.parse();
@@ -36,49 +46,74 @@ export const logger = {
   warn: (msg: string): void => console.log(pc.yellow('⚠'), msg),
   error: (msg: string): void => console.log(pc.red('✖'), msg),
   step: (msg: string): void => console.log(pc.gray('  →'), msg),
-  blank: (): void => console.log(),
 };
 ```
 
-## Interactive Prompts
+## 대화형 템플릿 선택
 
 ```typescript
 import prompts from 'prompts';
+import fs from 'fs-extra';
+import path from 'path';
+import { logger } from './utils/logger.js';
+
+export const selectAndCopyTemplate = async (
+  templatesDir: string,
+  targetDir: string,
+): Promise<void> => {
+  // 1. 템플릿 선택
+  const { template } = await prompts({
+    type: 'select',
+    name: 'template',
+    message: 'Select a template:',
+    choices: [
+      { title: 'React', value: 'react' },
+      { title: 'Vue', value: 'vue' },
+    ],
+  });
 
-// Select (단일 선택)
-const { template } = await prompts({
-  type: 'select',
-  name: 'template',
-  message: 'Select a template:',
-  choices: [
-    { title: 'Template A', value: 'a' },
-    { title: 'Template B', value: 'b' },
-  ],
-});
+  if (!template) {
+    logger.warn('Cancelled.');
+    process.exit(0);
+  }
 
-// Multiselect (다중 선택)
-const { templates } = await prompts({
-  type: 'multiselect',
-  name: 'templates',
-  message: 'Select templates:',
-  choices: [
-    { title: 'Template A', value: 'a' },
-    { title: 'Template B', value: 'b' },
-  ],
-  min: 1,
-  hint: '- Space to select. Return to submit',
-});
+  // 2. 덮어쓰기 확인
+  const targetExists = await fs.pathExists(targetDir);
+  if (targetExists) {
+    const { overwrite } = await prompts({
+      type: 'confirm',
+      name: 'overwrite',
+      message: 'Target exists. Overwrite?',
+      initial: false,
+    });
+
+    if (!overwrite) {
+      logger.warn('Cancelled.');
+      process.exit(0);
+    }
+  }
 
-// Confirm
-const { confirmed } = await prompts({
-  type: 'confirm',
-  name: 'confirmed',
-  message: 'Overwrite existing files?',
-  initial: false,
-});
+  // 3. 복사
+  const src = path.join(templatesDir, template);
+  await fs.copy(src, targetDir, { overwrite: true });
+  logger.success(`Template copied to ${targetDir}`);
+};
+```
+
+## ESM __dirname 처리
+
+```typescript
+import { fileURLToPath } from 'url';
+import path from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 템플릿 디렉토리 경로
+const templatesDir = path.resolve(__dirname, '../templates');
 ```
 
-## File Copy 유틸
+## 재귀 복사 with Counter
 
 ```typescript
 import fs from 'fs-extra';
@@ -112,17 +147,7 @@ export const copyRecursive = async (
 };
 ```
 
-## ESM __dirname
-
-```typescript
-import { fileURLToPath } from 'url';
-import path from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-```
-
-## Package.json
+## package.json 설정
 
 ```json
 {
@@ -142,7 +167,7 @@ const __dirname = path.dirname(__filename);
 }
 ```
 
-## tsup.config.ts
+## tsup 설정
 
 ```typescript
 import { defineConfig } from 'tsup';
@@ -158,3 +183,5 @@ export default defineConfig({
   },
 });
 ```
+
+</patterns>

package/templates/tanstack-start/CLAUDE.md

@@ -1,78 +1,73 @@
-# CLAUDE.md - TanStack Start + React 작업 지침
+# CLAUDE.md - TanStack Start
 
-## Instructions
+> Full-stack React Framework
+
+<context>
+
+**Purpose:** TanStack Start 프레임워크 개발을 위한 작업 지침
+
+**Scope:** Full-stack React 애플리케이션 구현
+
+**Key Features:**
+- File-based routing (TanStack Router)
+- Server Functions (타입 안전 API)
+- SSR + Streaming
+- TanStack Query 통합
+- Middleware 체계
+- Deployment 유연성 (Vercel, Cloudflare, Nitro)
+
+</context>
+
+---
+
+<instructions>
 @../../commands/git.md
 @docs/library/tanstack-start/index.md
+@docs/library/tanstack-router/index.md
+@docs/library/tanstack-query/index.md
 @docs/library/prisma/index.md
 @docs/library/better-auth/index.md
-@docs/library/tanstack-query/index.md
+@docs/library/t3-env/index.md
 @docs/library/zod/index.md
-@docs/design/index.md
+@docs/design.md
+</instructions>
 
 ---
 
-## ⛔ NEVER DO
+<forbidden>
 
-### Git 커밋
-- AI 표시 금지: "Generated with Claude Code", "🤖", "Co-Authored-By:" 포함 불가
-- 커밋 메시지: 한 줄만, 이모지 금지
+| 분류 | 금지 행동 |
+|------|----------|
+| **Git 커밋** | AI 표시 (`Generated with Claude Code`, `🤖`, `Co-Authored-By:`), 여러 줄 메시지, 이모지 |
+| **Prisma** | `db push/migrate/generate` 자동 실행, `schema.prisma` 무단 수정 |
+| **API 라우터** | `/api` 경로에 라우터 생성 (Server Functions 사용) |
+| **Server Fn** | handler 내부에서 수동 검증/인증, `.validator()` 사용 (`.inputValidator()` 사용) |
+| **클라이언트** | Server Function 직접 호출 (TanStack Query 사용) |
+| **코드 검색** | Bash의 grep/rg/find 명령어 (ast-grep 또는 전용 도구 사용) |
 
-### Prisma
-- 자동 실행 금지: `prisma db push/migrate/generate`
-- `schema.prisma` 임의 변경 금지
-
-### API 구현
-- `/api` 라우터 생성 금지 (명시 요청 제외)
-- Server Function: POST/PUT/PATCH → `inputValidator` 필수, 인증 필요 시 → `middleware` 필수
-- handler 내부에서 수동 검증/인증 체크 금지
-- 클라이언트에서 Server Function 직접 호출 금지 → TanStack Query 필수
-
-### Custom Hook 순서
-1. State (useState, zustand)
-2. Global Hooks (useParams, useNavigate, useQueryClient)
-3. React Query (useQuery → useMutation)
-4. Event Handlers
-5. useMemo
-6. useEffect
-
-### 코드 작성
-- UTF-8 인코딩, 코드 묶음 단위 한글 주석
-- Prisma Multi-File: 모든 요소에 한글 주석 필수
-
-### Prisma Multi-File 구조
-```
-prisma/schema/
-├── +base.prisma   # datasource, generator
-├── +enum.prisma   # 모든 enum
-└── [model].prisma # 모델별 파일
-```
+</forbidden>
 
 ---
 
-## ✅ ALWAYS DO
-
-### 작업 전 문서 읽기
-| 작업 | 문서 |
-|------|------|
-| UI | docs/design/ |
-| API | docs/library/tanstack-start/ |
-| DB | docs/library/prisma/ |
-| 인증 | docs/library/better-auth/ |
+<required>
 
-### MCP 도구
-- 분석/디버깅: Sequential Thinking
-- 라이브러리 문서: Context7
+| 작업 | 필수 행동 |
+|------|----------|
+| **작업 시작 전** | 관련 docs 읽기 (UI → design, API → tanstack-start, DB → prisma, 인증 → better-auth) |
+| **코드 검색** | ast-grep 사용 (함수/컴포넌트/패턴 검색) |
+| **복잡한 작업** | Sequential Thinking MCP (5+ 단계 작업) |
+| **대규모 수정** | gemini-review (3+ 파일 변경, 아키텍처 결정) |
+| **Server Function** | POST/PUT/PATCH → `.inputValidator()` 필수, 인증 필요 시 → `.middleware()` 필수 |
+| **클라이언트 API** | TanStack Query (`useQuery`/`useMutation`)로 Server Function 호출 |
+| **Custom Hook 순서** | State → Global Hooks (useParams, useNavigate) → React Query → Handlers → Memo → Effect |
+| **코드 작성** | UTF-8 인코딩, 코드 묶음별 한글 주석, const 함수 선언 |
+| **Prisma** | Multi-File 구조 (`prisma/schema/`), 모든 요소 한글 주석 필수 |
 
-### Gemini Review (3개+ 파일 수정, 아키텍처 변경, 보안/성능 코드)
-- architecture/plan/code 타입 선택
-
-### Git 커밋
-`<prefix>: <설명>` (한 줄)
-- prefix: feat|fix|refactor|style|docs|test|chore|perf|ci
+</required>
 
 ---
 
-## Tech Stack
+<tech_stack>
 
 | 기술 | 버전 | 주의 |
 |------|------|------|
@@ -84,37 +79,48 @@ prisma/schema/
 | Better Auth | 최신 | - |
 | TanStack Query | 5.x | - |
 
+</tech_stack>
+
 ---
 
-## Directory Structure
+<structure>
 ```
 src/
-├── routes/             # File-based routes
-│   ├── __root.tsx
-│   ├── index.tsx
-│   ├── $slug.tsx
+├── routes/          # __root.tsx, index.tsx, $slug.tsx
 │   └── [path]/
-│       ├── -components/ # 페이지 전용
-│       ├── -hooks/
-│       └── -functions/  # 페이지 전용 Server Functions
-├── functions/          # 공통 Server Functions
+│       ├── -components/  # 페이지 전용
+│       └── -functions/   # 페이지 전용 Server Functions
+├── functions/       # 공통 Server Functions
 ├── components/ui/
 ├── middleware/
 ├── database/prisma.ts
 └── lib/
 ```
-- 공통 함수 → `@/functions/`, 라우트 전용 → `routes/[경로]/-functions/`
+
+공통 → `@/functions/`, 라우트 전용 → `routes/[경로]/-functions/`
+</structure>
 
 ---
 
-## Code Conventions
-- 파일명: kebab-case, Routes: `__root.tsx`, `$param.tsx`
-- TypeScript: const 선언, 명시적 return type, interface(객체)/type(유니온), any 금지→unknown
-- Import 순서: 외부 → @/ → 상대경로 → type
+<conventions>
+
+파일명: kebab-case, Routes: `__root.tsx`, `$param.tsx`
+TypeScript: const 선언, 명시적 return type, interface(객체)/type(유니온), any→unknown
+Import 순서: 외부 → @/ → 상대경로 → type
+
+Prisma Multi-File:
+```
+prisma/schema/
+├── +base.prisma   # datasource, generator
+├── +enum.prisma   # enum
+└── [model].prisma # 모델별 (한글 주석!)
+```
+
+</conventions>
 
 ---
 
-## Quick Patterns
+<quick_patterns>
 
 ```typescript
 // Server Function (GET + 인증)
@@ -149,11 +155,29 @@ const mutation = useMutation({
 })
 ```
 
+</quick_patterns>
+
 ---
 
-## UI/UX
-- 색상: 60-30-10 (배경-보조-강조)
-- 간격: 8px 그리드
-- 접근성: WCAG AA (대비 4.5:1+)
-- 폰트: 2-3개
-- Safe Area: tailwindcss-safe-area
+<ui_ux>
+
+| 원칙 | 값 |
+|------|------|
+| 색상 | 60-30-10 (배경-보조-강조) |
+| 간격 | 8px 그리드 |
+| 접근성 | WCAG AA (대비 4.5:1+) |
+| 폰트 | 2-3개 |
+| Safe Area | tailwindcss-safe-area |
+
+</ui_ux>
+
+---
+
+<docs_structure>
+```
+docs/
+├── guides/          # 시작하기, 규칙, 패턴
+├── library/         # tanstack-start/router/query, prisma, better-auth, t3-env, zod
+└── design.md        # UI/UX 가이드
+```
+</docs_structure>