@kood/claude-code 0.3.6 → 0.3.8

package/templates/hono/docs/library/t3-env/index.md

@@ -1,16 +1,16 @@
 # t3-env - Type-Safe Environment Variables
 
-> Zod 기반 타입 안전 환경 변수 관리
+> Zod-based type-safe environment variable management
 
 <context>
 
-**용도:** 서버 환경 변수 검증, 런타임 타입 안전성
+**Purpose:** Server environment variable validation, runtime type safety
 
-**특징:**
-- Zod 스키마로 검증 + 타입 추론
-- Transform & Default 값 지원
-- 런타임 검증
-- 프레임워크 무관
+**Features:**
+- Validation + type inference with Zod schemas
+- Transform & default value support
+- Runtime validation
+- Framework agnostic
 
 </context>
 
@@ -18,11 +18,11 @@
 
 <forbidden>
 
-| 분류 | 금지 |
-|------|------|
-| **직접 접근** | `process.env` 직접 사용 (env 객체 필수) |
-| **타입** | any 타입으로 env 변수 접근 |
-| **검증 우회** | 스키마 정의 없이 환경 변수 사용 |
+| Category | Prohibited |
+|----------|------------|
+| **Direct Access** | Using `process.env` directly (env object required) |
+| **Types** | Accessing env variables with any type |
+| **Bypass Validation** | Using environment variables without schema definition |
 
 </forbidden>
 
@@ -30,10 +30,10 @@
 
 <required>
 
-| 분류 | 필수 |
-|------|------|
-| **설치** | `@t3-oss/env-core zod` |
-| **구조** | `src/env.ts` 파일 생성 |
+| Category | Required |
+|----------|----------|
+| **Installation** | `@t3-oss/env-core zod` |
+| **Structure** | Create `src/env.ts` file |
 | **Import** | `import { env } from '@/env'` |
 
 </required>
@@ -114,7 +114,7 @@ import { env } from '@/env'
 
 export const prisma = new PrismaClient({
   datasourceUrl: env.DATABASE_URL,
-  //                  ^? string (타입 안전)
+  //                  ^? string (type-safe)
 })
 ```
 
@@ -329,7 +329,7 @@ import { createMiddleware } from 'hono/factory'
 import { env } from '@/env'
 
 export const envMiddleware = createMiddleware(async (c, next) => {
-  // env 객체가 초기화되었는지 확인
+  // Check if env object is initialized
   if (!env.DATABASE_URL) {
     return c.json({ error: 'Server misconfigured' }, 500)
   }
@@ -363,10 +363,10 @@ app.use(
 
 ## Tips
 
-| 상황 | 방법 |
-|------|------|
-| **Cloudflare** | `createWorkerEnv(env)` 패턴 사용 |
-| **Monorepo** | 각 패키지마다 별도 `env.ts` |
+| Scenario | Method |
+|----------|--------|
+| **Cloudflare** | Use `createWorkerEnv(env)` pattern |
+| **Monorepo** | Separate `env.ts` per package |
 | **Testing** | `.env.test` + `NODE_ENV=test` |
 | **Docker** | `docker run -e DATABASE_URL=...` |
 | **CI/CD** | GitHub Secrets → Environment Variables |

package/templates/hono/docs/library/zod/index.md

@@ -1,25 +1,25 @@
 # Zod v4 - Schema Validation
 
-> TypeScript-first 스키마 검증
+> TypeScript-first schema validation
 
 ---
 
-## 버전 주의
+## Version Notice
 
 ```typescript
-// ✅ v4 문법
+// ✅ v4 syntax
 z.email()
 z.url()
 z.uuid()
 
-// ❌ v3 문법 (사용 금지)
+// ❌ v3 syntax (prohibited)
 z.string().email()
 z.string().url()
 ```
 
 ---
 
-## 설치
+## Installation
 
 ```bash
 npm install zod
@@ -27,7 +27,7 @@ npm install zod
 
 ---
 
-## 기본 타입
+## Basic Types
 
 ```typescript
 import { z } from 'zod'
@@ -40,28 +40,28 @@ z.undefined()
 z.null()
 ```
 
-### 문자열 (v4)
+### Strings (v4)
 
 ```typescript
-z.email()                    // 이메일
+z.email()                    // Email
 z.url()                      // URL
 z.uuid()                     // UUID
-z.string().min(1).max(100)   // 길이
-z.string().trim()            // 공백 제거
-z.string().regex(/^[a-z]+$/) // 정규식
+z.string().min(1).max(100)   // Length
+z.string().trim()            // Trim whitespace
+z.string().regex(/^[a-z]+$/) // Regex
 ```
 
-### 숫자
+### Numbers
 
 ```typescript
-z.number().int()        // 정수
-z.number().positive()   // 양수
+z.number().int()        // Integer
+z.number().positive()   // Positive
 z.number().min(1).max(100)
 ```
 
 ---
 
-## 객체
+## Objects
 
 ```typescript
 const userSchema = z.object({
@@ -82,7 +82,7 @@ z.string().nullable()   // string | null
 z.string().nullish()    // string | null | undefined
 ```
 
-### 기본값
+### Defaults
 
 ```typescript
 z.string().default('Anonymous')
@@ -92,8 +92,8 @@ z.enum(['user', 'admin']).default('user')
 ### Partial / Pick / Omit
 
 ```typescript
-userSchema.partial()              // 모든 필드 optional
-userSchema.partial({ email: true }) // 특정 필드만
+userSchema.partial()              // All fields optional
+userSchema.partial({ email: true }) // Specific fields only
 userSchema.pick({ id: true, name: true })
 userSchema.omit({ password: true })
 ```
@@ -118,7 +118,7 @@ z.discriminatedUnion('type', [
 
 ---
 
-## Coerce (타입 변환)
+## Coerce (Type Conversion)
 
 ```typescript
 z.coerce.number()   // string → number
@@ -137,27 +137,27 @@ z.string().transform((s) => s.split(','))
 
 ---
 
-## Refine (커스텀 검증)
+## Refine (Custom Validation)
 
 ```typescript
-// 단일 필드
+// Single field
 z.string().refine((val) => val.length >= 8, {
-  message: '8자 이상 필요',
+  message: 'Must be at least 8 characters',
 })
 
-// 객체 전체
+// Entire object
 z.object({
   password: z.string().min(8),
   confirmPassword: z.string(),
 }).refine((data) => data.password === data.confirmPassword, {
-  message: '비밀번호 불일치',
+  message: 'Passwords do not match',
   path: ['confirmPassword'],
 })
 ```
 
 ---
 
-## 에러 처리
+## Error Handling
 
 ```typescript
 const result = schema.safeParse(input)
@@ -170,16 +170,16 @@ if (result.success) {
 }
 ```
 
-### 커스텀 에러
+### Custom Errors
 
 ```typescript
-z.email({ message: '올바른 이메일 입력' })
-z.string().min(1, { message: '필수 입력' })
+z.email({ message: 'Please enter a valid email' })
+z.string().min(1, { message: 'Required field' })
 ```
 
 ---
 
-## Hono와 함께
+## Usage with Hono
 
 ```typescript
 import { zValidator } from '@hono/zod-validator'
@@ -204,6 +204,6 @@ app.post('/users',
 
 ---
 
-## 관련 문서
+## Related Documentation
 
-- [Hono 검증](../hono/validation.md)
+- [Hono Validation](../hono/validation.md)

package/templates/nextjs/CLAUDE.md

@@ -0,0 +1,228 @@
+# CLAUDE.md - Next.js
+
+> React Full-stack Framework
+
+<context>
+
+**Purpose:** Next.js App Router-based web application development guidelines
+
+**Scope:** Full-stack React application implementation
+
+**Key Features:**
+- App Router (file-based routing)
+- Server Actions (type-safe API)
+- Server/Client Components
+- Route Handlers (REST API)
+- Middleware
+- Built-in Optimization (images, fonts, scripts)
+- Deployment (Vercel, Docker, Node.js)
+
+</context>
+
+---
+
+<instructions>
+@../../commands/git.md
+@docs/library/nextjs/index.md
+@docs/library/tanstack-query/index.md
+@docs/library/prisma/index.md
+@docs/library/next-auth/index.md
+@docs/library/zod/index.md
+@docs/design.md
+</instructions>
+
+---
+
+<forbidden>
+
+| Category | Forbidden Actions |
+|----------|-------------------|
+| **Git Commits** | AI markers (`Generated with Claude Code`, `🤖`, `Co-Authored-By:`), multi-line messages, emojis |
+| **Prisma** | Auto-running `db push/migrate/generate`, unauthorized `schema.prisma` modifications |
+| **Server Actions** | Direct definition in client components, usage without try-catch, missing Zod validation (POST/PUT/PATCH) |
+| **Route Handlers** | Creation outside `/app/api/`, creation when Server Actions are suitable |
+| **Client** | Direct Server Action calls (use TanStack Query), missing `"use client"` |
+| **Code Search** | Bash grep/rg/find commands (use ast-grep or dedicated tools) |
+
+</forbidden>
+
+---
+
+<required>
+
+| Task | Required Actions |
+|------|------------------|
+| **Before Starting** | Read relevant docs (UI → design, API → nextjs, DB → prisma, auth → next-auth) |
+| **Code Search** | Use ast-grep (function/component/pattern search) |
+| **Complex Tasks** | Sequential Thinking MCP (5+ step tasks) |
+| **Large Changes** | gemini-review (3+ file changes, architectural decisions) |
+| **Server Actions** | `"use server"` declaration, Zod validation (POST/PUT/PATCH), try-catch + revalidatePath/redirect |
+| **Client API** | Call Server Actions via TanStack Query (`useQuery`/`useMutation`) |
+| **Custom Hook Order** | State → Global Hooks (useParams, useRouter, useSearchParams) → React Query → Handlers → Memo → Effect |
+| **Code Writing** | UTF-8 encoding, comments per code block, const function declarations |
+| **Prisma** | Multi-File structure (`prisma/schema/`), all elements require comments |
+
+</required>
+
+---
+
+<tech_stack>
+
+| Technology | Version | Note |
+|------------|---------|------|
+| Next.js | **15.x** | App Router only |
+| React | **19.x** | Server Components |
+| TypeScript | 5.x | strict |
+| Tailwind CSS | 4.x | @theme |
+| Prisma | **7.x** | `prisma-client`, output required |
+| Zod | **4.x** | `z.email()`, `z.url()` |
+| NextAuth.js | **5.x** (Auth.js) | App Router support |
+| TanStack Query | 5.x | - |
+
+</tech_stack>
+
+---
+
+<structure>
+```
+src/
+├── app/
+│   ├── layout.tsx              # Root layout (required)
+│   ├── page.tsx                # Home page
+│   ├── [slug]/
+│   │   ├── page.tsx            # Dynamic route
+│   │   └── -components/        # Page-specific Client Components
+│   ├── api/
+│   │   └── [endpoint]/
+│   │       └── route.ts        # Route Handler (REST API)
+│   └── _components/            # Shared Client Components
+├── actions/                    # Server Actions (shared)
+├── components/ui/              # UI components (Server Components)
+├── middleware.ts               # Middleware
+├── database/prisma.ts
+└── lib/
+```
+
+**Required Rules:**
+- Recommended `-components/` folder per page (page-specific Client Components)
+- Server Components by default → use `"use client"` only when necessary
+- Server Actions in `actions/` folder or at file top (`"use server"`)
+- Route Handlers only in `/app/api/` path
+</structure>
+
+---
+
+<conventions>
+
+File names: kebab-case, Routes: `page.tsx`, `layout.tsx`, `[slug]/page.tsx`
+TypeScript: const declarations, explicit return types, interface (objects)/type (unions), any→unknown
+Import order: external → @/ → relative → type
+
+Prisma Multi-File:
+```
+prisma/schema/
+├── +base.prisma   # datasource, generator
+├── +enum.prisma   # enum
+└── [model].prisma # per model (with comments!)
+```
+
+</conventions>
+
+---
+
+<quick_patterns>
+
+```typescript
+// Server Action (file top)
+"use server"
+
+export async function createPost(formData: FormData) {
+  const parsed = createPostSchema.parse({
+    title: formData.get("title"),
+    content: formData.get("content"),
+  })
+
+  const post = await prisma.post.create({ data: parsed })
+  revalidatePath("/posts")
+  return post
+}
+
+// Server Action (with auth)
+"use server"
+
+import { auth } from "@/lib/auth"
+
+export async function deletePost(id: string) {
+  const session = await auth()
+  if (!session?.user) throw new Error("Unauthorized")
+
+  await prisma.post.delete({ where: { id } })
+  revalidatePath("/posts")
+}
+
+// Route Handler (GET)
+export async function GET(request: Request) {
+  const { searchParams } = new URL(request.url)
+  const id = searchParams.get("id")
+
+  const posts = await prisma.post.findMany({ where: { id } })
+  return Response.json(posts)
+}
+
+// Client Component with TanStack Query
+"use client"
+
+import { useMutation, useQueryClient } from "@tanstack/react-query"
+import { createPost } from "@/actions/posts"
+
+export function CreatePostForm() {
+  const queryClient = useQueryClient()
+
+  const mutation = useMutation({
+    mutationFn: createPost,
+    onSuccess: () => queryClient.invalidateQueries({ queryKey: ["posts"] }),
+  })
+
+  return <form action={mutation.mutate}>...</form>
+}
+
+// Zod v4
+const schema = z.object({
+  email: z.email(),
+  name: z.string().min(1).trim(),
+  website: z.url().optional(),
+})
+
+// Page with Server Component
+export default async function PostsPage() {
+  const posts = await prisma.post.findMany()
+  return <PostsList posts={posts} />
+}
+```
+
+</quick_patterns>
+
+---
+
+<ui_ux>
+
+| Principle | Value |
+|-----------|-------|
+| Color | 60-30-10 (background-secondary-accent) |
+| Spacing | 8px grid |
+| Accessibility | WCAG AA (contrast 4.5:1+) |
+| Fonts | 2-3 types |
+| Safe Area | tailwindcss-safe-area |
+
+</ui_ux>
+
+---
+
+<docs_structure>
+```
+docs/
+├── guides/          # Getting started, conventions, patterns
+├── library/         # nextjs, prisma, next-auth, tanstack-query, zod
+└── design.md        # UI/UX guide
+```
+</docs_structure>