@kood/claude-code 0.2.2 → 0.2.4

package/dist/index.js

@@ -404,7 +404,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.2.2");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.2.4");
 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.2.2",
+  "version": "0.2.4",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

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

@@ -2,6 +2,19 @@
 
 TanStack Start 애플리케이션 아키텍처 가이드.
 
+## 목차
+
+- [System Overview](#system-overview)
+- [Layer Architecture](#layer-architecture)
+  - [Routes Layer](#1-routes-layer)
+  - [Services Layer](#2-services-layer)
+  - [Server Functions Layer](#3-server-functions-layer)
+  - [Database Layer](#4-database-layer)
+- [Data Flow](#data-flow)
+- [Technology Stack](#technology-stack)
+
+---
+
 ## System Overview
 
 ```
@@ -39,12 +52,110 @@ TanStack Start 애플리케이션 아키텍처 가이드.
 
 ```
 routes/<route-name>/
-├── index.tsx              # 페이지 컴포넌트
+├── (main)/                # route group (목록 페이지)
+│   ├── index.tsx          # 페이지 컴포넌트
+│   ├── -components/       # 페이지 전용 컴포넌트
+│   ├── -sections/         # UI 섹션 분리 (200줄+ 페이지)
+│   ├── -tabs/             # 탭 콘텐츠 분리
+│   ├── -hooks/            # 페이지 전용 훅
+│   └── -utils/            # 상수, 헬퍼
+├── new/                   # 생성 페이지 (route group 외부)
+│   └── index.tsx
 ├── route.tsx              # route 설정 (loader, beforeLoad)
-├── -functions/            # 페이지 전용 서버 함수
-├── -components/           # 페이지 전용 컴포넌트
-├── -sections/             # 섹션 분리
-└── -hooks/                # 페이지 전용 훅
+└── -functions/            # 페이지 전용 서버 함수
+```
+
+#### Route Group 패턴 `(main)`
+
+목록 페이지는 반드시 `(main)` route group으로 감싸야 한다:
+
+```
+routes/dashboard/companies/
+├── (main)/                # /dashboard/companies (목록)
+│   ├── index.tsx
+│   └── -components/
+└── new/                   # /dashboard/companies/new (생성)
+    └── index.tsx
+```
+
+**규칙:**
+- 목록 페이지 → `(main)/` 내부
+- 생성/편집 페이지 → `(main)/` 외부
+- URL에 `(main)`은 포함되지 않음
+
+#### 페이지 크기 기준
+
+| 줄 수 | 권장 조치 |
+|-------|----------|
+| ~100줄 | 단일 파일 OK |
+| 100-200줄 | -components 분리 검토 |
+| 200줄+ | -sections 분리 필수 |
+| 탭 UI | -tabs 분리 권장 |
+
+#### `-sections/` 패턴 (200줄+ 페이지)
+
+큰 페이지는 논리적 섹션으로 분리:
+
+```tsx
+// routes/settings/(main)/index.tsx
+import { GeneralSection } from './-sections/general-section'
+import { SecuritySection } from './-sections/security-section'
+import { NotificationSection } from './-sections/notification-section'
+
+function SettingsPage() {
+  return (
+    <div className="space-y-8">
+      <GeneralSection />
+      <SecuritySection />
+      <NotificationSection />
+    </div>
+  )
+}
+```
+
+```
+routes/settings/(main)/
+├── index.tsx
+└── -sections/
+    ├── general-section.tsx
+    ├── security-section.tsx
+    └── notification-section.tsx
+```
+
+#### `-tabs/` 패턴 (탭 UI)
+
+탭 기반 페이지는 각 탭을 별도 파일로 분리:
+
+```tsx
+// routes/project-settings/(main)/index.tsx
+import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs'
+import { GeneralTab } from './-tabs/general-tab'
+import { MembersTab } from './-tabs/members-tab'
+import { DangerTab } from './-tabs/danger-tab'
+
+function ProjectSettingsPage() {
+  return (
+    <Tabs defaultValue="general">
+      <TabsList>
+        <TabsTrigger value="general">일반</TabsTrigger>
+        <TabsTrigger value="members">멤버</TabsTrigger>
+        <TabsTrigger value="danger">위험</TabsTrigger>
+      </TabsList>
+      <TabsContent value="general"><GeneralTab /></TabsContent>
+      <TabsContent value="members"><MembersTab /></TabsContent>
+      <TabsContent value="danger"><DangerTab /></TabsContent>
+    </Tabs>
+  )
+}
+```
+
+```
+routes/project-settings/(main)/
+├── index.tsx
+└── -tabs/
+    ├── general-tab.tsx
+    ├── members-tab.tsx
+    └── danger-tab.tsx
 ```
 
 ### 2. Services Layer
@@ -129,4 +240,4 @@ Form Submit → useMutation → Server Function (POST)
 - [conventions.md](../guides/conventions.md) - 코드 컨벤션
 - [routes.md](../guides/routes.md) - 라우트 구조
 - [hooks.md](../guides/hooks.md) - Custom Hook 패턴
-- [services.md](../guides/services.md) - Service Layer
+- [services.md](../guides/services.md) - Service Layer

package/templates/tanstack-start/docs/library/drizzle/cloudflare-d1.md

@@ -79,6 +79,7 @@ export default {
 import { createServerFn } from '@tanstack/react-start'
 import { drizzle } from 'drizzle-orm/d1'
 import { eq } from 'drizzle-orm'
+import { z } from 'zod'
 import * as schema from '@/db/schema'
 
 // D1 바인딩 접근 (Cloudflare Pages/Workers)
@@ -94,7 +95,7 @@ export const getUsers = createServerFn({ method: 'GET' })
   })
 
 export const createUser = createServerFn({ method: 'POST' })
-  .validator((data: { email: string; name?: string }) => data)
+  .inputValidator(z.object({ email: z.email(), name: z.string().optional() }))
   .handler(async ({ data }) => {
     const db = getDb()
     const [user] = await db.insert(schema.users).values(data).returning()

package/templates/tanstack-start/docs/library/drizzle/setup.md

@@ -64,6 +64,7 @@ import { createServerFn } from '@tanstack/react-start'
 import { db } from '@/lib/db'
 import { users } from '@/db/schema'
 import { eq } from 'drizzle-orm'
+import { z } from 'zod'
 
 export const getUsers = createServerFn({ method: 'GET' })
   .handler(async () => {
@@ -71,14 +72,14 @@ export const getUsers = createServerFn({ method: 'GET' })
   })
 
 export const getUserById = createServerFn({ method: 'GET' })
-  .validator((id: number) => id)
+  .inputValidator(z.coerce.number())
   .handler(async ({ data: id }) => {
     const [user] = await db.select().from(users).where(eq(users.id, id))
     return user
   })
 
 export const createUser = createServerFn({ method: 'POST' })
-  .validator((data: { email: string; name: string }) => data)
+  .inputValidator(z.object({ email: z.email(), name: z.string() }))
   .handler(async ({ data }) => {
     const [user] = await db.insert(users).values(data).returning()
     return user

package/templates/tanstack-start/docs/library/tanstack-start/server-functions.md

@@ -21,7 +21,7 @@ const createUserSchema = z.object({
 })
 
 export const createUser = createServerFn({ method: 'POST' })
-  .inputValidator(zodValidator(createUserSchema))
+  .inputValidator(createUserSchema)
   .handler(async ({ data }) => prisma.user.create({ data }))
 ```