@kood/claude-code 0.3.6 → 0.3.8

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

@@ -1,6 +1,6 @@
-# 라우트 구조
+# Route Structure
 
-> TanStack Start 파일 기반 라우팅
+> TanStack Start File-Based Routing
 
 <instructions>
 @../library/tanstack-router/index.md
@@ -10,7 +10,7 @@
 
 <route_structure>
 
-## 라우트 폴더 구조
+## Route Folder Structure
 
 ```
 routes/
@@ -19,19 +19,28 @@ routes/
 ├── users/
 │   ├── index.tsx        # /users (List)
 │   ├── $id.tsx          # /users/:id (Detail)
-│   ├── -components/     # 페이지 전용 컴포넌트
-│   ├── -sections/       # 섹션 분리 (복잡한 경우)
-│   └── -hooks/          # 페이지 전용 Hook
+│   ├── -components/     # Page-specific components (required)
+│   ├── -hooks/          # Page-specific Hooks (required)
+│   ├── -functions/      # Page-specific Server Functions (required)
+│   └── -sections/       # Section separation (optional, complex pages only)
 └── posts/
     ├── index.tsx
-    └── $slug.tsx
+    ├── $slug.tsx
+    ├── -components/     # Required
+    ├── -hooks/          # Required
+    └── -functions/      # Required
 ```
 
-| 접두사 | 용도 | 라우트 생성 |
-|--------|------|-----------|
-| `-` | 라우트 제외 폴더 | ❌ 제외 |
-| `$` | 동적 파라미터 | ✅ 생성 |
-| `_` | Pathless Layout | ✅ 생성 (경로 없음) |
+| Prefix | Purpose | Route Generation |
+|--------|---------|------------------|
+| `-` | Exclude from routes | ❌ Excluded |
+| `$` | Dynamic parameters | ✅ Generated |
+| `_` | Pathless Layout | ✅ Generated (no path) |
+
+**⚠️ 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)
 
 </route_structure>
 
@@ -39,17 +48,17 @@ routes/
 
 <file_naming>
 
-## 라우트 파일명 규칙
+## Route File Naming Rules
 
-| 경로 | 파일명 | 설명 |
-|------|--------|------|
-| `/` | `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` | 경로 없는 레이아웃 |
+| 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 |
 
 </file_naming>
 
@@ -57,7 +66,7 @@ routes/
 
 <patterns>
 
-## 기본 라우트 패턴
+## Basic Route Pattern
 
 ```tsx
 // routes/users/index.tsx
@@ -80,7 +89,7 @@ const UsersPage = (): JSX.Element => {
 }
 ```
 
-## 동적 라우트 + Loader
+## Dynamic Route + Loader
 
 ```tsx
 // routes/users/$id.tsx
@@ -179,7 +188,7 @@ const DashboardPage = (): JSX.Element => {
 }
 ```
 
-## Section 패턴
+## Section Pattern
 
 ```tsx
 // routes/users/-sections/user-list-section.tsx
@@ -208,7 +217,7 @@ export const UserListSection = (): JSX.Element => {
 }
 ```
 
-## 컴포넌트 패턴
+## Component Pattern
 
 ```tsx
 // routes/users/-components/user-card.tsx
@@ -257,37 +266,47 @@ export const UserCard = ({
 
 ---
 
-<page_size_rules>
+<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
+
+**Optional:**
+- `-sections/`: Use only for complex pages (200+ lines)
 
-| 페이지 크기 | 구조 | 예시 |
-|------------|------|------|
-| ~100줄 | 단일 파일 | 간단한 페이지, 폼 |
-| 100-200줄 | `-components/` 분리 | 목록 + 필터 |
-| 200줄+ | `-sections/` + `-components/` | 대시보드, 복잡한 UI |
+| Page Size | Required | Optional |
+|-----------|----------|----------|
+| ~100 lines | `-components/`, `-hooks/`, `-functions/` | - |
+| 100-200 lines | `-components/`, `-hooks/`, `-functions/` | - |
+| 200+ lines | `-components/`, `-hooks/`, `-functions/` | `-sections/` |
 
-</page_size_rules>
+</folder_structure_rules>
 
 ---
 
 <loader_execution>
 
-## Loader 실행 순서
+## Loader Execution Order
 
-| 단계 | 실행 방식 | 설명 |
-|------|----------|------|
-| 1. `beforeLoad` | 순차 (outermost → innermost) | 인증 체크, 컨텍스트 설정 |
-| 2. `loader` | 병렬 (모든 loader 동시) | 데이터 페칭 |
+| Step | Execution | Description |
+|------|-----------|-------------|
+| 1. `beforeLoad` | Sequential (outermost → innermost) | Auth check, context setup |
+| 2. `loader` | Parallel (all loaders simultaneously) | Data fetching |
 
 ```tsx
 // Parent Route
 export const Route = createFileRoute('/dashboard')({
   beforeLoad: async () => {
-    // 1. 먼저 실행 (순차)
+    // 1. Runs first (sequential)
     const auth = await checkAuth()
     return { auth }
   },
   loader: async () => {
-    // 2. 나중에 실행 (병렬)
+    // 2. Runs later (parallel)
     return getDashboardData()
   },
 })
@@ -295,11 +314,11 @@ export const Route = createFileRoute('/dashboard')({
 // Child Route
 export const Route = createFileRoute('/dashboard/users')({
   beforeLoad: async () => {
-    // 1. Parent beforeLoad 다음 실행
+    // 1. Runs after Parent beforeLoad
     return {}
   },
   loader: async () => {
-    // 2. Parent loader와 병렬 실행
+    // 2. Runs in parallel with Parent loader
     return getUsers()
   },
 })

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

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