@kood/claude-code 0.5.3 → 0.5.5

package/templates/nextjs/docs/library/zod/validation.md

@@ -1,4 +1,4 @@
-# Zod - Validation
+# Zod - 검증
 
 <patterns>
 
@@ -6,10 +6,10 @@
 // Refinement (v4: message → error)
 const PasswordSchema = z.string()
   .min(8)
-  .refine((val) => /[A-Z]/.test(val), { error: 'Uppercase letter required' })
-  .refine((val) => /[0-9]/.test(val), { error: 'Number required' })
+  .refine((val) => /[A-Z]/.test(val), { error: '대문자 필수' })
+  .refine((val) => /[0-9]/.test(val), { error: '숫자 필수' })
 
-z.string().refine(val => val.includes("@")).min(5)  // v4: chaining after refinement
+z.string().refine(val => val.includes("@")).min(5)  // v4: refinement 후 체이닝
 
 // Async
 const schema = z.string().refine(async (val) => val.length <= 8)
@@ -23,20 +23,20 @@ z.object({
   if (data.password !== data.confirmPassword) {
     ctx.addIssue({
       code: z.ZodIssueCode.custom,
-      message: 'Passwords do not match',
+      message: '비밀번호 불일치',
       path: ['confirmPassword'],
     })
   }
-})  // v4: ctx.path is unavailable
+})  // v4: ctx.path 사용 불가
 
-// Custom
+// 커스텀
 const px = z.custom<`${number}px`>((val) =>
   typeof val === 'string' && /^\d+px$/.test(val)
 )
 px.parse('42px')  // ✅
 px.parse('42vw')  // throws
 
-// Error handling
+// 에러 처리
 const result = schema.safeParse(data)
 if (!result.success) {
   result.error.errors.forEach((err) => {
@@ -50,7 +50,7 @@ export const createUser = createServerFn({ method: 'POST' })
   .inputValidator(zodValidator(createUserSchema))
   .handler(async ({ data }) => prisma.user.create({ data }))
 
-// Environment variables
+// 환경 변수
 const env = z.object({
   NODE_ENV: z.enum(['development', 'production', 'test']),
   DATABASE_URL: z.string().url(),

package/templates/npx/CLAUDE.md

@@ -1,19 +1,19 @@
 # CLAUDE.md - NPX CLI
 
-> Node.js CLI tool development
+> Node.js CLI 도구 개발
 
 <context>
 
-**Purpose:** Work instructions for Node.js CLI tool development
+**Purpose:** Node.js CLI 도구 개발을 위한 작업 지침
 
-**Scope:** Implement CLI packages deployable via npx
+**Scope:** npx 배포 가능한 CLI 패키지 구현
 
 **Key Features:**
-- Commander.js command system
-- Interactive prompts (prompts)
-- File system operations (fs-extra)
+- Commander.js 명령어 체계
+- 대화형 프롬프트 (prompts)
+- 파일 시스템 작업 (fs-extra)
 - TypeScript + ESM
-- Colored output (picocolors)
+- 색상 출력 (picocolors)
 
 </context>
 
@@ -31,13 +31,13 @@
 
 <forbidden>
 
-| Category | Prohibited Actions |
-|----------|-------------------|
-| **Git Commits** | AI markers (`Generated with Claude Code`, `🤖`, `Co-Authored-By:`), multi-line messages, emojis |
-| **Console Output** | Direct `console.log` usage (use logger functions) |
-| **File Operations** | Synchronous APIs (`fs.readFileSync`, etc.), hardcoded paths (use path.join) |
-| **Error Handling** | Missing `process.exit()`, async operations without try-catch |
-| **Code Search** | Bash grep/rg/find commands (use ast-grep or dedicated tools) |
+| 분류 | 금지 행동 |
+|------|----------|
+| **Git 커밋** | AI 표시 (`Generated with Claude Code`, `🤖`, `Co-Authored-By:`), 여러 줄 메시지, 이모지 |
+| **콘솔 출력** | `console.log` 직접 사용 (logger 함수 사용) |
+| **파일 작업** | 동기 API (`fs.readFileSync` 등), 하드코딩된 경로 (path.join 사용) |
+| **에러 처리** | `process.exit()` 누락, try-catch 없는 async 작업 |
+| **코드 검색** | Bash의 grep/rg/find 명령어 (ast-grep 또는 전용 도구 사용) |
 
 </forbidden>
 
@@ -45,16 +45,16 @@
 
 <required>
 
-| Task | Required Actions |
-|------|-----------------|
-| **Before Starting** | Read relevant docs (Commander → commander, Files → fs-extra) |
-| **Document Search** | Use serena mcp (document indexing/search, context length optimization) |
-| **Console Output** | Use logger functions (info/success/error/warn) |
-| **File Operations** | Async API (`fs-extra`), `path.join` for paths |
-| **Error Handling** | try-catch + `process.exit(1)`, clear error messages to users |
-| **Code Search** | Use ast-grep (search functions/classes/patterns) |
-| **Code Writing** | UTF-8 encoding, Korean comments per code block, const function declarations |
-| **Complex Tasks** | Sequential Thinking MCP (5+ step tasks) |
+| 작업 | 필수 행동 |
+|------|----------|
+| **작업 시작 전** | 관련 docs 읽기 (Commander → commander, 파일 → fs-extra) |
+| **문서 검색** | serena mcp 사용 (문서 인덱싱/검색, context 길이 최적화) |
+| **콘솔 출력** | logger 함수 사용 (info/success/error/warn) |
+| **파일 작업** | async API (`fs-extra`), `path.join`으로 경로 조합 |
+| **에러 처리** | try-catch + `process.exit(1)`, 사용자에게 명확한 에러 메시지 |
+| **코드 검색** | ast-grep 사용 (함수/클래스/패턴 검색) |
+| **코드 작성** | UTF-8 인코딩, 코드 묶음별 한글 주석, const 함수 선언 |
+| **복잡한 작업** | Sequential Thinking MCP (5+ 단계 작업) |
 
 </required>
 
@@ -62,8 +62,8 @@
 
 <tech_stack>
 
-| Technology | Version |
-|-----------|---------|
+| 기술 | 버전 |
+|------|------|
 | Node.js | >= 18 (ESM) |
 | TypeScript | 5.x (strict) |
 | Commander | 12.x |
@@ -79,13 +79,13 @@
 <structure>
 ```
 src/
-├── index.ts      # CLI entry point
-├── commands/     # Command modules
+├── index.ts      # CLI 진입점
+├── commands/     # 명령어 모듈
 ├── utils/        # logger, copy
-└── types/        # Types
+└── types/        # 타입
 
-templates/        # Copied during build
-dist/             # Build output
+templates/        # 빌드 시 복사
+dist/             # 빌드 결과물
 ```
 </structure>
 
@@ -93,9 +93,9 @@ dist/             # Build output
 
 <conventions>
 
-**File naming:** kebab-case
-**TypeScript:** const declarations, explicit return types, interface(objects)/type(unions), any→unknown
-**Import order:** external → internal → type
+**파일명:** kebab-case
+**TypeScript:** const 선언, 명시적 return type, interface(객체)/type(유니온), any→unknown
+**Import 순서:** 외부 → 내부 → type
 
 </conventions>
 
@@ -104,7 +104,7 @@ dist/             # Build output
 <quick_patterns>
 
 ```typescript
-// CLI entry point (index.ts)
+// CLI 진입점 (index.ts)
 #!/usr/bin/env node
 import { Command } from 'commander'
 import { logger } from './utils/logger.js'
@@ -143,7 +143,7 @@ export const logger = {
 ```
 
 ```typescript
-// File copying (utils/copy.ts)
+// 파일 복사 (utils/copy.ts)
 import path from 'node:path'
 import { copy, pathExists } from 'fs-extra'
 
@@ -163,7 +163,7 @@ export const copyTemplate = async (
 ```
 
 ```typescript
-// Interactive prompts
+// 대화형 프롬프트
 import prompts from 'prompts'
 
 const response = await prompts([
@@ -193,6 +193,6 @@ const response = await prompts([
 ```
 docs/
 ├── library/      # commander, fs-extra, prompts
-└── references/   # CLI patterns, best practices
+└── references/   # CLI 패턴, 베스트 프랙티스
 ```
 </docs_structure>

package/templates/npx/docs/library/commander/index.md

@@ -1,10 +1,10 @@
 # Commander.js
 
-> Node.js CLI framework
+> Node.js CLI 프레임워크
 
 <patterns>
 
-## Basic Setup
+## 기본 설정
 
 ```typescript
 import { Command } from 'commander';
@@ -22,7 +22,7 @@ program.parse();
 ## Options
 
 ```typescript
-// Basic
+// 기본
 program
   .option('-t, --template <name>', 'template name')
   .option('-f, --force', 'force overwrite')
@@ -31,19 +31,19 @@ program
     console.log(options.force);    // boolean | undefined
   });
 
-// Required
+// 필수
 program
   .requiredOption('-c, --config <path>', 'config file path')
   .action((options) => {
-    // options.config is always present
+    // options.config는 항상 존재
   });
 
-// Default values
+// 기본값
 program
   .option('-p, --port <number>', 'port number', '3000')
   .option('-e, --env <name>', 'environment', 'development')
 
-// Multiple values
+// 여러 값
 program
   .option('-i, --include <path...>', 'include paths')
   .action((options) => {
@@ -58,8 +58,8 @@ program
   .argument('<source>', 'source file')
   .argument('[destination]', 'destination file')
   .action((source, destination, options) => {
-    console.log(source);      // required
-    console.log(destination); // optional
+    console.log(source);      // 필수
+    console.log(destination); // 선택
   });
 ```
 
@@ -71,14 +71,14 @@ program
   .description('Initialize project')
   .option('-t, --template <name>', 'template')
   .action((options) => {
-    // Handle init
+    // init 처리
   });
 
 program
   .command('build')
   .description('Build project')
   .action(() => {
-    // Handle build
+    // build 처리
   });
 ```
 
@@ -95,7 +95,7 @@ program
     }
   });
 
-await program.parseAsync(); // await required
+await program.parseAsync(); // await 필수
 ```
 
 </patterns>

package/templates/npx/docs/library/fs-extra/index.md

@@ -1,6 +1,6 @@
 # fs-extra
 
-> Node.js file system utilities
+> Node.js 파일 시스템 유틸리티
 
 <patterns>
 
@@ -8,14 +8,14 @@
 import fs from 'fs-extra';
 import path from 'path';
 
-// Check existence
+// 존재 확인
 const exists = await fs.pathExists('/path/to/file');
 
-// Create directory
+// 디렉토리 생성
 await fs.ensureDir('/path/to/nested/dir');
 await fs.mkdir('/path/to/dir');
 
-// Copy
+// 복사
 await fs.copy('/src/file.txt', '/dest/file.txt');
 await fs.copy('/src/dir', '/dest/dir');
 await fs.copy(src, dest, {
@@ -24,18 +24,18 @@ await fs.copy(src, dest, {
   filter: (src) => !src.includes('node_modules'),
 });
 
-// Remove
+// 삭제
 await fs.remove('/path/to/dir');
 
-// Read directory
+// 디렉토리 읽기
 const items = await fs.readdir('/path/to/dir');
 
-// Check file type
+// 파일 타입 확인
 const stat = await fs.stat(itemPath);
 if (stat.isDirectory()) { /* ... */ }
 if (stat.isFile()) { /* ... */ }
 
-// Read/Write files
+// 파일 읽기/쓰기
 const content = await fs.readFile('/path/to/file', 'utf-8');
 await fs.writeFile('/path/to/file', content, 'utf-8');
 
@@ -43,7 +43,7 @@ await fs.writeFile('/path/to/file', content, 'utf-8');
 const data = await fs.readJson('/path/to/file.json');
 await fs.writeJson('/path/to/file.json', data, { spaces: 2 });
 
-// Recursive copy
+// 재귀 복사
 const copyRecursive = async (src: string, dest: string) => {
   const counter = { files: 0, directories: 0 };
 

package/templates/npx/docs/library/prompts/index.md

@@ -66,7 +66,7 @@ const { secret } = await prompts({
   message: 'Enter password:',
 });
 
-// Handle cancellation
+// 취소 처리
 const { template } = await prompts({ /* ... */ });
 
 if (!template) {
@@ -74,14 +74,14 @@ if (!template) {
   process.exit(0);
 }
 
-// Multiple questions
+// 연속 질문
 const response = await prompts([
   { type: 'text', name: 'name', message: 'Project name?' },
   { type: 'select', name: 'template', message: 'Template?', choices: [...] },
   { type: 'confirm', name: 'git', message: 'Initialize git?' },
 ]);
 
-// Conditional questions
+// 조건부 질문
 const response = await prompts([
   { type: 'confirm', name: 'useTypescript', message: 'Use TypeScript?' },
   { type: (prev) => prev ? 'confirm' : null, name: 'strict', message: 'Enable strict mode?' },

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

@@ -1,10 +1,10 @@
 # NPX CLI Patterns
 
-> Integrated CLI implementation patterns
+> CLI 구현 통합 패턴
 
 <patterns>
 
-## CLI Entry Point
+## CLI 진입점
 
 ```typescript
 #!/usr/bin/env node
@@ -35,7 +35,7 @@ program
 program.parse();
 ```
 
-## Logger Utility
+## Logger 유틸
 
 ```typescript
 import pc from 'picocolors';
@@ -49,7 +49,7 @@ export const logger = {
 };
 ```
 
-## Interactive Template Selection
+## 대화형 템플릿 선택
 
 ```typescript
 import prompts from 'prompts';
@@ -61,7 +61,7 @@ export const selectAndCopyTemplate = async (
   templatesDir: string,
   targetDir: string,
 ): Promise<void> => {
-  // 1. Select template
+  // 1. 템플릿 선택
   const { template } = await prompts({
     type: 'select',
     name: 'template',
@@ -77,7 +77,7 @@ export const selectAndCopyTemplate = async (
     process.exit(0);
   }
 
-  // 2. Confirm overwrite
+  // 2. 덮어쓰기 확인
   const targetExists = await fs.pathExists(targetDir);
   if (targetExists) {
     const { overwrite } = await prompts({
@@ -93,14 +93,14 @@ export const selectAndCopyTemplate = async (
     }
   }
 
-  // 3. Copy files
+  // 3. 복사
   const src = path.join(templatesDir, template);
   await fs.copy(src, targetDir, { overwrite: true });
   logger.success(`Template copied to ${targetDir}`);
 };
 ```
 
-## ESM __dirname Handling
+## ESM __dirname 처리
 
 ```typescript
 import { fileURLToPath } from 'url';
@@ -109,11 +109,11 @@ import path from 'path';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-// Templates directory path
+// 템플릿 디렉토리 경로
 const templatesDir = path.resolve(__dirname, '../templates');
 ```
 
-## Recursive Copy with Counter
+## 재귀 복사 with Counter
 
 ```typescript
 import fs from 'fs-extra';
@@ -147,7 +147,7 @@ export const copyRecursive = async (
 };
 ```
 
-## package.json Configuration
+## package.json 설정
 
 ```json
 {
@@ -167,7 +167,7 @@ export const copyRecursive = async (
 }
 ```
 
-## tsup Configuration
+## tsup 설정
 
 ```typescript
 import { defineConfig } from 'tsup';

package/templates/tanstack-start/CLAUDE.md

@@ -4,17 +4,17 @@
 
 <context>
 
-**Purpose:** Work guidelines for TanStack Start framework development
+**Purpose:** TanStack Start 프레임워크 개발을 위한 작업 지침
 
-**Scope:** Full-stack React application implementation
+**Scope:** Full-stack React 애플리케이션 구현
 
 **Key Features:**
 - File-based routing (TanStack Router)
-- Server Functions (type-safe API)
+- Server Functions (타입 안전 API)
 - SSR + Streaming
-- TanStack Query integration
-- Middleware system
-- Deployment flexibility (Vercel, Cloudflare, Nitro)
+- TanStack Query 통합
+- Middleware 체계
+- Deployment 유연성 (Vercel, Cloudflare, Nitro)
 
 </context>
 
@@ -36,14 +36,14 @@
 
 <forbidden>
 
-| Category | Forbidden Actions |
-|----------|-------------------|
-| **Git Commits** | AI markers (`Generated with Claude Code`, `🤖`, `Co-Authored-By:`), multi-line messages, emojis |
-| **Prisma** | Auto-running `db push/migrate/generate`, unauthorized `schema.prisma` modifications |
-| **API Routes** | Creating routes in `/api` path (use Server Functions instead) |
-| **Server Fn** | Manual validation/auth inside handler, using `.validator()` (use `.inputValidator()` instead) |
-| **Client** | Direct Server Function calls (use TanStack Query) |
-| **Code Search** | Bash grep/rg/find commands (use ast-grep or dedicated tools) |
+| 분류 | 금지 행동 |
+|------|----------|
+| **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 또는 전용 도구 사용) |
 
 </forbidden>
 
@@ -51,18 +51,18 @@
 
 <required>
 
-| Task | Required Actions |
-|------|-----------------|
-| **Before Starting** | Read related docs (UI → design, API → tanstack-start, DB → prisma, Auth → better-auth) |
-| **Document Search** | Use serena mcp (document indexing/search, context length optimization) |
-| **Code Search** | Use ast-grep (function/component/pattern search) |
-| **Complex Tasks** | Sequential Thinking MCP (5+ step tasks) |
-| **Large Changes** | gemini-review (3+ file changes, architecture decisions) |
-| **Server Function** | POST/PUT/PATCH → `.inputValidator()` required, Auth needed → `.middleware()` required |
-| **Client API** | Call Server Functions via TanStack Query (`useQuery`/`useMutation`) |
-| **Custom Hook Order** | State → Global Hooks (useParams, useNavigate) → React Query → Handlers → Memo → Effect |
-| **Code Writing** | UTF-8 encoding, Korean comments per code block, const function declarations |
-| **Prisma** | Multi-File structure (`prisma/schema/`), Korean comments on all elements required |
+| 작업 | 필수 행동 |
+|------|----------|
+| **작업 시작 전** | 관련 docs 읽기 (UI → design, API → tanstack-start, DB → prisma, 인증 → better-auth) |
+| **문서 검색** | serena mcp 사용 (문서 인덱싱/검색, context 길이 최적화) |
+| **코드 검색** | 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/`), 모든 요소 한글 주석 필수 |
 
 </required>
 
@@ -70,14 +70,14 @@
 
 <tech_stack>
 
-| Tech | Version | Notes |
-|------|---------|-------|
-| TanStack Start | Latest | - |
+| 기술 | 버전 | 주의 |
+|------|------|------|
+| TanStack Start | 최신 | - |
 | TypeScript | 5.x | strict |
 | Tailwind CSS | 4.x | @theme |
-| Prisma | **7.x** | `prisma-client`, output required |
+| Prisma | **7.x** | `prisma-client`, output 필수 |
 | Zod | **4.x** | `z.email()`, `z.url()` |
-| Better Auth | Latest | - |
+| Better Auth | 최신 | - |
 | TanStack Query | 5.x | - |
 
 </tech_stack>
@@ -89,36 +89,36 @@
 src/
 ├── routes/          # __root.tsx, index.tsx, $slug.tsx
 │   └── [path]/
-│       ├── -components/  # Page-specific (required)
-│       ├── -hooks/       # Page-specific Custom Hooks (required)
-│       └── -functions/   # Page-specific Server Functions (required)
-├── functions/       # Shared Server Functions
+│       ├── -components/  # 페이지 전용 (필수)
+│       ├── -hooks/       # 페이지 전용 Custom Hooks (필수)
+│       └── -functions/   # 페이지 전용 Server Functions (필수)
+├── functions/       # 공통 Server Functions
 ├── components/ui/
 ├── middleware/
 ├── database/prisma.ts
 └── lib/
 ```
 
-**Required Rules:**
-- Each page must have `-components/`, `-hooks/`, `-functions/` folders (regardless of line count)
-- Custom Hooks **must always** be separated into `-hooks/` folder regardless of page size
-- Shared functions → `@/functions/`, Route-specific → `routes/[path]/-functions/`
+**필수 규칙:**
+- 페이지당 `-components/`, `-hooks/`, `-functions/` 폴더 필수 (줄 수 무관)
+- Custom Hook은 페이지 크기와 무관하게 **반드시** `-hooks/` 폴더에 분리
+- 공통 함수 → `@/functions/`, 라우트 전용 → `routes/[경로]/-functions/`
 </structure>
 
 ---
 
 <conventions>
 
-Filenames: kebab-case, Routes: `__root.tsx`, `$param.tsx`
-TypeScript: const declarations, explicit return types, interface (objects)/type (unions), any→unknown
-Import order: external → @/ → relative → type
+파일명: 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   # enums
-└── [model].prisma # per model (Korean comments!)
+├── +enum.prisma   # enum
+└── [model].prisma # 모델별 (한글 주석!)
 ```
 
 </conventions>
@@ -128,12 +128,12 @@ prisma/schema/
 <quick_patterns>
 
 ```typescript
-// Server Function (GET + Auth)
+// Server Function (GET + 인증)
 export const getUsers = createServerFn({ method: 'GET' })
   .middleware([authMiddleware])
   .handler(async () => prisma.user.findMany())
 
-// Server Function (POST + Validation + Auth)
+// Server Function (POST + Validation + 인증)
 export const createUser = createServerFn({ method: 'POST' })
   .middleware([authMiddleware])
   .inputValidator(createUserSchema)
@@ -166,12 +166,12 @@ const mutation = useMutation({
 
 <ui_ux>
 
-| Principle | Value |
-|-----------|-------|
-| Colors | 60-30-10 (background-secondary-accent) |
-| Spacing | 8px grid |
-| Accessibility | WCAG AA (4.5:1+ contrast) |
-| Fonts | 2-3 fonts |
+| 원칙 | 값 |
+|------|------|
+| 색상 | 60-30-10 (배경-보조-강조) |
+| 간격 | 8px 그리드 |
+| 접근성 | WCAG AA (대비 4.5:1+) |
+| 폰트 | 2-3개 |
 | Safe Area | tailwindcss-safe-area |
 
 </ui_ux>
@@ -181,8 +181,8 @@ const mutation = useMutation({
 <docs_structure>
 ```
 docs/
-├── guides/          # Getting started, conventions, patterns
+├── guides/          # 시작하기, 규칙, 패턴
 ├── library/         # tanstack-start/router/query, prisma, better-auth, t3-env, zod
-└── design.md        # UI/UX guide
+└── design.md        # UI/UX 가이드
 ```
 </docs_structure>