@kood/claude-code 0.3.6 → 0.3.8

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

@@ -1,6 +1,6 @@
-# Prisma - 관계 쿼리
+# Prisma - Relation Queries
 
-## 중첩 생성
+## Nested Create
 
 ```typescript
 const user = await prisma.user.create({
@@ -12,53 +12,53 @@ const user = await prisma.user.create({
 })
 ```
 
-## 관계 연결
+## Relation Operations
 
 ```typescript
-// connect - 기존 연결
+// connect - Link existing record
 author: { connect: { id: 1 } }
 
-// connectOrCreate - 있으면 연결, 없으면 생성
+// connectOrCreate - Connect if exists, create otherwise
 categories: { connectOrCreate: { where: { name: 'Tech' }, create: { name: 'Tech' } } }
 
-// disconnect - 관계 해제
+// disconnect - Remove relation
 author: { disconnect: true }
 ```
 
-## 관계 포함 조회
+## Include Relations
 
 ```typescript
 // include
 const users = await prisma.user.findMany({ include: { posts: true, profile: true } })
 
-// 중첩
+// Nested
 include: { posts: { include: { categories: true } } }
 
-// 필터 + 정렬
+// Filter + Sort
 include: { posts: { where: { published: true }, orderBy: { createdAt: 'desc' }, take: 5 } }
 ```
 
-## 관계로 필터링
+## Filter by Relations
 
 ```typescript
-// some - 하나라도 만족
+// some - At least one matches
 where: { posts: { some: { published: true } } }
 
-// every - 모두 만족
+// every - All match
 where: { posts: { every: { published: true } } }
 
-// none - 만족 없음
+// none - None match
 where: { posts: { none: { published: false } } }
 ```
 
-## 카운트
+## Count
 
 ```typescript
 include: { _count: { select: { posts: true } } }
-// 결과: { _count: { posts: 5 } }
+// Result: { _count: { posts: 5 } }
 ```
 
-## 중첩 수정/삭제
+## Nested Update/Delete
 
 ```typescript
 // updateMany

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

@@ -1,21 +1,21 @@
-# Prisma - 스키마 정의 (Multi-File)
+# Prisma - Schema Definition (Multi-File)
 
-## ⚠️ 필수 규칙
+## ⚠️ Required Rules
 
-1. **Multi-File 구조** 사용
-2. **모든 요소에 한글 주석** (파일, 모델, 필드, enum)
+1. **Multi-File structure** required
+2. **Korean comments on all elements** (files, models, fields, enums)
 
-## 구조
+## Structure
 
 ```
 prisma/schema/
 ├── +base.prisma    # datasource, generator
-├── +enum.prisma    # 모든 enum
-├── user.prisma     # User 모델
-└── post.prisma     # Post 모델
+├── +enum.prisma    # all enums
+├── user.prisma     # User model
+└── post.prisma     # Post model
 ```
 
-## 예시
+## Examples
 
 ```prisma
 // +base.prisma
@@ -31,24 +31,24 @@ generator client {
 
 // +enum.prisma
 enum Role {
-  USER   // 일반 사용자
-  ADMIN  // 관리자
+  USER   // Regular user
+  ADMIN  // Administrator
 }
 
 // user.prisma
 model User {
   id        Int      @id @default(autoincrement())
-  email     String   @unique  // 로그인 이메일
-  name      String?           // 표시 이름
+  email     String   @unique  // Login email
+  name      String?           // Display name
   role      Role     @default(USER)
-  posts     Post[]            // 작성 게시글 (1:N)
-  profile   Profile?          // 프로필 (1:1)
+  posts     Post[]            // Author posts (1:N)
+  profile   Profile?          // Profile (1:1)
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 }
 ```
 
-## 관계 유형
+## Relation Types
 
 ```prisma
 // 1:1
@@ -64,11 +64,11 @@ model Post {
   authorId Int
 }
 
-// M:N (암묵적)
+// M:N (implicit)
 model Post { categories Category[] }
 model Category { posts Post[] }
 
-// M:N (명시적)
+// M:N (explicit)
 model CategoriesOnPosts {
   post       Post     @relation(fields: [postId], references: [id])
   postId     Int
@@ -78,21 +78,21 @@ model CategoriesOnPosts {
 }
 ```
 
-## 기타
+## Other Features
 
 ```prisma
-// 선택적 관계
+// Optional relation
 author   User? @relation(fields: [authorId], references: [id])
 authorId Int?
 
-// 인덱스
+// Indexes
 @@index([authorId])
 @@index([createdAt])
 
-// 복합 키
+// Composite key
 @@id([postId, tagId])
 
-// 매핑
+// Mapping
 @map("user_id")
 @@map("users")
 ```

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

@@ -1,6 +1,6 @@
-# Prisma - 설치 및 설정
+# Prisma - Installation and Setup
 
-## 설치
+## Installation
 
 ```bash
 yarn add @prisma/client@7
@@ -8,15 +8,15 @@ yarn add -D prisma@7
 npx prisma init
 ```
 
-## v6 → v7 업그레이드
+## v6 → v7 Upgrade
 
 ```prisma
-// v6 (이전)
+// v6 (old)
 generator client {
   provider = "prisma-client-js"
 }
 
-// v7 (필수)
+// v7 (required)
 generator client {
   provider = "prisma-client"
   output   = "../generated/prisma"
@@ -34,7 +34,7 @@ export const prisma = globalForPrisma.prisma ?? new PrismaClient({ log: ['query'
 if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma
 ```
 
-## TanStack Start 연동
+## TanStack Start Integration
 
 ```typescript
 import { createServerFn } from '@tanstack/react-start'

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

@@ -1,8 +1,8 @@
-# Prisma - 트랜잭션
+# Prisma - Transactions
 
-## 배열 기반 트랜잭션
+## Array-based Transactions
 
-하나라도 실패하면 모두 롤백.
+All operations rollback if any one fails.
 
 ```typescript
 const deletePosts = prisma.post.deleteMany({ where: { authorId: 7 } })
@@ -10,9 +10,9 @@ const deleteUser = prisma.user.delete({ where: { id: 7 } })
 await prisma.$transaction([deletePosts, deleteUser])
 ```
 
-## 인터랙티브 트랜잭션
+## Interactive Transactions
 
-복잡한 로직, 조건부 처리.
+For complex logic and conditional processing.
 
 ```typescript
 const result = await prisma.$transaction(async (tx) => {
@@ -26,17 +26,17 @@ const result = await prisma.$transaction(async (tx) => {
 })
 ```
 
-## 옵션
+## Options
 
 ```typescript
 await prisma.$transaction(async (tx) => { ... }, {
-  maxWait: 5000,              // 최대 대기 (ms)
-  timeout: 10000,             // 타임아웃 (ms)
+  maxWait: 5000,              // Max wait time (ms)
+  timeout: 10000,             // Timeout (ms)
   isolationLevel: 'Serializable',  // ReadUncommitted | ReadCommitted | RepeatableRead | Serializable
 })
 ```
 
-## 에러 처리
+## Error Handling
 
 ```typescript
 try {
@@ -45,6 +45,6 @@ try {
     if (someCondition) throw new Error('Rollback')
   })
 } catch (error) {
-  // 전체 롤백됨
+  // Entire transaction rolled back
 }
 ```

package/templates/tanstack-start/docs/library/t3-env/index.md

@@ -1,16 +1,16 @@
 # t3-env - Type-Safe Environment Variables
 
-> Zod 기반 타입 안전 환경 변수 관리
+> Zod-based type-safe environment variable management
 
 <context>
 
-**용도:** 서버/클라이언트 환경 변수 분리, 런타임 검증, 타입 안전성
+**Purpose:** Server/client environment variable separation, runtime validation, type safety
 
-**특징:**
-- Zod 스키마로 검증 + 타입 추론
-- Server 변수 클라이언트 노출 방지
-- Transform & Default 값 지원
-- 프레임워크 무관
+**Features:**
+- Zod schema validation + type inference
+- Prevent server variables from being exposed to client
+- Transform & default value support
+- Framework-agnostic
 
 </context>
 
@@ -18,12 +18,12 @@
 
 <forbidden>
 
-| 분류 | 금지 |
+| Category | Forbidden |
 |------|------|
-| **노출** | Server 변수를 클라이언트에 노출 |
-| **접두사** | Client 변수에 `PUBLIC_` 없이 사용 |
-| **직접 접근** | `process.env` 직접 사용 (env 객체 필수) |
-| **타입** | any 타입으로 env 변수 접근 |
+| **Exposure** | Exposing server variables to client |
+| **Prefix** | Using client variables without `PUBLIC_` |
+| **Direct Access** | Direct `process.env` access (use env object) |
+| **Type** | Accessing env variables with any type |
 
 </forbidden>
 
@@ -31,11 +31,11 @@
 
 <required>
 
-| 분류 | 필수 |
+| Category | Required |
 |------|------|
-| **설치** | `@t3-oss/env-core zod` |
-| **구조** | `src/env.ts` 파일 생성 |
-| **접두사** | Client 변수: `PUBLIC_` 시작 |
+| **Install** | `@t3-oss/env-core zod` |
+| **Structure** | Create `src/env.ts` file |
+| **Prefix** | Client variables: Start with `PUBLIC_` |
 | **Import** | `import { env } from '@/env'` |
 
 </required>
@@ -104,7 +104,7 @@ import { env } from '@/env'
 
 export const getUsers = createServerFn({ method: 'GET' }).handler(async () => {
   const db = await prisma.$connect(env.DATABASE_URL)
-  //                                    ^? string (타입 안전)
+  //                                    ^? string (type-safe)
   return db.user.findMany()
 })
 ```
@@ -116,9 +116,9 @@ import { env } from '@/env'
 
 export const ApiClient = () => {
   const apiUrl = env.PUBLIC_API_URL
-  //                  ^? string (타입 안전)
+  //                  ^? string (type-safe)
 
-  // ❌ Error: server 변수는 클라이언트에서 접근 불가
+  // ❌ Error: server variables cannot be accessed in client
   // const dbUrl = env.DATABASE_URL
 }
 ```
@@ -154,153 +154,14 @@ client: {
 
 ---
 
-<examples>
-
-## Real-World Examples
-
-### Database + Auth
-
-```typescript
-// src/env.ts
-export const env = createEnv({
-  server: {
-    DATABASE_URL: z.url(),
-    DIRECT_URL: z.url().optional(), // Prisma connection pooling
-    CLERK_SECRET_KEY: z.string().min(1),
-    RESEND_API_KEY: z.string().min(1),
-  },
-  clientPrefix: 'PUBLIC_',
-  client: {
-    PUBLIC_CLERK_PUBLISHABLE_KEY: z.string().min(1),
-  },
-  runtimeEnv: {
-    DATABASE_URL: process.env.DATABASE_URL,
-    DIRECT_URL: process.env.DIRECT_URL,
-    CLERK_SECRET_KEY: process.env.CLERK_SECRET_KEY,
-    RESEND_API_KEY: process.env.RESEND_API_KEY,
-    PUBLIC_CLERK_PUBLISHABLE_KEY: import.meta.env.PUBLIC_CLERK_PUBLISHABLE_KEY,
-  },
-  emptyStringAsUndefined: true,
-})
-```
-
-### API Integration
-
-```typescript
-// src/env.ts
-export const env = createEnv({
-  server: {
-    OPENAI_API_KEY: z.string().min(1),
-    STRIPE_SECRET_KEY: z.string().min(1),
-    STRIPE_WEBHOOK_SECRET: z.string().min(1),
-  },
-  clientPrefix: 'PUBLIC_',
-  client: {
-    PUBLIC_STRIPE_PUBLISHABLE_KEY: z.string().min(1),
-    PUBLIC_APP_URL: z.url(),
-  },
-  runtimeEnv: {
-    OPENAI_API_KEY: process.env.OPENAI_API_KEY,
-    STRIPE_SECRET_KEY: process.env.STRIPE_SECRET_KEY,
-    STRIPE_WEBHOOK_SECRET: process.env.STRIPE_WEBHOOK_SECRET,
-    PUBLIC_STRIPE_PUBLISHABLE_KEY: import.meta.env.PUBLIC_STRIPE_PUBLISHABLE_KEY,
-    PUBLIC_APP_URL: import.meta.env.PUBLIC_APP_URL,
-  },
-  emptyStringAsUndefined: true,
-})
-```
-
-### Multi-Environment
-
-```typescript
-// src/env.ts
-export const env = createEnv({
-  server: {
-    NODE_ENV: z.enum(['development', 'production', 'test']),
-    DATABASE_URL: z.url(),
-    REDIS_URL: z.url().optional(), // Production only
-  },
-  clientPrefix: 'PUBLIC_',
-  client: {
-    PUBLIC_API_URL: z.url(),
-    PUBLIC_SENTRY_DSN: z.string().optional(), // Production only
-  },
-  runtimeEnv: {
-    NODE_ENV: process.env.NODE_ENV,
-    DATABASE_URL: process.env.DATABASE_URL,
-    REDIS_URL: process.env.REDIS_URL,
-    PUBLIC_API_URL: import.meta.env.PUBLIC_API_URL,
-    PUBLIC_SENTRY_DSN: import.meta.env.PUBLIC_SENTRY_DSN,
-  },
-  emptyStringAsUndefined: true,
-})
-```
-
-</examples>
-
----
-
-<validation>
-
-## Validation Patterns
-
-### Email
-
-```typescript
-server: {
-  ADMIN_EMAIL: z.email(),
-  SUPPORT_EMAIL: z.email().default('support@example.com'),
-}
-```
-
-### URL
-
-```typescript
-server: {
-  API_URL: z.url(),
-  WEBHOOK_URL: z.url().optional(),
-}
-```
-
-### Enum
-
-```typescript
-server: {
-  LOG_LEVEL: z.enum(['debug', 'info', 'warn', 'error']),
-  DATABASE_PROVIDER: z.enum(['postgresql', 'mysql', 'sqlite']),
-}
-```
-
-### Number
-
-```typescript
-server: {
-  PORT: z.coerce.number().positive().default(3000),
-  MAX_UPLOAD_SIZE: z.coerce.number().max(10485760), // 10MB
-}
-```
-
-### Boolean
-
-```typescript
-server: {
-  ENABLE_CACHE: z.coerce.boolean().default(true),
-  DEBUG_MODE: z.coerce.boolean().default(false),
-}
-```
-
-</validation>
-
----
-
 <tips>
 
 ## Tips
 
-| 상황 | 방법 |
+| Situation | Method |
 |------|------|
 | **Vercel** | `process.env.VERCEL_URL` → PUBLIC_APP_URL |
-| **Monorepo** | 각 패키지마다 별도 `env.ts` |
+| **Monorepo** | Separate `env.ts` per package |
 | **Testing** | `.env.test` + `NODE_ENV=test` |
 | **CI/CD** | GitHub Secrets → Environment Variables |
 

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

@@ -40,12 +40,12 @@ const mutation = useMutation({
   },
 })
 
-// 설정
+// Configuration
 const queryClient = new QueryClient({
   defaultOptions: {
     queries: {
-      staleTime: 1000 * 60 * 5,   // 5분
-      gcTime: 1000 * 60 * 30,     // 30분
+      staleTime: 1000 * 60 * 5,   // 5 minutes
+      gcTime: 1000 * 60 * 30,     // 30 minutes
       retry: 3,
     },
   },
@@ -58,9 +58,9 @@ const App = () => (
 )
 
 // Query Keys
-['todos']                       // 단순
-['todo', { id: 5 }]             // 파라미터
-['todos', 'list', { filters }]  // 계층적
+['todos']                       // Simple
+['todo', { id: 5 }]             // With params
+['todos', 'list', { filters }]  // Hierarchical
 ```
 
 </quick_reference>

package/templates/tanstack-start/docs/library/tanstack-query/invalidation.md

@@ -1,54 +1,54 @@
-# TanStack Query - Query 무효화
+# TanStack Query - Query Invalidation
 
 <patterns>
 
 ```typescript
 const queryClient = useQueryClient()
 
-// 단일
+// Single
 queryClient.invalidateQueries({ queryKey: ['todos'] })
 
-// 다중
+// Multiple
 await Promise.all([
   queryClient.invalidateQueries({ queryKey: ['todos'] }),
   queryClient.invalidateQueries({ queryKey: ['reminders'] }),
 ])
 
-// 전체
+// All
 queryClient.invalidateQueries()
 
-// 옵션
+// Options
 queryClient.invalidateQueries({
   queryKey: ['posts'],
-  exact: true,  // 정확한 키 매칭만
+  exact: true,  // Exact key match only
   refetchType: 'active',  // 'active' | 'inactive' | 'all' | 'none'
 })
 
-// Query Key 매칭
-queryClient.invalidateQueries({ queryKey: ['todos'] })  // prefix 매칭
-queryClient.invalidateQueries({ queryKey: ['todos', 'list'], exact: true })  // 정확한 매칭
+// Query Key matching
+queryClient.invalidateQueries({ queryKey: ['todos'] })  // Prefix match
+queryClient.invalidateQueries({ queryKey: ['todos', 'list'], exact: true })  // Exact match
 
-// Mutation과 함께
+// With Mutation
 useMutation({
   mutationFn: addTodo,
   onSuccess: () => queryClient.invalidateQueries({ queryKey: ['todos'] }),
-  onSettled: () => queryClient.invalidateQueries({ queryKey: ['todos'] }),  // 성공/실패 무관
+  onSettled: () => queryClient.invalidateQueries({ queryKey: ['todos'] }),  // Regardless of success/failure
 })
 
-// 직접 업데이트 vs 무효화
-queryClient.setQueryData(['todos'], (old) => [...old, newTodo])  // 더 빠름
-queryClient.invalidateQueries({ queryKey: ['todos'] })  // 서버 데이터 보장
+// Direct update vs invalidation
+queryClient.setQueryData(['todos'], (old) => [...old, newTodo])  // Faster
+queryClient.invalidateQueries({ queryKey: ['todos'] })  // Guarantees server data
 ```
 
 </patterns>
 
 <options>
 
-| refetchType | 설명 |
+| refetchType | Description |
 |-------------|------|
-| active | 렌더링 중인 쿼리만 재조회 (기본) |
-| inactive | 비활성 쿼리만 |
-| all | 모든 매칭 쿼리 |
-| none | 무효화만, 재조회 안함 |
+| active | Refetch only active queries (default) |
+| inactive | Only inactive queries |
+| all | All matching queries |
+| none | Invalidate only, no refetch |
 
 </options>

package/templates/tanstack-start/docs/library/tanstack-query/optimistic-updates.md

@@ -3,7 +3,7 @@
 <patterns>
 
 ```tsx
-// 추가
+// Add
 useMutation({
   mutationFn: addTodo,
   onMutate: async (newTodo) => {
@@ -20,7 +20,7 @@ useMutation({
   },
 })
 
-// 삭제
+// Delete
 useMutation({
   mutationFn: deleteTodo,
   onMutate: async (todoId) => {
@@ -37,7 +37,7 @@ useMutation({
   onSettled: () => queryClient.invalidateQueries({ queryKey: ['todos'] }),
 })
 
-// 토글
+// Toggle
 useMutation({
   mutationFn: toggleTodo,
   onMutate: async (todoId) => {
@@ -56,7 +56,7 @@ useMutation({
   onSettled: () => queryClient.invalidateQueries({ queryKey: ['todos'] }),
 })
 
-// 단일 항목
+// Single item
 useMutation({
   mutationFn: updateTodo,
   onMutate: async (newTodo) => {