@kood/claude-code 0.3.1 → 0.3.2

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.2");
 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.2",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

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

@@ -19,6 +19,7 @@
 | **레이어** | Service Layer 건너뛰기, Routes에서 직접 DB 접근 |
 | **검증** | Handler 내부 수동 검증, 인증 로직 분산 |
 | **Server Fn** | `createServerFn` 사용 (명시 요청 없으면 `createServerOnlyFn`) |
+| **Barrel Export** | `functions/index.ts` 생성 (Tree Shaking 실패, 서버 라이브러리 Client 오염) |
 
 </forbidden>
 
@@ -144,7 +145,6 @@ services/<domain>/
 
 ```
 functions/                    # 글로벌 (재사용)
-├── index.ts
 ├── <function-name>.ts        # 파일당 하나
 └── middlewares/
     └── <middleware-name>.ts
@@ -153,6 +153,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

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>