@kood/claude-code 0.3.7 → 0.3.9

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

@@ -4,17 +4,17 @@
 
 <context>
 
-**Purpose:** Next.js App Router 기반 웹 애플리케이션 개발 지침
+**Purpose:** Next.js App Router-based web application development guidelines
 
-**Scope:** Full-stack React 애플리케이션 구현
+**Scope:** Full-stack React application implementation
 
 **Key Features:**
 - App Router (file-based routing)
-- Server Actions (타입 안전 API)
+- Server Actions (type-safe API)
 - Server/Client Components
 - Route Handlers (REST API)
 - Middleware
-- Built-in Optimization (이미지, 폰트, 스크립트)
+- Built-in Optimization (images, fonts, scripts)
 - Deployment (Vercel, Docker, Node.js)
 
 </context>
@@ -35,14 +35,14 @@
 
 <forbidden>
 
-| 분류 | 금지 행동 |
-|------|----------|
-| **Git 커밋** | AI 표시 (`Generated with Claude Code`, `🤖`, `Co-Authored-By:`), 여러 줄 메시지, 이모지 |
-| **Prisma** | `db push/migrate/generate` 자동 실행, `schema.prisma` 무단 수정 |
-| **Server Actions** | 클라이언트 컴포넌트에서 직접 정의, try-catch 없이 사용, Zod 검증 누락 (POST/PUT/PATCH) |
-| **Route Handlers** | `/app/api/` 외부에 생성, Server Actions로 대체 가능한 경우 생성 |
-| **클라이언트** | Server Action 직접 호출 (TanStack Query 사용), `"use client"` 누락 |
-| **코드 검색** | Bash의 grep/rg/find 명령어 (ast-grep 또는 전용 도구 사용) |
+| 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>
 
@@ -50,17 +50,18 @@
 
 <required>
 
-| 작업 | 필수 행동 |
-|------|----------|
-| **작업 시작 전** | 관련 docs 읽기 (UI → design, API → nextjs, DB → prisma, 인증 → next-auth) |
-| **코드 검색** | ast-grep 사용 (함수/컴포넌트/패턴 검색) |
-| **복잡한 작업** | Sequential Thinking MCP (5+ 단계 작업) |
-| **대규모 수정** | gemini-review (3+ 파일 변경, 아키텍처 결정) |
-| **Server Actions** | `"use server"` 선언, Zod 검증 (POST/PUT/PATCH), try-catch + revalidatePath/redirect |
-| **클라이언트 API** | TanStack Query (`useQuery`/`useMutation`)로 Server Action 호출 |
-| **Custom Hook 순서** | State → Global Hooks (useParams, useRouter, useSearchParams) → React Query → Handlers → Memo → Effect |
-| **코드 작성** | UTF-8 인코딩, 코드 묶음별 한글 주석, const 함수 선언 |
-| **Prisma** | Multi-File 구조 (`prisma/schema/`), 모든 요소 한글 주석 필수 |
+| Task | Required Actions |
+|------|------------------|
+| **Before Starting** | Read relevant docs (UI → design, API → nextjs, DB → prisma, auth → next-auth) |
+| **Document Search** | Use serena mcp (document indexing/search, context length optimization) |
+| **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, Korean comments per code block, const function declarations |
+| **Prisma** | Multi-File structure (`prisma/schema/`), Korean comments required for all elements |
 
 </required>
 
@@ -68,15 +69,15 @@
 
 <tech_stack>
 
-| 기술 | 버전 | 주의 |
-|------|------|------|
-| Next.js | **15.x** | App Router 전용 |
+| 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 필수 |
+| Prisma | **7.x** | `prisma-client`, output required |
 | Zod | **4.x** | `z.email()`, `z.url()` |
-| NextAuth.js | **5.x** (Auth.js) | App Router 지원 |
+| NextAuth.js | **5.x** (Auth.js) | App Router support |
 | TanStack Query | 5.x | - |
 
 </tech_stack>
@@ -91,39 +92,41 @@ src/
 │   ├── page.tsx                # Home page
 │   ├── [slug]/
 │   │   ├── page.tsx            # Dynamic route
-│   │   └── -components/        # 페이지 전용 Client Components
+│   │   ├── _components/        # Page-specific components (required)
+│   │   ├── _hooks/             # Page-specific hooks (required)
+│   │   └── _actions/           # Page-specific Server Actions (required)
 │   ├── api/
 │   │   └── [endpoint]/
 │   │       └── route.ts        # Route Handler (REST API)
-│   └── _components/            # 공통 Client Components
-├── actions/                    # Server Actions (공통)
-├── components/ui/              # UI 컴포넌트 (Server Components)
+│   └── _actions/               # Shared Server Actions
+├── components/ui/              # Shared UI components (Server Components)
 ├── middleware.ts               # Middleware
 ├── database/prisma.ts
 └── lib/
 ```
 
-**필수 규칙:**
-- 페이지당 `-components/` 폴더 권장 (페이지 전용 Client Components)
-- Server Components가 기본 → `"use client"` 명시 필요 시만 사용
-- Server Actions는 `actions/` 폴더 또는 파일 상단 (`"use server"`)
-- Route Handlers는 `/app/api/` 경로에만 생성
+**Required Rules:**
+- Each page MUST have `_components/`, `_hooks/`, `_actions/` folders (regardless of line count)
+- Custom Hooks MUST be separated into `_hooks/` folder regardless of page size
+- Server Components by default → use `"use client"` only when necessary
+- Server Actions: global (`app/_actions/`) or page-specific (`[route]/_actions/`)
+- Route Handlers only in `/app/api/` path
 </structure>
 
 ---
 
 <conventions>
 
-파일명: kebab-case, Routes: `page.tsx`, `layout.tsx`, `[slug]/page.tsx`
-TypeScript: const 선언, 명시적 return type, interface(객체)/type(유니온), any→unknown
-Import 순서: 외부 → @/ → 상대경로 → type
+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 # 모델별 (한글 주석!)
+└── [model].prisma # per model (Korean comments required!)
 ```
 
 </conventions>
@@ -133,7 +136,7 @@ prisma/schema/
 <quick_patterns>
 
 ```typescript
-// Server Action (파일 상단)
+// Server Action (file top)
 "use server"
 
 export async function createPost(formData: FormData) {
@@ -147,7 +150,7 @@ export async function createPost(formData: FormData) {
   return post
 }
 
-// Server Action (인증)
+// Server Action (with auth)
 "use server"
 
 import { auth } from "@/lib/auth"
@@ -206,12 +209,12 @@ export default async function PostsPage() {
 
 <ui_ux>
 
-| 원칙 | 값 |
-|------|------|
-| 색상 | 60-30-10 (배경-보조-강조) |
-| 간격 | 8px 그리드 |
-| 접근성 | WCAG AA (대비 4.5:1+) |
-| 폰트 | 2-3개 |
+| 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>
@@ -221,8 +224,8 @@ export default async function PostsPage() {
 <docs_structure>
 ```
 docs/
-├── guides/          # 시작하기, 규칙, 패턴
+├── guides/          # Getting started, conventions, patterns
 ├── library/         # nextjs, prisma, next-auth, tanstack-query, zod
-└── design.md        # UI/UX 가이드
+└── design.md        # UI/UX guide
 ```
 </docs_structure>