@kood/claude-code 0.5.4 → 0.5.5

package/templates/tanstack-start/docs/guides/routes.md

@@ -1,6 +1,6 @@
-# Route Structure
+# 라우트 구조
 
-> TanStack Start File-Based Routing
+> TanStack Start 파일 기반 라우팅
 
 <instructions>
 @../library/tanstack-router/index.md
@@ -10,7 +10,7 @@
 
 <route_structure>
 
-## Route Folder Structure
+## 라우트 폴더 구조
 
 ```
 routes/
@@ -19,28 +19,28 @@ routes/
 ├── users/
 │   ├── index.tsx        # /users (List)
 │   ├── $id.tsx          # /users/:id (Detail)
-│   ├── -components/     # Page-specific components (required)
-│   ├── -hooks/          # Page-specific Hooks (required)
-│   ├── -functions/      # Page-specific Server Functions (required)
-│   └── -sections/       # Section separation (optional, complex pages only)
+│   ├── -components/     # 페이지 전용 컴포넌트 (필수)
+│   ├── -hooks/          # 페이지 전용 Hook (필수)
+│   ├── -functions/      # 페이지 전용 Server Functions (필수)
+│   └── -sections/       # 섹션 분리 (선택, 복잡한 경우만)
 └── posts/
     ├── index.tsx
     ├── $slug.tsx
-    ├── -components/     # Required
-    ├── -hooks/          # Required
-    └── -functions/      # Required
+    ├── -components/     # 필수
+    ├── -hooks/          # 필수
+    └── -functions/      # 필수
 ```
 
-| Prefix | Purpose | Route Generation |
-|--------|---------|------------------|
-| `-` | Exclude from routes | ❌ Excluded |
-| `$` | Dynamic parameters | ✅ Generated |
-| `_` | Pathless Layout | ✅ Generated (no path) |
+| 접두사 | 용도 | 라우트 생성 |
+|--------|------|-----------|
+| `-` | 라우트 제외 폴더 | ❌ 제외 |
+| `$` | 동적 파라미터 | ✅ 생성 |
+| `_` | Pathless Layout | ✅ 생성 (경로 없음) |
 
-**⚠️ Required Rules:**
-- All pages must have `-components/`, `-hooks/`, `-functions/` folders
-- Custom Hooks must always be separated into `-hooks/` folder regardless of page size
-- `-sections/` is optional, use only for complex pages (200+ lines)
+**⚠️ 필수 규칙:**
+- 모든 페이지에 `-components/`, `-hooks/`, `-functions/` 폴더 **필수**
+- 페이지 크기(줄 수)와 **무관**하게 Custom Hook은 반드시 `-hooks/` 폴더에 분리
+- `-sections/`는 200줄 이상 복잡한 페이지에서만 선택적 사용
 
 </route_structure>
 
@@ -48,17 +48,17 @@ routes/
 
 <file_naming>
 
-## Route File Naming Rules
+## 라우트 파일명 규칙
 
-| Path | Filename | Description |
-|------|----------|-------------|
-| `/` | `index.tsx` | Index route |
-| `/users` | `users/index.tsx` | List page |
-| `/users/:id` | `users/$id.tsx` | Dynamic parameter |
-| `/posts/:slug` | `posts/$slug.tsx` | URL parameter |
-| `/dashboard/*` | `dashboard/$.tsx` | Catch-all route |
-| Layout | `__root.tsx` | Root layout |
-| Pathless | `_layout.tsx` | Pathless layout |
+| 경로 | 파일명 | 설명 |
+|------|--------|------|
+| `/` | `index.tsx` | 인덱스 라우트 |
+| `/users` | `users/index.tsx` | 목록 페이지 |
+| `/users/:id` | `users/$id.tsx` | 동적 파라미터 |
+| `/posts/:slug` | `posts/$slug.tsx` | URL 파라미터 |
+| `/dashboard/*` | `dashboard/$.tsx` | Catch-all 라우트 |
+| Layout | `__root.tsx` | Root 레이아웃 |
+| Pathless | `_layout.tsx` | 경로 없는 레이아웃 |
 
 </file_naming>
 
@@ -66,7 +66,7 @@ routes/
 
 <patterns>
 
-## Basic Route Pattern
+## 기본 라우트 패턴
 
 ```tsx
 // routes/users/index.tsx
@@ -89,7 +89,7 @@ const UsersPage = (): JSX.Element => {
 }
 ```
 
-## Dynamic Route + Loader
+## 동적 라우트 + Loader
 
 ```tsx
 // routes/users/$id.tsx
@@ -188,7 +188,7 @@ const DashboardPage = (): JSX.Element => {
 }
 ```
 
-## Section Pattern
+## Section 패턴
 
 ```tsx
 // routes/users/-sections/user-list-section.tsx
@@ -217,7 +217,7 @@ export const UserListSection = (): JSX.Element => {
 }
 ```
 
-## Component Pattern
+## 컴포넌트 패턴
 
 ```tsx
 // routes/users/-components/user-card.tsx
@@ -268,21 +268,21 @@ export const UserCard = ({
 
 <folder_structure_rules>
 
-## Folder Structure Rules
+## 폴더 구조 규칙
 
-**⚠️ Required for All Pages:**
-- `-components/`: Page-specific components
-- `-hooks/`: Page-specific Custom Hooks (regardless of line count)
-- `-functions/`: Page-specific Server Functions
+**⚠️ 모든 페이지에 필수:**
+- `-components/`: 페이지 전용 컴포넌트
+- `-hooks/`: 페이지 전용 Custom Hook (줄 수 무관)
+- `-functions/`: 페이지 전용 Server Functions
 
-**Optional:**
-- `-sections/`: Use only for complex pages (200+ lines)
+**선택적 사용:**
+- `-sections/`: 200줄+ 복잡한 페이지에서만 사용
 
-| Page Size | Required | Optional |
-|-----------|----------|----------|
-| ~100 lines | `-components/`, `-hooks/`, `-functions/` | - |
-| 100-200 lines | `-components/`, `-hooks/`, `-functions/` | - |
-| 200+ lines | `-components/`, `-hooks/`, `-functions/` | `-sections/` |
+| 페이지 크기 | 필수 | 선택 |
+|------------|------|------|
+| ~100줄 | `-components/`, `-hooks/`, `-functions/` | - |
+| 100-200줄 | `-components/`, `-hooks/`, `-functions/` | - |
+| 200줄+ | `-components/`, `-hooks/`, `-functions/` | `-sections/` |
 
 </folder_structure_rules>
 
@@ -290,23 +290,23 @@ export const UserCard = ({
 
 <loader_execution>
 
-## Loader Execution Order
+## Loader 실행 순서
 
-| Step | Execution | Description |
-|------|-----------|-------------|
-| 1. `beforeLoad` | Sequential (outermost → innermost) | Auth check, context setup |
-| 2. `loader` | Parallel (all loaders simultaneously) | Data fetching |
+| 단계 | 실행 방식 | 설명 |
+|------|----------|------|
+| 1. `beforeLoad` | 순차 (outermost → innermost) | 인증 체크, 컨텍스트 설정 |
+| 2. `loader` | 병렬 (모든 loader 동시) | 데이터 페칭 |
 
 ```tsx
 // Parent Route
 export const Route = createFileRoute('/dashboard')({
   beforeLoad: async () => {
-    // 1. Runs first (sequential)
+    // 1. 먼저 실행 (순차)
     const auth = await checkAuth()
     return { auth }
   },
   loader: async () => {
-    // 2. Runs later (parallel)
+    // 2. 나중에 실행 (병렬)
     return getDashboardData()
   },
 })
@@ -314,11 +314,11 @@ export const Route = createFileRoute('/dashboard')({
 // Child Route
 export const Route = createFileRoute('/dashboard/users')({
   beforeLoad: async () => {
-    // 1. Runs after Parent beforeLoad
+    // 1. Parent beforeLoad 다음 실행
     return {}
   },
   loader: async () => {
-    // 2. Runs in parallel with Parent loader
+    // 2. Parent loader와 병렬 실행
     return getUsers()
   },
 })

package/templates/tanstack-start/docs/guides/services.md

@@ -1,6 +1,6 @@
 # Server Functions
 
-> TanStack Start Data Layer (Server Functions)
+> TanStack Start 데이터 레이어 (Server Functions)
 
 <instructions>
 @../library/tanstack-start/index.md
@@ -10,15 +10,15 @@
 
 <api_naming>
 
-## API Names (Important)
+## API 이름 (중요)
 
-| ✅ Correct API | ❌ Incorrect API | Description |
-|----------------|------------------|-------------|
-| `.inputValidator()` | ~~`.validator()`~~ | TanStack Start only supports `inputValidator` |
-| `.middleware()` | - | Middleware chaining |
-| `.handler()` | - | Final handler function |
+| ✅ 올바른 API | ❌ 잘못된 API | 설명 |
+|-------------|-------------|------|
+| `.inputValidator()` | ~~`.validator()`~~ | TanStack Start는 `inputValidator`만 지원 |
+| `.middleware()` | - | Middleware 체이닝 |
+| `.handler()` | - | 최종 handler 함수 |
 
-**Note:** `validator` does not exist. Always use `inputValidator`.
+**주의:** `validator`는 존재하지 않는 API입니다. 반드시 `inputValidator`를 사용하세요.
 
 </api_naming>
 
@@ -26,15 +26,15 @@
 
 <folder_structure>
 
-## Service Folder Structure
+## 서비스 폴더 구조
 
 ```
 services/
 ├── user/
-│   ├── index.ts         # Entry point (re-export)
-│   ├── schemas.ts       # Zod schemas
-│   ├── queries.ts       # GET (read)
-│   └── mutations.ts     # POST (write)
+│   ├── index.ts         # 진입점 (re-export)
+│   ├── schemas.ts       # Zod 스키마
+│   ├── queries.ts       # GET (읽기)
+│   └── mutations.ts     # POST (쓰기)
 ├── auth/
 │   ├── index.ts
 │   ├── schemas.ts
@@ -47,12 +47,12 @@ services/
     └── mutations.ts
 ```
 
-| File | Purpose |
-|------|---------|
-| `index.ts` | Re-export all functions |
-| `schemas.ts` | Zod validation schemas |
-| `queries.ts` | GET requests (read) |
-| `mutations.ts` | POST/PUT/DELETE (write) |
+| 파일 | 용도 |
+|------|------|
+| `index.ts` | 모든 함수 re-export |
+| `schemas.ts` | Zod 검증 스키마 |
+| `queries.ts` | GET 요청 (읽기) |
+| `mutations.ts` | POST/PUT/DELETE (쓰기) |
 
 </folder_structure>
 
@@ -60,7 +60,7 @@ services/
 
 <patterns>
 
-## Schemas File
+## Schemas 파일
 
 ```typescript
 // services/user/schemas.ts
@@ -81,7 +81,7 @@ export type CreateUserInput = z.infer<typeof createUserSchema>
 export type UpdateUserInput = z.infer<typeof updateUserSchema>
 ```
 
-## Queries File (GET)
+## Queries 파일 (GET)
 
 ```typescript
 // services/user/queries.ts
@@ -108,7 +108,7 @@ export const getUserByEmail = createServerFn({ method: 'GET' })
   })
 ```
 
-## Mutations File (POST)
+## Mutations 파일 (POST)
 
 ```typescript
 // services/user/mutations.ts
@@ -135,7 +135,7 @@ export const deleteUser = createServerFn({ method: 'POST' })
   })
 ```
 
-## Entry Point File
+## 진입점 파일
 
 ```typescript
 // services/user/index.ts
@@ -144,7 +144,7 @@ export * from './queries'
 export * from './mutations'
 ```
 
-## Database File
+## Database 파일
 
 ```typescript
 // database/prisma.ts
@@ -171,7 +171,7 @@ if (process.env.NODE_ENV !== 'production') {
 
 <middleware>
 
-## Middleware Pattern
+## Middleware 패턴
 
 ```typescript
 // middleware/auth.ts
@@ -234,7 +234,7 @@ export const deleteUser = createServerFn({ method: 'POST' })
 
 <usage>
 
-## TanStack Query Integration
+## TanStack Query 연동
 
 ```typescript
 // routes/users/-hooks/use-users.ts
@@ -274,7 +274,7 @@ export const useUsers = () => {
 }
 ```
 
-## Form Integration
+## Form 연동
 
 ```tsx
 // routes/users/-components/create-user-form.tsx
@@ -331,23 +331,23 @@ export const CreateUserForm = (): JSX.Element => {
 
 <method_chaining>
 
-## Method Chaining Order
+## Method Chaining 순서
 
 ```typescript
-// ✅ Correct order
+// ✅ 올바른 순서
 createServerFn({ method: 'POST' })
-  .middleware([authMiddleware])      // 1. middleware (optional)
-  .inputValidator(createUserSchema)  // 2. inputValidator (optional)
-  .handler(async ({ data }) => {})   // 3. handler (required)
+  .middleware([authMiddleware])      // 1. middleware (선택)
+  .inputValidator(createUserSchema)  // 2. inputValidator (선택)
+  .handler(async ({ data }) => {})   // 3. handler (필수)
 
-// ❌ Wrong order (TypeScript error)
+// ❌ 잘못된 순서 (TypeScript 에러)
 createServerFn({ method: 'POST' })
-  .handler(async () => {})           // ❌ handler first
-  .inputValidator(schema)            // ❌ inputValidator after
+  .handler(async () => {})           // ❌ handler가 먼저
+  .inputValidator(schema)            // ❌ inputValidator가 나중에
 
-// ❌ Wrong API name (does not exist)
+// ❌ 잘못된 API 이름 (존재하지 않음)
 createServerFn({ method: 'POST' })
-  .validator(schema)                 // ❌ validator doesn't exist! Use inputValidator
+  .validator(schema)                 // ❌ validator는 없음! inputValidator 사용
   .handler(async ({ data }) => {})
 ```
 
@@ -357,14 +357,14 @@ createServerFn({ method: 'POST' })
 
 <best_practices>
 
-| Principle | Description |
-|-----------|-------------|
-| **File Separation** | Separate schemas, queries, mutations required |
-| **Entry Point** | Re-export all functions in index.ts |
-| **Validation** | inputValidator required for POST/PUT/DELETE |
-| **Middleware** | Use middleware for auth/permissions |
-| **TanStack Query** | Never call directly from client, use Query/Mutation |
-| **Error Handling** | Throw clear error messages |
+| 원칙 | 설명 |
+|------|------|
+| **파일 분리** | schemas, queries, mutations 분리 필수 |
+| **진입점** | index.ts에서 모든 함수 re-export |
+| **Validation** | POST/PUT/DELETE는 inputValidator 필수 |
+| **Middleware** | 인증/권한은 middleware 사용 |
+| **TanStack Query** | 클라이언트에서 직접 호출 금지, Query/Mutation 사용 |
+| **에러 처리** | 명확한 에러 메시지 throw |
 
 </best_practices>
 

package/templates/tanstack-start/docs/library/prisma/cloudflare-d1.md

@@ -1,17 +1,17 @@
 # Prisma - Cloudflare D1
 
-SQLite-based serverless database. Different workflow from regular Prisma migrations.
+SQLite 기반 서버리스 DB. 일반 Prisma 마이그레이션과 다른 워크플로우.
 
-⚠️ No transaction support | Can't use prisma migrate - use wrangler | Preview status
+⚠️ 트랜잭션 미지원 | prisma migrate 불가 - wrangler 사용 | Preview 상태
 
-## Configuration
+## 설정
 
 ```prisma
 // schema.prisma
 generator client {
   provider = "prisma-client"
   output   = "../src/generated/prisma"
-  runtime  = "cloudflare"  // Required
+  runtime  = "cloudflare"  // 필수
 }
 
 datasource db {
@@ -26,7 +26,7 @@ datasource db {
 }
 ```
 
-## Usage
+## 사용법
 
 ```typescript
 import { PrismaClient } from './generated/prisma'
@@ -44,33 +44,33 @@ export default {
 }
 ```
 
-## Migration Workflow
+## 마이그레이션 워크플로우
 
 ```bash
-# 1. Create D1
+# 1. D1 생성
 npx wrangler d1 create my-database
 
-# 2. Create migration
+# 2. 마이그레이션 생성
 npx wrangler d1 migrations create my-database init
 
-# 3. Generate SQL (initial)
+# 3. SQL 생성 (초기)
 npx prisma migrate diff --from-empty --to-schema-datamodel prisma/schema.prisma --script --output prisma/migrations/0001.sql
 
-# 4. Generate SQL (subsequent)
+# 4. SQL 생성 (후속)
 npx prisma migrate diff --from-local-d1 --to-schema-datamodel prisma/schema.prisma --script
 
-# 5. Apply
-npx wrangler d1 migrations apply my-database --local   # Local
-npx wrangler d1 migrations apply my-database --remote  # Production
+# 5. 적용
+npx wrangler d1 migrations apply my-database --local   # 로컬
+npx wrangler d1 migrations apply my-database --remote  # 프로덕션
 
-# 6. Generate Client
+# 6. Client 생성
 npx prisma generate
 ```
 
-## Limitations
+## 제한사항
 
-| Feature | Regular SQLite | D1 |
+| 항목 | 일반 SQLite | D1 |
 |------|-------------|-----|
-| Migration | prisma migrate | wrangler d1 |
-| Transactions | ✅ | ❌ |
-| Connection | Direct | HTTP adapter |
+| 마이그레이션 | prisma migrate | wrangler d1 |
+| 트랜잭션 | ✅ | ❌ |
+| 접속 | 직접 | HTTP 어댑터 |

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

@@ -1,8 +1,8 @@
-# Prisma - Config File
+# Prisma - Config 파일
 
-Prisma v7 `prisma.config.ts` configuration.
+Prisma v7 `prisma.config.ts` 설정.
 
-## Multi-File Schema (Required)
+## Multi-File 스키마 (필수)
 
 ```typescript
 // prisma.config.ts
@@ -11,7 +11,7 @@ import path from 'node:path'
 import { defineConfig, env } from 'prisma/config'
 
 export default defineConfig({
-  schema: path.join('prisma', 'schema'),  // folder path!
+  schema: path.join('prisma', 'schema'),  // 폴더 경로!
   migrations: {
     path: 'prisma/migrations',
     seed: 'tsx prisma/seed.ts',
@@ -22,16 +22,16 @@ export default defineConfig({
 })
 ```
 
-## Folder Structure
+## 폴더 구조
 
 ```
-project/
+프로젝트/
 ├── prisma.config.ts
 ├── prisma/
 │   ├── schema/
 │   │   ├── +base.prisma   # datasource, generator
-│   │   ├── +enum.prisma   # enum definitions
-│   │   └── user.prisma    # models
+│   │   ├── +enum.prisma   # enum 정의
+│   │   └── user.prisma    # 모델
 │   └── migrations/
 ```
 
@@ -49,17 +49,17 @@ generator client {
 }
 ```
 
-## Configuration Options
+## 설정 옵션
 
-| Option | Description |
+| 옵션 | 설명 |
 |------|------|
-| `schema` | Schema folder path |
-| `datasource.url` | DB URL (required) |
+| `schema` | 스키마 폴더 경로 |
+| `datasource.url` | DB URL (필수) |
 | `datasource.shadowDatabaseUrl` | Shadow DB URL |
-| `migrations.path` | Migrations folder |
-| `migrations.seed` | Seed command |
+| `migrations.path` | 마이그레이션 폴더 |
+| `migrations.seed` | 시드 명령어 |
 
-## Seed File
+## 시드 파일
 
 ```typescript
 // prisma/seed.ts
@@ -69,7 +69,7 @@ const prisma = new PrismaClient()
 
 async function main() {
   await prisma.user.create({
-    data: { email: 'admin@example.com', name: 'Admin', role: 'ADMIN' },
+    data: { email: 'admin@example.com', name: '관리자', role: 'ADMIN' },
   })
 }
 

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

@@ -1,14 +1,14 @@
-# Prisma - CRUD Operations
+# Prisma - CRUD 작업
 
 ## Create
 
 ```typescript
-// Single
+// 단일
 const user = await prisma.user.create({
   data: { email: 'alice@prisma.io', name: 'Alice' },
 })
 
-// With relations
+// 관계 포함
 const user = await prisma.user.create({
   data: {
     email: 'bob@prisma.io',
@@ -27,22 +27,22 @@ posts: { create: [{
 ## Read
 
 ```typescript
-// Single
+// 단일
 const user = await prisma.user.findUnique({ where: { email } })
 
-// Multiple
+// 다중
 const users = await prisma.user.findMany({ where: { name: 'Alice' } })
 
-// With relations
+// 관계 포함
 const users = await prisma.user.findMany({ where: { role: 'ADMIN' }, include: { posts: true } })
 
-// Field selection
+// 필드 선택
 const user = await prisma.user.findUnique({
   where: { email },
   select: { email: true, posts: { select: { title: true } } },
 })
 
-// Filter by relations
+// 관계로 필터
 const users = await prisma.user.findMany({
   where: { posts: { some: { published: false } } },
 })
@@ -51,10 +51,10 @@ const users = await prisma.user.findMany({
 ## Update
 
 ```typescript
-// Single
+// 단일
 const user = await prisma.user.update({ where: { id }, data: { name: 'Updated' } })
 
-// Multiple
+// 다중
 await prisma.user.updateMany({ where: { role: 'USER' }, data: { role: 'ADMIN' } })
 
 // Upsert
@@ -69,22 +69,22 @@ const user = await prisma.user.upsert({
 
 ```typescript
 await prisma.user.delete({ where: { id } })
-await prisma.user.deleteMany({})  // All
-await prisma.post.deleteMany({ where: { published: false } })  // Conditional
+await prisma.user.deleteMany({})  // 전체
+await prisma.post.deleteMany({ where: { published: false } })  // 조건부
 ```
 
-## Filter Operators
+## 필터 연산자
 
 ```typescript
-// String
+// 문자열
 { contains: 'prisma', startsWith: 'A', endsWith: 'io' }
 
-// Number
+// 숫자
 { gt: 18, gte: 18, lt: 65, lte: 65 }
 
-// Array
+// 배열
 { in: [1, 2, 3], notIn: [4, 5] }
 
-// Logical
+// 논리
 { OR: [...], AND: [...], NOT: {...} }
 ```