@kood/claude-code 0.3.7 → 0.3.8

package/templates/nextjs/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. **Use Multi-File structure**
+2. **Add comments to 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
 ```
 
-## 예시
+## Example
 
 ```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[]            // authored posts (1:N)
+  profile   Profile?          // user 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 {
 }
 ```
 
-## 기타
+## Others
 
 ```prisma
-// 선택적 관계
+// Optional relation
 author   User? @relation(fields: [authorId], references: [id])
 authorId Int?
 
-// 인덱스
+// Index
 @@index([authorId])
 @@index([createdAt])
 
-// 복합 키
+// Composite key
 @@id([postId, tagId])
 
-// 매핑
+// Mapping
 @map("user_id")
 @@map("users")
 ```

package/templates/nextjs/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/nextjs/docs/library/prisma/transactions.md

@@ -1,8 +1,8 @@
-# Prisma - 트랜잭션
+# Prisma - Transactions
 
-## 배열 기반 트랜잭션
+## Array-based Transaction
 
-하나라도 실패하면 모두 롤백.
+Rolls back all if any operation 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 Transaction
 
-복잡한 로직, 조건부 처리.
+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,              // maximum 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/nextjs/docs/library/tanstack-query/index.md

@@ -40,12 +40,12 @@ const mutation = useMutation({
   },
 })
 
-// 설정
+// Setup
 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 parameter
+['todos', 'list', { filters }]  // hierarchical
 ```
 
 </quick_reference>

package/templates/nextjs/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 matching
+queryClient.invalidateQueries({ queryKey: ['todos', 'list'], exact: true })  // exact matching
 
-// 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 | 설명 |
-|-------------|------|
-| active | 렌더링 중인 쿼리만 재조회 (기본) |
-| inactive | 비활성 쿼리만 |
-| all | 모든 매칭 쿼리 |
-| none | 무효화만, 재조회 안함 |
+| refetchType | Description |
+|-------------|-------------|
+| active | Refetch only queries currently being rendered (default) |
+| inactive | Refetch only inactive queries |
+| all | Refetch all matching queries |
+| none | Invalidate only, no refetch |
 
 </options>

package/templates/nextjs/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) => {

package/templates/nextjs/docs/library/tanstack-query/use-mutation.md

@@ -3,7 +3,7 @@
 <patterns>
 
 ```tsx
-// 기본
+// Basic
 const queryClient = useQueryClient()
 const mutation = useMutation({
   mutationFn: postTodo,
@@ -11,12 +11,12 @@ const mutation = useMutation({
 })
 mutation.mutate({ title: 'New Todo' })
 
-// 콜백
+// Callbacks
 useMutation({
   mutationFn: updateTodo,
   onMutate: async (newTodo) => {
-    // mutation 시작 전 (optimistic update용)
-    return { previousData }  // context로 전달
+    // before mutation starts (for optimistic updates)
+    return { previousData }  // passed to context
   },
   onSuccess: (data, variables, context) => {},
   onError: (error, variables, context) => {},
@@ -35,7 +35,7 @@ try {
   const result = await mutation.mutateAsync(data)
 } catch (error) { ... }
 
-// 캐시 업데이트
+// Cache update
 useMutation({
   mutationFn: patchTodo,
   onSuccess: (data) => {
@@ -49,15 +49,15 @@ useMutation({
 
 <returns>
 
-| 속성 | 설명 |
-|------|------|
-| data | mutation 결과 |
-| error | 에러 객체 |
-| isPending | 실행 중 |
-| isSuccess/isError | 상태 |
-| mutate | 실행 (비동기) |
-| mutateAsync | 실행 (Promise) |
-| reset | 상태 초기화 |
-| variables | 전달된 변수 |
+| Property | Description |
+|----------|-------------|
+| data | Mutation result |
+| error | Error object |
+| isPending | Execution in progress |
+| isSuccess/isError | Status flags |
+| mutate | Execute (async) |
+| mutateAsync | Execute (Promise) |
+| reset | Reset state |
+| variables | Passed variables |
 
 </returns>

package/templates/nextjs/docs/library/tanstack-query/use-query.md

@@ -3,7 +3,7 @@
 <patterns>
 
 ```tsx
-// 기본
+// Basic
 const { data, isLoading, error } = useQuery({
   queryKey: ['todos'],
   queryFn: getTodos,
@@ -11,28 +11,28 @@ const { data, isLoading, error } = useQuery({
 if (isLoading) return <div>Loading...</div>
 if (error) return <div>Error: {error.message}</div>
 
-// 옵션
+// Options
 useQuery({
   queryKey: ['todos'],
   queryFn: fetchTodos,
-  staleTime: 1000 * 60 * 5,      // fresh 유지 시간
-  gcTime: 1000 * 60 * 30,        // 가비지 컬렉션 시간
-  refetchOnWindowFocus: true,    // 포커스 시 리페치
-  refetchInterval: 1000 * 60,    // 자동 리페치 간격
-  retry: 3,                      // 재시도 횟수
-  enabled: !!userId,             // 조건부 실행
-  initialData: [],               // 초기 데이터
-  select: (data) => data.filter(t => t.done),  // 데이터 변환
+  staleTime: 1000 * 60 * 5,      // time to keep data fresh
+  gcTime: 1000 * 60 * 30,        // garbage collection time
+  refetchOnWindowFocus: true,    // refetch on window focus
+  refetchInterval: 1000 * 60,    // auto-refetch interval
+  retry: 3,                      // retry attempts
+  enabled: !!userId,             // conditional execution
+  initialData: [],               // initial data
+  select: (data) => data.filter(t => t.done),  // data transformation
 })
 
-// 파라미터
+// With parameter
 useQuery({
   queryKey: ['todo', todoId],
   queryFn: () => fetchTodoById(todoId),
   enabled: !!todoId,
 })
 
-// 의존적 쿼리
+// Dependent queries
 const { data: user } = useQuery({ queryKey: ['user', userId], queryFn: ... })
 const { data: posts } = useQuery({
   queryKey: ['posts', user?.id],
@@ -40,11 +40,11 @@ const { data: posts } = useQuery({
   enabled: !!user?.id,
 })
 
-// 병렬
+// Parallel
 const usersQuery = useQuery({ queryKey: ['users'], queryFn: fetchUsers })
 const postsQuery = useQuery({ queryKey: ['posts'], queryFn: fetchPosts })
 
-// 동적 병렬
+// Dynamic parallel
 const userQueries = useQueries({
   queries: userIds.map((id) => ({
     queryKey: ['user', id],
@@ -57,14 +57,14 @@ const userQueries = useQueries({
 
 <returns>
 
-| 속성 | 설명 |
-|------|------|
-| data | 쿼리 결과 |
-| error | 에러 객체 |
-| isLoading | 첫 로딩 중 |
-| isFetching | 백그라운드 페칭 중 |
-| isError/isSuccess | 상태 |
-| refetch | 수동 리페치 |
+| Property | Description |
+|----------|-------------|
+| data | Query result |
+| error | Error object |
+| isLoading | First loading state |
+| isFetching | Background fetching state |
+| isError/isSuccess | Status flags |
+| refetch | Manual refetch function |
 | status | 'pending' \| 'error' \| 'success' |
 
 </returns>

package/templates/nextjs/docs/library/zod/complex-types.md

@@ -1,31 +1,31 @@
-# Zod - 복합 타입
+# Zod - Complex Types
 
 <patterns>
 
 ```typescript
-// 객체
+// Object
 const UserSchema = z.object({
   name: z.string(),
   email: z.email(),
   age: z.number().optional(),
 })
 
-UserSchema.partial()              // 모든 필드 optional
-UserSchema.required()             // 모든 필드 required
-UserSchema.pick({ name: true })   // 특정 필드만
-UserSchema.omit({ email: true })  // 특정 필드 제외
+UserSchema.partial()              // all fields optional
+UserSchema.required()             // all fields required
+UserSchema.pick({ name: true })   // specific fields only
+UserSchema.omit({ email: true })  // exclude specific fields
 UserSchema.extend({ role: z.enum(['admin', 'user']) })
 UserSchema.merge(AnotherSchema)
 
-z.strictObject({ name: z.string() })  // v4: 추가 키 에러
-z.looseObject({ name: z.string() })   // v4: 추가 키 통과
+z.strictObject({ name: z.string() })  // v4: additional keys throw error
+z.looseObject({ name: z.string() })   // v4: additional keys pass through
 
-// 배열/튜플
+// Array/Tuple
 z.array(z.string())
 z.array(z.number()).min(1).max(10).length(5).nonempty()
 z.tuple([z.string(), z.number()])  // [string, number]
 
-// 유니온
+// Union
 z.union([z.string(), z.number()])
 z.string().or(z.number())
 
@@ -46,7 +46,7 @@ z.record(z.string(), z.object({ name: z.string() }))  // { [key: string]: { name
 z.map(z.string(), z.number())  // Map<string, number>
 z.set(z.number())              // Set<number>
 
-// 재귀
+// Recursive
 type Json = string | number | boolean | null | { [key: string]: Json } | Json[]
 
 const jsonSchema: z.ZodType<Json> = z.lazy(() =>

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

@@ -11,7 +11,7 @@
 <quick_reference>
 
 ```typescript
-// 기본
+// Basic
 const schema = z.object({
   email: z.email(),              // v4!
   name: z.string().min(1).trim(),
@@ -20,7 +20,7 @@ const schema = z.object({
 })
 type Input = z.infer<typeof schema>
 
-schema.parse(data)              // 실패 시 throw
+schema.parse(data)              // throws on failure
 schema.safeParse(data)          // { success, data/error }
 
 // TanStack Start
@@ -34,7 +34,7 @@ export const createUser = createServerFn({ method: 'POST' })
 <v4_changes>
 
 ```typescript
-// ✅ v4 새 API
+// ✅ v4 new APIs
 z.email()  z.url()  z.uuid()
 z.iso.date()  z.iso.datetime()  z.iso.duration()
 z.stringbool()  // "true"/"yes"/"1" → true
@@ -42,13 +42,13 @@ z.stringbool()  // "true"/"yes"/"1" → true
 // ❌ v3 deprecated
 z.string().email()  z.string().url()
 
-// 변경사항
+// Changes
 z.string().min(5, { error: "Too short." })  // message → error
-z.strictObject({ name: z.string() })  // 추가 키 에러
-z.looseObject({ name: z.string() })   // 추가 키 통과
-z.string().refine(val => val.includes("@")).min(5)  // refinement 체이닝
+z.strictObject({ name: z.string() })  // additional keys throw error
+z.looseObject({ name: z.string() })   // additional keys pass through
+z.string().refine(val => val.includes("@")).min(5)  // refinement chaining
 
-// 템플릿 리터럴
+// Template literals
 const css = z.templateLiteral([z.number(), z.enum(["px", "em", "rem"])])
 // `${number}px` | `${number}em` | `${number}rem`
 ```

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

@@ -1,4 +1,4 @@
-# Zod - 변환
+# Zod - Transforms
 
 <patterns>
 
@@ -10,7 +10,7 @@ stringToLength.parse('hello')  // => 5
 type In = z.input<typeof stringToLength>   // string
 type Out = z.output<typeof stringToLength> // number
 
-// Pipe (검증 후 변환)
+// Pipe (validate then transform)
 const stringToNumber = z.string()
   .transform((val) => parseInt(val, 10))
   .pipe(z.number().min(0).max(100))
@@ -18,20 +18,20 @@ const stringToNumber = z.string()
 stringToNumber.parse('50')  // => 50
 stringToNumber.parse('150') // throws
 
-// Coerce (강제 변환)
-z.coerce.string()   // 모든 값 → 문자열
-z.coerce.number()   // 모든 값 → 숫자
-z.coerce.boolean()  // 모든 값 → 불리언
-z.coerce.date()     // 모든 값 → 날짜
-z.coerce.bigint()   // 모든 값 → BigInt
+// Coerce (force conversion)
+z.coerce.string()   // any value → string
+z.coerce.number()   // any value → number
+z.coerce.boolean()  // any value → boolean
+z.coerce.date()     // any value → date
+z.coerce.bigint()   // any value → BigInt
 
 z.coerce.number().parse("42")  // => 42
 z.coerce.date().parse("2021-01-01")  // => Date
 
-// v4: 입력 타입이 unknown으로 변경
+// v4: input type changed to unknown
 type In = z.input<typeof z.coerce.string()>  // unknown
 
-// v4 환경변수 불리언
+// v4 environment variable boolean
 z.stringbool()  // "true"/"yes"/"1" → true, "false"/"no"/"0" → false
 
 // Preprocess
@@ -40,7 +40,7 @@ const trimmed = z.preprocess(
   z.string()
 )
 
-// 입력/출력 타입 분리
+// Separate input/output types
 const Schema = z.object({
   createdAt: z.string().transform((str) => new Date(str)),
 })