@kood/claude-code 0.3.1 → 0.3.3

package/dist/index.js

@@ -409,7 +409,7 @@ var init = async (options) => {
 
 // src/index.ts
 var program = new Command();
-program.name("claude-code").description("Claude Code documentation installer for projects").version("0.3.1");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.3.3");
 program.option(
   "-t, --template <names>",
   "template names (comma-separated: tanstack-start,hono)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kood/claude-code",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/tanstack-start/docs/architecture.md

@@ -18,7 +18,7 @@
 | **API** | `/api` 라우터 생성 (Server Functions 사용) |
 | **레이어** | Service Layer 건너뛰기, Routes에서 직접 DB 접근 |
 | **검증** | Handler 내부 수동 검증, 인증 로직 분산 |
-| **Server Fn** | `createServerFn` 사용 (명시 요청 없으면 `createServerOnlyFn`) |
+| **Barrel Export** | `functions/index.ts` 생성 (Tree Shaking 실패, 서버 라이브러리 Client 오염) |
 
 </forbidden>
 
@@ -33,7 +33,7 @@
 | **페이지 분리** | 100줄+ → `-components`, 200줄+ → `-sections` |
 | **beforeLoad** | 인증 체크, Context 전달, 리다이렉트 |
 | **loader** | 데이터 로딩 (beforeLoad 완료 후 병렬 실행) |
-| **Server Fn** | `createServerOnlyFn` 기본 사용 |
+| **Server Fn** | `createServerFn` 기본 사용 |
 | **검증** | `inputValidator` (POST/PUT/PATCH), Zod 스키마 |
 | **인증** | `middleware` (authMiddleware) |
 | **에러 처리** | `errorComponent` (라우트), `notFoundComponent` (404) |
@@ -144,7 +144,6 @@ services/<domain>/
 
 ```
 functions/                    # 글로벌 (재사용)
-├── index.ts
 ├── <function-name>.ts        # 파일당 하나
 └── middlewares/
     └── <middleware-name>.ts
@@ -153,6 +152,24 @@ routes/<route>/-functions/    # 페이지 전용
 └── <function-name>.ts
 ```
 
+> ⚠️ **`functions/index.ts` 생성 금지**
+>
+> `functions/` 폴더에 `index.ts` (barrel export) 파일을 만들지 마세요.
+>
+> **문제점:**
+> 1. **Tree Shaking 실패** - 번들러가 사용하지 않는 함수도 포함
+> 2. **Client 번들 오염** - `pg`, `prisma` 등 서버 전용 라이브러리가 클라이언트에 import되어 빌드 에러 발생
+>
+> ```typescript
+> // ❌ functions/index.ts 만들지 말 것
+> export * from './get-users'
+> export * from './create-post'  // pg import → 클라이언트 빌드 실패
+>
+> // ✅ 개별 파일에서 직접 import
+> import { getUsers } from '@/functions/get-users'
+> import { createPost } from '@/functions/create-post'
+> ```
+
 ### 4. Database Layer
 
 ```typescript
@@ -282,7 +299,7 @@ const { data } = useQuery({
 })
 
 // Server Function
-export const getUsers = createServerOnlyFn()
+export const getUsers = createServerFn()
   .middleware([authMiddleware])
   .handler(async () => prisma.user.findMany())
 ```
@@ -309,7 +326,7 @@ const mutation = useMutation({
 })
 
 // Server Function
-export const createUser = createServerOnlyFn({ method: 'POST' })
+export const createUser = createServerFn({ method: 'POST' })
   .middleware([authMiddleware])
   .inputValidator(createUserSchema)
   .handler(async ({ data }) => prisma.user.create({ data }))
@@ -327,12 +344,11 @@ export const createUser = createServerOnlyFn({ method: 'POST' })
 
 | 타입 | 실행 위치 | 사용 시나리오 |
 |------|----------|-------------|
-| **createServerOnlyFn** | 서버 | DB 접근, 비밀키 (기본) |
-| createServerFn | 서버 (RPC) | 일반 서버 로직 |
+| **createServerFn** | 서버 | DB 접근, 비밀키, 서버 로직 (기본) |
 | createClientOnlyFn | 클라이언트 | localStorage, window |
 | createIsomorphicFn | 양쪽 | 환경별 구현 |
 
-**기본 규칙**: 별도 요청 없으면 `createServerOnlyFn` 사용
+**기본 규칙**: 별도 요청 없으면 `createServerFn` 사용
 
 ### Middleware 패턴
 
@@ -346,7 +362,7 @@ export const authMiddleware = createMiddleware()
   })
 
 // 2. 사용
-export const createPost = createServerOnlyFn({ method: 'POST' })
+export const createPost = createServerFn({ method: 'POST' })
   .middleware([authMiddleware])
   .inputValidator(createPostSchema)
   .handler(async ({ data, context }) => {

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

@@ -8,12 +8,20 @@
 
 ## 파일 네이밍
 
+> ⚠️ **camelCase 파일명 금지** - 모든 파일명은 **kebab-case** 사용
+
 | 타입 | 규칙 | 예시 |
 |------|------|------|
 | **일반 파일** | kebab-case | `user-profile.tsx`, `auth-service.ts` |
 | **Route 파일** | TanStack Router 규칙 | `__root.tsx`, `index.tsx`, `$id.tsx` |
-| **Hook 파일** | `use-` 접두사 | `use-user-filter.ts`, `use-auth.ts` |
-| **Component** | PascalCase (파일은 kebab) | `UserCard` in `user-card.tsx` |
+| **Hook 파일** | `use-` 접두사 + kebab-case | `use-user-filter.ts`, `use-auth.ts` |
+| **Component** | PascalCase 컴포넌트, kebab-case 파일 | `UserCard` in `user-card.tsx` |
+| **Server Function** | kebab-case | `get-users.ts`, `create-post.ts` |
+
+```
+❌ camelCase 금지: getUserById.ts, authService.ts, useUserFilter.ts
+✅ kebab-case 필수: get-user-by-id.ts, auth-service.ts, use-user-filter.ts
+```
 
 </naming>