@kood/claude-code 0.2.5 → 0.3.0

package/templates/tanstack-start/docs/library/tanstack-start/auth-patterns.md

@@ -1,6 +1,6 @@
 # TanStack Start - 인증 패턴
 
-## 기본 인증 함수
+<patterns>
 
 ```typescript
 // 로그인
@@ -9,7 +9,6 @@ export const loginFn = createServerFn({ method: 'POST' })
   .handler(async ({ data }) => {
     const user = await authenticateUser(data.email, data.password)
     if (!user) return { error: 'Invalid credentials' }
-
     const session = await useAppSession()
     await session.update({ userId: user.id, email: user.email })
     throw redirect({ to: '/dashboard' })
@@ -30,11 +29,8 @@ export const getCurrentUserFn = createServerFn({ method: 'GET' })
     if (!session.data.userId) return null
     return getUserById(session.data.userId)
   })
-```
-
-## 인증 미들웨어
 
-```typescript
+// 인증 미들웨어
 export const authMiddleware = createMiddleware({ type: 'function' })
   .server(async ({ next }) => {
     const session = await useAppSession()
@@ -43,15 +39,12 @@ export const authMiddleware = createMiddleware({ type: 'function' })
     return next({ context: { user } })
   })
 
-// 사용
+// Server Function에 적용
 export const protectedFn = createServerFn({ method: 'GET' })
   .middleware([authMiddleware])
   .handler(async ({ context }) => ({ user: context.user }))
-```
 
-## 보호된 라우트
-
-```tsx
+// 보호된 라우트
 export const Route = createFileRoute('/dashboard')({
   beforeLoad: async () => {
     const user = await getCurrentUserFn()
@@ -63,11 +56,8 @@ export const Route = createFileRoute('/dashboard')({
     return <h1>Welcome, {user.name}!</h1>
   },
 })
-```
-
-## Better Auth 통합
 
-```typescript
+// Better Auth 통합
 export const auth = betterAuth({
   database: prismaAdapter(prisma),
   emailAndPassword: { enabled: true },
@@ -76,3 +66,5 @@ export const auth = betterAuth({
 export const getSession = createServerFn({ method: 'GET' })
   .handler(async ({ request }) => auth.api.getSession({ headers: request.headers }))
 ```
+
+</patterns>

package/templates/tanstack-start/docs/library/tanstack-start/routing.md

@@ -1,22 +1,17 @@
 # TanStack Start - Routing
 
-파일 기반 라우팅.
-
-## 기본 패턴
+<patterns>
 
 ```tsx
-// routes/about.tsx
-export const Route = createFileRoute('/about')({
-  component: AboutPage,
-})
+// 기본
+export const Route = createFileRoute('/about')({ component: AboutPage })
 
 // Loader
 export const Route = createFileRoute('/')({
   component: Page,
   loader: async () => fetch('/api/posts').then(r => r.json()),
 })
-
-function Page() {
+const Page = () => {
   const posts = Route.useLoaderData()
   return <ul>{posts.map(p => <li key={p.id}>{p.title}</li>)}</ul>
 }
@@ -29,19 +24,13 @@ export const Route = createFileRoute('/users/$id')({
     return <h1>{user.name}</h1>
   },
 })
-```
-
-## SSR 옵션
 
-```typescript
+// SSR 옵션
 ssr: true       // 전체 SSR (기본값)
 ssr: false      // 클라이언트만
-ssr: 'data-only' // 데이터만 서버, 렌더링은 클라이언트
-```
-
-## Server Routes (API)
+ssr: 'data-only' // 데이터만 서버
 
-```typescript
+// Server Routes (API)
 export const Route = createFileRoute('/api/hello')({
   server: {
     handlers: {
@@ -55,12 +44,16 @@ export const Route = createFileRoute('/api/hello')({
 })
 ```
 
-## 구조
+</patterns>
+
+<structure>
 
 ```
 routes/
-├── __root.tsx      → Root layout
-├── index.tsx       → /
-├── users/$id.tsx   → /users/:id
-├── $.tsx           → Catch-all (404)
+├── __root.tsx      # Root layout
+├── index.tsx       # /
+├── users/$id.tsx   # /users/:id
+├── $.tsx           # Catch-all (404)
 ```
+
+</structure>

package/templates/tanstack-start/docs/library/zod/complex-types.md

@@ -1,15 +1,15 @@
 # Zod - 복합 타입
 
-## 객체
+<patterns>
 
 ```typescript
+// 객체
 const UserSchema = z.object({
   name: z.string(),
   email: z.email(),
   age: z.number().optional(),
 })
 
-// 메서드
 UserSchema.partial()              // 모든 필드 optional
 UserSchema.required()             // 모든 필드 required
 UserSchema.pick({ name: true })   // 특정 필드만
@@ -17,57 +17,36 @@ UserSchema.omit({ email: true })  // 특정 필드 제외
 UserSchema.extend({ role: z.enum(['admin', 'user']) })
 UserSchema.merge(AnotherSchema)
 
-// v4 Strict/Loose
-z.strictObject({ name: z.string() })  // 추가 키 에러
-z.looseObject({ name: z.string() })   // 추가 키 통과
-```
-
-## 배열/튜플
+z.strictObject({ name: z.string() })  // v4: 추가 키 에러
+z.looseObject({ name: z.string() })   // v4: 추가 키 통과
 
-```typescript
+// 배열/튜플
 z.array(z.string())
 z.array(z.number()).min(1).max(10).length(5).nonempty()
-
 z.tuple([z.string(), z.number()])  // [string, number]
-```
 
-## 유니온
-
-```typescript
+// 유니온
 z.union([z.string(), z.number()])
 z.string().or(z.number())
 
-// Discriminated Union
 z.discriminatedUnion('type', [
   z.object({ type: z.literal('circle'), radius: z.number() }),
   z.object({ type: z.literal('rectangle'), width: z.number(), height: z.number() }),
 ])
-```
-
-## Enum
 
-```typescript
+// Enum
 const Status = z.enum(['pending', 'done', 'cancelled'])
 type Status = z.infer<typeof Status>  // 'pending' | 'done' | 'cancelled'
 
-// Native enum
 enum Fruits { Apple, Banana }
 z.nativeEnum(Fruits)
-```
-
-## Record/Map/Set
-
-```typescript
-z.record(z.string(), z.object({ name: z.string() }))
-// { [key: string]: { name: string } }
 
+// Record/Map/Set
+z.record(z.string(), z.object({ name: z.string() }))  // { [key: string]: { name: string } }
 z.map(z.string(), z.number())  // Map<string, number>
 z.set(z.number())              // Set<number>
-```
-
-## 재귀 스키마
 
-```typescript
+// 재귀
 type Json = string | number | boolean | null | { [key: string]: Json } | Json[]
 
 const jsonSchema: z.ZodType<Json> = z.lazy(() =>
@@ -78,3 +57,5 @@ const jsonSchema: z.ZodType<Json> = z.lazy(() =>
   ])
 )
 ```
+
+</patterns>

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

@@ -1,6 +1,6 @@
 # Zod
 
-> **v4** | TypeScript Schema Validation
+> v4 | TypeScript Schema Validation
 
 @complex-types.md
 @transforms.md
@@ -8,66 +8,49 @@
 
 ---
 
-## Quick Reference
+<quick_reference>
 
 ```typescript
-// 기본 스키마
+// 기본
 const schema = z.object({
-  email: z.email(),              // v4! (string().email() 아님)
+  email: z.email(),              // v4!
   name: z.string().min(1).trim(),
-  website: z.url().optional(),   // v4! (string().url() 아님)
+  website: z.url().optional(),   // v4!
   age: z.number().int().positive(),
 })
-
 type Input = z.infer<typeof schema>
 
-// 파싱
 schema.parse(data)              // 실패 시 throw
 schema.safeParse(data)          // { success, data/error }
 
-// TanStack Start 연동
+// TanStack Start
 export const createUser = createServerFn({ method: 'POST' })
   .inputValidator(schema)
   .handler(async ({ data }) => prisma.user.create({ data }))
 ```
 
-### ⚠️ v4 새 API
+</quick_reference>
+
+<v4_changes>
 
 ```typescript
-// ✅ v4
-z.email()          z.url()          z.uuid()
-z.iso.date()       z.iso.datetime()
+// ✅ v4 새 API
+z.email()  z.url()  z.uuid()
+z.iso.date()  z.iso.datetime()  z.iso.duration()
+z.stringbool()  // "true"/"yes"/"1" → true
 
 // ❌ v3 deprecated
 z.string().email()  z.string().url()
-```
 
-### v4 주요 변경
-
-```typescript
-// 에러 커스텀: message → error
-z.string().min(5, { error: "Too short." })
-
-// Strict/Loose 객체
+// 변경사항
+z.string().min(5, { error: "Too short." })  // message → error
 z.strictObject({ name: z.string() })  // 추가 키 에러
 z.looseObject({ name: z.string() })   // 추가 키 통과
-
-// Refinement 체이닝 가능
-z.string().refine(val => val.includes("@")).min(5)  // ✅ v4
-```
-
-### v4 추가 API
-
-```typescript
-// 문자열 불리언 (환경변수용)
-z.stringbool()  // "true"/"yes"/"1" → true
-
-// 날짜/시간 ISO 포맷
-z.iso.date()      // 2024-01-15
-z.iso.datetime()  // ISO 날짜시간
-z.iso.duration()  // P1D, PT1H
+z.string().refine(val => val.includes("@")).min(5)  // refinement 체이닝
 
 // 템플릿 리터럴
 const css = z.templateLiteral([z.number(), z.enum(["px", "em", "rem"])])
 // `${number}px` | `${number}em` | `${number}rem`
 ```
+
+</v4_changes>

package/templates/tanstack-start/docs/library/zod/transforms.md

@@ -1,29 +1,24 @@
 # Zod - 변환
 
-## Transform
+<patterns>
 
 ```typescript
+// Transform
 const stringToLength = z.string().transform((val) => val.length)
 stringToLength.parse('hello')  // => 5
 
 type In = z.input<typeof stringToLength>   // string
 type Out = z.output<typeof stringToLength> // number
-```
-
-## Pipe (검증 후 변환)
 
-```typescript
+// Pipe (검증 후 변환)
 const stringToNumber = z.string()
   .transform((val) => parseInt(val, 10))
   .pipe(z.number().min(0).max(100))
 
 stringToNumber.parse('50')  // => 50
 stringToNumber.parse('150') // throws
-```
-
-## Coerce (강제 변환)
 
-```typescript
+// Coerce (강제 변환)
 z.coerce.string()   // 모든 값 → 문자열
 z.coerce.number()   // 모든 값 → 숫자
 z.coerce.boolean()  // 모든 값 → 불리언
@@ -33,33 +28,24 @@ z.coerce.bigint()   // 모든 값 → BigInt
 z.coerce.number().parse("42")  // => 42
 z.coerce.date().parse("2021-01-01")  // => Date
 
-// ⚠️ v4: 입력 타입이 unknown으로 변경됨
+// v4: 입력 타입이 unknown으로 변경
 type In = z.input<typeof z.coerce.string()>  // unknown
-```
 
-### 환경변수 불리언 (v4 권장)
+// v4 환경변수 불리언
+z.stringbool()  // "true"/"yes"/"1" → true, "false"/"no"/"0" → false
 
-```typescript
-z.stringbool()  // "true"/"yes"/"1" → true
-                // "false"/"no"/"0" → false
-```
-
-## Preprocess
-
-```typescript
+// Preprocess
 const trimmed = z.preprocess(
   (val) => typeof val === 'string' ? val.trim() : val,
   z.string()
 )
-```
 
-## 입력/출력 타입 분리
-
-```typescript
+// 입력/출력 타입 분리
 const Schema = z.object({
   createdAt: z.string().transform((str) => new Date(str)),
 })
-
 type SchemaInput = z.input<typeof Schema>   // { createdAt: string }
 type SchemaOutput = z.output<typeof Schema> // { createdAt: Date }
 ```
+
+</patterns>

package/templates/tanstack-start/docs/library/zod/validation.md

@@ -1,25 +1,21 @@
 # Zod - 검증
 
-## Refinement
+<patterns>
 
 ```typescript
-// v4: message → error
+// Refinement (v4: message → error)
 const PasswordSchema = z.string()
   .min(8)
   .refine((val) => /[A-Z]/.test(val), { error: '대문자 필수' })
   .refine((val) => /[0-9]/.test(val), { error: '숫자 필수' })
 
-// v4: refinement 후 체이닝 가능
-z.string().refine(val => val.includes("@")).min(5)  // ✅
+z.string().refine(val => val.includes("@")).min(5)  // v4: refinement 후 체이닝
 
 // Async
 const schema = z.string().refine(async (val) => val.length <= 8)
 await schema.parseAsync('hello')
-```
-
-## Superrefine (고급)
 
-```typescript
+// Superrefine
 z.object({
   password: z.string(),
   confirmPassword: z.string(),
@@ -31,41 +27,25 @@ z.object({
       path: ['confirmPassword'],
     })
   }
-})
-// ⚠️ v4: ctx.path 사용 불가
-```
-
-## 커스텀 스키마
+})  // v4: ctx.path 사용 불가
 
-```typescript
+// 커스텀
 const px = z.custom<`${number}px`>((val) =>
   typeof val === 'string' && /^\d+px$/.test(val)
 )
-
 px.parse('42px')  // ✅
 px.parse('42vw')  // throws
-```
 
-## 에러 처리
-
-```typescript
+// 에러 처리
 const result = schema.safeParse(data)
-
 if (!result.success) {
   result.error.errors.forEach((err) => {
     console.log(err.path, err.message, err.code)
   })
-
-  // 평면화
-  const flat = result.error.flatten()
-  // { fieldErrors: { email: ['Invalid email'] } }
+  const flat = result.error.flatten()  // { fieldErrors: { email: ['Invalid email'] } }
 }
-```
 
-## TanStack Start 연동
-
-```typescript
-// Server Function
+// TanStack Start
 export const createUser = createServerFn({ method: 'POST' })
   .inputValidator(zodValidator(createUserSchema))
   .handler(async ({ data }) => prisma.user.create({ data }))
@@ -81,12 +61,10 @@ const env = z.object({
 const workspaceMiddleware = createMiddleware({ type: 'function' })
   .inputValidator(zodValidator(z.object({ workspaceId: z.string() })))
   .server(({ next, data }) => next())
-```
-
-## Zod Mini (v4 경량)
 
-```typescript
+// Zod Mini (v4)
 import * as z from "zod/mini"
-
 z.string().check(z.minLength(5), z.maxLength(10), z.trim())
 ```
+
+</patterns>

package/templates/.claude/agents/debug-detective.md

@@ -1,37 +0,0 @@
----
-name: debug-detective
-description: 디버깅 전문가. 버그 원인 분석 및 수정안 제시. "에러", "버그", "안돼" 요청 시 사용.
-model: inherit
-color: yellow
-tools: ["Read", "Grep", "Glob", "Bash"]
----
-
-You are a debugging specialist.
-
-## Responsibilities
-
-1. 에러 분석 - 스택 트레이스, 로그, 재현 조건
-2. 원인 추적 - 코드 흐름 따라 근본 원인 탐지
-3. 수정안 제시 - 최소 변경으로 해결
-
-## Process
-
-1. 증상 파악 (에러 메시지, 재현 단계)
-2. 가설 수립 (가능한 원인 목록)
-3. 코드 분석으로 가설 검증
-4. 근본 원인 수정
-
-## Common Patterns
-
-| 패턴 | 증상 | 확인 |
-|------|------|------|
-| Null Reference | TypeError | 옵셔널 체이닝 |
-| Race Condition | 간헐적 실패 | async/await |
-| Off-by-One | 잘못된 인덱스 | 반복문 경계 |
-| State Mutation | 예상외 변경 | 불변성 |
-
-## Rules
-
-- 추측 금지, 코드 근거 필수
-- 최소 변경 원칙
-- Before/After 코드 제시

package/templates/.claude/agents/test-writer.md

@@ -1,41 +0,0 @@
----
-name: test-writer
-description: 테스트 작성. 함수/컴포넌트 테스트 생성. "테스트 추가", "테스트 작성" 요청 시 사용.
-model: inherit
-color: green
-tools: ["Read", "Write", "Grep", "Glob"]
----
-
-You are a testing specialist.
-
-## Responsibilities
-
-1. 유닛 테스트 - 함수, 클래스 단위
-2. 통합 테스트 - API, 서비스 상호작용
-3. 엣지 케이스 - 경계값, 에러, 빈 입력
-
-## Process
-
-1. 대상 코드 분석 (입력/출력, 의존성)
-2. 테스트 케이스 도출 (정상, 엣지, 에러)
-3. 프로젝트 테스트 패턴 확인
-4. 테스트 코드 작성
-
-## Coverage Priority
-
-| 우선순위 | 케이스 |
-|----------|--------|
-| 필수 | happy path |
-| 필수 | 에러 핸들링 |
-| 권장 | 경계값 |
-| 권장 | null/undefined |
-
-## Structure
-
-```typescript
-describe('[대상]', () => {
-  it('should [동작] when [조건]', () => {
-    // Arrange → Act → Assert
-  });
-});
-```