@kood/claude-code 0.3.4 → 0.3.6

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

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

@@ -15,6 +15,8 @@
 
 | 분류 | 금지 |
 |------|------|
+| **라우트** | Flat 파일 라우트 (`routes/users.tsx`) |
+| **Route Export** | `export const IndexRoute`, `const Route` (export 안함) |
 | **API** | `/api` 라우터 생성 (Server Functions 사용) |
 | **레이어** | Service Layer 건너뛰기, Routes에서 직접 DB 접근 |
 | **검증** | Handler 내부 수동 검증, 인증 로직 분산 |
@@ -28,6 +30,8 @@
 
 | 분류 | 필수 |
 |------|------|
+| **라우트 구조** | 페이지마다 폴더 생성 (`routes/users/index.tsx`) |
+| **Route Export** | `export const Route = createFileRoute(...)` 필수 |
 | **계층 구조** | Routes → Server Functions → Services → Database |
 | **Route Group** | 목록 → `(main)/`, 생성/편집 → 외부 |
 | **페이지 분리** | 100줄+ → `-components`, 200줄+ → `-sections` |
@@ -80,12 +84,60 @@
 
 ---
 
+<route_export_rule>
+
+## Route Export 규칙
+
+> ⚠️ **`export const Route` 필수**
+>
+> TanStack Router는 모든 라우트 파일에서 **정확히 `Route`라는 이름**으로 내보내야 합니다.
+>
+> `tsr generate` 및 `tsr watch` 명령어가 자동으로 경로를 생성하고 업데이트합니다.
+
+| ❌ 금지 | ✅ 필수 |
+|--------|--------|
+| `const Route = createFileRoute(...)` | `export const Route = createFileRoute(...)` |
+| `export const IndexRoute = ...` | `export const Route = ...` |
+| `export default createFileRoute(...)` | `export const Route = createFileRoute(...)` |
+
+```typescript
+// ❌ 금지: export 없음
+const Route = createFileRoute('/users')({
+  component: UsersPage,
+})
+
+// ❌ 금지: 다른 이름
+export const UsersRoute = createFileRoute('/users')({
+  component: UsersPage,
+})
+
+// ✅ 필수: 정확히 'Route' 이름으로 export
+export const Route = createFileRoute('/users')({
+  component: UsersPage,
+})
+```
+
+</route_export_rule>
+
+---
+
 <layers>
 
 ## Layer Architecture
 
 ### 1. Routes Layer
 
+> ⚠️ **페이지마다 폴더 생성 필수**
+>
+> 모든 페이지는 **반드시 폴더 구조**로 만들어야 합니다. Flat 파일 방식(`routes/users.tsx`)은 금지됩니다.
+>
+> **이유:** -components/, -functions/, -hooks/ 등 페이지 전용 리소스를 체계적으로 관리하기 위함입니다.
+>
+> | ❌ 금지 | ✅ 필수 |
+> |--------|--------|
+> | `routes/users.tsx` | `routes/users/index.tsx` |
+> | `routes/posts.tsx` | `routes/posts/(main)/index.tsx` |
+
 ```
 routes/<route-name>/
 ├── (main)/                # route group (목록 페이지)
@@ -107,27 +159,58 @@ routes/<route-name>/
 | **-components/** | 100-200줄 | 페이지 전용 컴포넌트 분리 |
 | **-sections/** | 200줄+ | 논리적 섹션 분리 |
 | **-tabs/** | 탭 UI | 탭 콘텐츠 분리 |
-| **_layout/** | Pathless | 공통 레이아웃 (URL 미영향) |
+| **route.tsx** | 레이아웃 | 하위 경로 공통 레이아웃 |
 
 #### Layout Routes 패턴
 
+> ⚠️ **route.tsx로 레이아웃 구성**
+>
+> `route.tsx`는 하위 경로의 공통 레이아웃 역할을 합니다.
+> `index.tsx`는 Route Group `()`으로 묶어야 합니다.
+>
+> **필수:** `route.tsx`는 반드시 `component`를 export해야 합니다.
+>
+> | ❌ 금지 | ✅ 필수 |
+> |--------|--------|
+> | `export const Route = createFileRoute(...)({})` | `export const Route = createFileRoute(...)({ component: ... })` |
+
 ```
 routes/
-├── (auth)/_layout/          # Pathless Layout
-│   ├── route.tsx            # <Outlet />
-│   ├── login.tsx            # /login
-│   └── register.tsx         # /register
+├── (auth)/
+│   ├── route.tsx           # 레이아웃 (<Outlet />)
+│   ├── (main)/
+│   │   └── index.tsx       # /auth (목록/메인)
+│   ├── login/
+│   │   └── index.tsx       # /auth/login
+│   └── register/
+│       └── index.tsx       # /auth/register
 ```
 
 ```typescript
-// routes/(auth)/_layout/route.tsx
-export const Route = createFileRoute('/(auth)/_layout')({
+// ❌ 금지: component 없음
+export const Route = createFileRoute('/(auth)')({
+  beforeLoad: async () => ({ user: await getUser() }),
+})
+
+// ✅ 필수: component 반드시 포함
+// routes/(auth)/route.tsx - 레이아웃
+export const Route = createFileRoute('/(auth)')({
   component: () => (
     <div className="auth-container">
       <Outlet />
     </div>
   ),
 })
+
+// routes/(auth)/(main)/index.tsx - 메인 페이지
+export const Route = createFileRoute('/(auth)/')({
+  component: AuthMainPage,
+})
+
+// routes/(auth)/login/index.tsx
+export const Route = createFileRoute('/(auth)/login')({
+  component: LoginPage,
+})
 ```
 
 ### 2. Services Layer