@kood/claude-code 0.5.4 → 0.5.6

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

@@ -1,35 +1,35 @@
 # Prisma v7 - Database ORM
 
-> Type-safe database ORM
+> Type-safe 데이터베이스 ORM
 
 @config.md
 @cloudflare-d1.md
 
 ---
 
-## Version Notice
+## 버전 주의
 
 ```prisma
 generator client {
-  provider = "prisma-client"      // ✅ v7 (not prisma-client-js!)
-  output   = "./generated/client" // ✅ output required
+  provider = "prisma-client"      // ✅ v7 (prisma-client-js 아님!)
+  output   = "./generated/client" // ✅ output 필수
 }
 ```
 
 ---
 
-## Prohibited Actions
+## 금지 사항
 
-| Command | Description |
-|---------|-------------|
-| `prisma db push` | Do not auto-run |
-| `prisma migrate` | Do not auto-run |
-| `prisma generate` | Do not auto-run |
-| Schema changes | Only as requested |
+| 명령 | 설명 |
+|------|------|
+| `prisma db push` | 자동 실행 금지 |
+| `prisma migrate` | 자동 실행 금지 |
+| `prisma generate` | 자동 실행 금지 |
+| schema 변경 | 요청된 것만 |
 
 ---
 
-## Installation
+## 설치
 
 ```bash
 npm install prisma-client
@@ -38,20 +38,20 @@ npm install -D prisma
 
 ---
 
-## Multi-File Structure (Required)
+## Multi-File 구조 (필수)
 
 ```
 prisma/schema/
 ├── +base.prisma    # datasource, generator
-├── +enum.prisma    # enum definitions
-├── user.prisma     # User model (Korean comments required)
-└── post.prisma     # Post model
+├── +enum.prisma    # enum 정의
+├── user.prisma     # User 모델 (한글 주석 필수)
+└── post.prisma     # Post 모델
 ```
 
 ### +base.prisma
 
 ```prisma
-// datasource, generator configuration
+// datasource, generator 설정
 datasource db {
   provider = "postgresql"
   url      = env("DATABASE_URL")
@@ -66,12 +66,12 @@ generator client {
 ### user.prisma
 
 ```prisma
-// User model
+// 사용자 모델
 model User {
   id        String   @id @default(cuid())
-  email     String   @unique   // Login email
-  name      String?            // Display name
-  posts     Post[]             // Authored posts
+  email     String   @unique   // 로그인 이메일
+  name      String?            // 표시 이름
+  posts     Post[]             // 작성 게시글
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 }
@@ -110,7 +110,7 @@ const user = await prisma.user.create({
   data: { email: 'user@example.com', name: 'John' },
 })
 
-// With relations
+// 관계와 함께
 const userWithPosts = await prisma.user.create({
   data: {
     email: 'user@example.com',
@@ -131,7 +131,7 @@ const users = await prisma.user.findMany({
   take: 10,
 })
 
-// Include relations
+// 관계 포함
 const userWithPosts = await prisma.user.findUnique({
   where: { id },
   include: { posts: { where: { published: true } } },
@@ -163,24 +163,24 @@ await prisma.user.deleteMany({ where: { email: { contains: '@test.com' } } })
 
 ---
 
-## Filtering
+## 필터링
 
 ```typescript
 await prisma.user.findMany({
   where: {
-    age: { gt: 18, lte: 65 },           // Comparison
-    email: { contains: '@gmail.com' },  // String
+    age: { gt: 18, lte: 65 },           // 비교
+    email: { contains: '@gmail.com' },  // 문자열
     AND: [{ email: { contains: '@' } }, { name: { not: null } }],
     OR: [{ role: 'admin' }, { role: 'moderator' }],
-    id: { in: ['id1', 'id2'] },         // Array
-    posts: { some: { published: true } }, // Relations
+    id: { in: ['id1', 'id2'] },         // 배열
+    posts: { some: { published: true } }, // 관계
   },
 })
 ```
 
 ---
 
-## Transactions
+## 트랜잭션
 
 ```typescript
 // Sequential
@@ -199,7 +199,7 @@ const result = await prisma.$transaction(async (tx) => {
 
 ---
 
-## Usage with Hono
+## Hono와 함께 사용
 
 ```typescript
 import { Hono } from 'hono'
@@ -241,7 +241,7 @@ app.get('/users/:id', async (c) => {
 
 ---
 
-## Related Documentation
+## 관련 문서
 
-- [Config Files](./config.md) - prisma.config.ts configuration
+- [Config 파일](./config.md) - prisma.config.ts 설정
 - [Cloudflare D1](./cloudflare-d1.md)

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

@@ -1,16 +1,16 @@
 # t3-env - Type-Safe Environment Variables
 
-> Zod-based type-safe environment variable management
+> Zod 기반 타입 안전 환경 변수 관리
 
 <context>
 
-**Purpose:** Server environment variable validation, runtime type safety
+**용도:** 서버 환경 변수 검증, 런타임 타입 안전성
 
-**Features:**
-- Validation + type inference with Zod schemas
-- Transform & default value support
-- Runtime validation
-- Framework agnostic
+**특징:**
+- Zod 스키마로 검증 + 타입 추론
+- Transform & Default 값 지원
+- 런타임 검증
+- 프레임워크 무관
 
 </context>
 
@@ -18,11 +18,11 @@
 
 <forbidden>
 
-| 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 |
+| 분류 | 금지 |
+|------|------|
+| **직접 접근** | `process.env` 직접 사용 (env 객체 필수) |
+| **타입** | any 타입으로 env 변수 접근 |
+| **검증 우회** | 스키마 정의 없이 환경 변수 사용 |
 
 </forbidden>
 
@@ -30,10 +30,10 @@
 
 <required>
 
-| Category | Required |
-|----------|----------|
-| **Installation** | `@t3-oss/env-core zod` |
-| **Structure** | Create `src/env.ts` file |
+| 분류 | 필수 |
+|------|------|
+| **설치** | `@t3-oss/env-core zod` |
+| **구조** | `src/env.ts` 파일 생성 |
 | **Import** | `import { env } from '@/env'` |
 
 </required>
@@ -114,7 +114,7 @@ import { env } from '@/env'
 
 export const prisma = new PrismaClient({
   datasourceUrl: env.DATABASE_URL,
-  //                  ^? string (type-safe)
+  //                  ^? string (타입 안전)
 })
 ```
 
@@ -329,7 +329,7 @@ import { createMiddleware } from 'hono/factory'
 import { env } from '@/env'
 
 export const envMiddleware = createMiddleware(async (c, next) => {
-  // Check if env object is initialized
+  // env 객체가 초기화되었는지 확인
   if (!env.DATABASE_URL) {
     return c.json({ error: 'Server misconfigured' }, 500)
   }
@@ -363,10 +363,10 @@ app.use(
 
 ## Tips
 
-| Scenario | Method |
-|----------|--------|
-| **Cloudflare** | Use `createWorkerEnv(env)` pattern |
-| **Monorepo** | Separate `env.ts` per package |
+| 상황 | 방법 |
+|------|------|
+| **Cloudflare** | `createWorkerEnv(env)` 패턴 사용 |
+| **Monorepo** | 각 패키지마다 별도 `env.ts` |
 | **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 schema validation
+> TypeScript-first 스키마 검증
 
 ---
 
-## Version Notice
+## 버전 주의
 
 ```typescript
-// ✅ v4 syntax
+// ✅ v4 문법
 z.email()
 z.url()
 z.uuid()
 
-// ❌ v3 syntax (prohibited)
+// ❌ v3 문법 (사용 금지)
 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()
 ```
 
-### Strings (v4)
+### 문자열 (v4)
 
 ```typescript
-z.email()                    // Email
+z.email()                    // 이메일
 z.url()                      // URL
 z.uuid()                     // UUID
-z.string().min(1).max(100)   // Length
-z.string().trim()            // Trim whitespace
-z.string().regex(/^[a-z]+$/) // Regex
+z.string().min(1).max(100)   // 길이
+z.string().trim()            // 공백 제거
+z.string().regex(/^[a-z]+$/) // 정규식
 ```
 
-### Numbers
+### 숫자
 
 ```typescript
-z.number().int()        // Integer
-z.number().positive()   // Positive
+z.number().int()        // 정수
+z.number().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()              // All fields optional
-userSchema.partial({ email: true }) // Specific fields only
+userSchema.partial()              // 모든 필드 optional
+userSchema.partial({ email: true }) // 특정 필드만
 userSchema.pick({ id: true, name: true })
 userSchema.omit({ password: true })
 ```
@@ -118,7 +118,7 @@ z.discriminatedUnion('type', [
 
 ---
 
-## Coerce (Type Conversion)
+## Coerce (타입 변환)
 
 ```typescript
 z.coerce.number()   // string → number
@@ -137,27 +137,27 @@ z.string().transform((s) => s.split(','))
 
 ---
 
-## Refine (Custom Validation)
+## Refine (커스텀 검증)
 
 ```typescript
-// Single field
+// 단일 필드
 z.string().refine((val) => val.length >= 8, {
-  message: 'Must be at least 8 characters',
+  message: '8자 이상 필요',
 })
 
-// Entire object
+// 객체 전체
 z.object({
   password: z.string().min(8),
   confirmPassword: z.string(),
 }).refine((data) => data.password === data.confirmPassword, {
-  message: 'Passwords do not match',
+  message: '비밀번호 불일치',
   path: ['confirmPassword'],
 })
 ```
 
 ---
 
-## Error Handling
+## 에러 처리
 
 ```typescript
 const result = schema.safeParse(input)
@@ -170,16 +170,16 @@ if (result.success) {
 }
 ```
 
-### Custom Errors
+### 커스텀 에러
 
 ```typescript
-z.email({ message: 'Please enter a valid email' })
-z.string().min(1, { message: 'Required field' })
+z.email({ message: '올바른 이메일 입력' })
+z.string().min(1, { message: '필수 입력' })
 ```
 
 ---
 
-## Usage with Hono
+## Hono와 함께
 
 ```typescript
 import { zValidator } from '@hono/zod-validator'
@@ -204,6 +204,6 @@ app.post('/users',
 
 ---
 
-## Related Documentation
+## 관련 문서
 
-- [Hono Validation](../hono/validation.md)
+- [Hono 검증](../hono/validation.md)

package/templates/nextjs/CLAUDE.md

@@ -4,17 +4,17 @@
 
 <context>
 
-**Purpose:** Next.js App Router-based web application development guidelines
+**Purpose:** Next.js App Router 기반 웹 애플리케이션 개발 지침
 
-**Scope:** Full-stack React application implementation
+**Scope:** Full-stack React 애플리케이션 구현
 
 **Key Features:**
 - App Router (file-based routing)
-- Server Actions (type-safe API)
+- Server Actions (타입 안전 API)
 - Server/Client Components
 - Route Handlers (REST API)
 - Middleware
-- Built-in Optimization (images, fonts, scripts)
+- Built-in Optimization (이미지, 폰트, 스크립트)
 - Deployment (Vercel, Docker, Node.js)
 
 </context>
@@ -35,14 +35,14 @@
 
 <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) |
+| 분류 | 금지 행동 |
+|------|----------|
+| **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 또는 전용 도구 사용) |
 
 </forbidden>
 
@@ -50,18 +50,18 @@
 
 <required>
 
-| 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 |
+| 작업 | 필수 행동 |
+|------|----------|
+| **작업 시작 전** | 관련 docs 읽기 (UI → design, API → nextjs, DB → prisma, 인증 → next-auth) |
+| **문서 검색** | serena mcp 사용 (문서 인덱싱/검색, context 길이 최적화) |
+| **코드 검색** | 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/`), 모든 요소 한글 주석 필수 |
 
 </required>
 
@@ -69,15 +69,15 @@
 
 <tech_stack>
 
-| Technology | Version | Note |
-|------------|---------|------|
-| Next.js | **15.x** | App Router only |
+| 기술 | 버전 | 주의 |
+|------|------|------|
+| Next.js | **15.x** | App Router 전용 |
 | React | **19.x** | Server Components |
 | TypeScript | 5.x | strict |
 | Tailwind CSS | 4.x | @theme |
-| Prisma | **7.x** | `prisma-client`, output required |
+| Prisma | **7.x** | `prisma-client`, output 필수 |
 | Zod | **4.x** | `z.email()`, `z.url()` |
-| NextAuth.js | **5.x** (Auth.js) | App Router support |
+| NextAuth.js | **5.x** (Auth.js) | App Router 지원 |
 | TanStack Query | 5.x | - |
 
 </tech_stack>
@@ -92,41 +92,41 @@ src/
 │   ├── page.tsx                # Home page
 │   ├── [slug]/
 │   │   ├── page.tsx            # Dynamic route
-│   │   ├── _components/        # Page-specific components (required)
-│   │   ├── _hooks/             # Page-specific hooks (required)
-│   │   └── _actions/           # Page-specific Server Actions (required)
+│   │   ├── _components/        # 페이지 전용 컴포넌트 (필수)
+│   │   ├── _hooks/             # 페이지 전용 훅 (필수)
+│   │   └── _actions/           # 페이지 전용 Server Actions (필수)
 │   ├── api/
 │   │   └── [endpoint]/
 │   │       └── route.ts        # Route Handler (REST API)
-│   └── _actions/               # Shared Server Actions
-├── components/ui/              # Shared UI components (Server Components)
+│   └── _actions/               # 공통 Server Actions
+├── components/ui/              # 공통 UI 컴포넌트 (Server Components)
 ├── middleware.ts               # Middleware
 ├── database/prisma.ts
 └── lib/
 ```
 
-**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
+**필수 규칙:**
+- 페이지당 `_components/`, `_hooks/`, `_actions/` 폴더 필수 (줄 수 무관)
+- Custom Hook은 페이지 크기와 무관하게 **반드시** `_hooks/` 폴더에 분리
+- Server Components가 기본 → `"use client"` 명시 필요 시만 사용
+- Server Actions는 글로벌(`app/_actions/`) 또는 페이지 전용(`[route]/_actions/`)에 분리
+- Route Handlers는 `/app/api/` 경로에만 생성
 </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
+파일명: kebab-case, Routes: `page.tsx`, `layout.tsx`, `[slug]/page.tsx`
+TypeScript: const 선언, 명시적 return type, interface(객체)/type(유니온), any→unknown
+Import 순서: 외부 → @/ → 상대경로 → type
 
 Prisma Multi-File:
 ```
 prisma/schema/
 ├── +base.prisma   # datasource, generator
 ├── +enum.prisma   # enum
-└── [model].prisma # per model (Korean comments required!)
+└── [model].prisma # 모델별 (한글 주석!)
 ```
 
 </conventions>
@@ -136,7 +136,7 @@ prisma/schema/
 <quick_patterns>
 
 ```typescript
-// Server Action (file top)
+// Server Action (파일 상단)
 "use server"
 
 export async function createPost(formData: FormData) {
@@ -150,7 +150,7 @@ export async function createPost(formData: FormData) {
   return post
 }
 
-// Server Action (with auth)
+// Server Action (인증)
 "use server"
 
 import { auth } from "@/lib/auth"
@@ -209,12 +209,12 @@ export default async function PostsPage() {
 
 <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 |
+| 원칙 | 값 |
+|------|------|
+| 색상 | 60-30-10 (배경-보조-강조) |
+| 간격 | 8px 그리드 |
+| 접근성 | WCAG AA (대비 4.5:1+) |
+| 폰트 | 2-3개 |
 | Safe Area | tailwindcss-safe-area |
 
 </ui_ux>
@@ -224,8 +224,8 @@ export default async function PostsPage() {
 <docs_structure>
 ```
 docs/
-├── guides/          # Getting started, conventions, patterns
+├── guides/          # 시작하기, 규칙, 패턴
 ├── library/         # nextjs, prisma, next-auth, tanstack-query, zod
-└── design.md        # UI/UX guide
+└── design.md        # UI/UX 가이드
 ```
 </docs_structure>