@kood/claude-code 0.5.4 → 0.5.6

package/templates/hono/docs/deployment/vercel.md

@@ -1,10 +1,10 @@
-# Nitro - Vercel Deployment
+# Nitro - Vercel 배포
 
-> Serverless deployment
+> 서버리스 배포
 
 ---
 
-## Configuration
+## 설정
 
 ```typescript
 // nitro.config.ts
@@ -26,11 +26,11 @@ export default defineNitroConfig({
 
 ---
 
-## Deployment
+## 배포
 
-### GitHub Integration (Recommended)
+### GitHub 연동 (권장)
 
-1. [Vercel Dashboard](https://vercel.com) → Add New → Project
+1. [Vercel 대시보드](https://vercel.com) → Add New → Project
 2. Build Command: `yarn build`
 3. Output Directory: `.vercel/output`
 
@@ -39,8 +39,8 @@ export default defineNitroConfig({
 ```bash
 npm install -g vercel
 vercel login
-vercel          # Preview
-vercel --prod   # Production
+vercel          # 프리뷰
+vercel --prod   # 프로덕션
 
 vercel env add DATABASE_URL
 ```
@@ -59,7 +59,7 @@ export default defineNitroConfig({
 
 ---
 
-## ISR (Caching)
+## ISR (캐시)
 
 ```typescript
 app.get("/posts", async (c) => {
@@ -68,14 +68,14 @@ app.get("/posts", async (c) => {
 });
 
 app.get("/user/:id", async (c) => {
-  c.header("Cache-Control", "no-store"); // No cache
+  c.header("Cache-Control", "no-store"); // 캐시 안함
   return c.json(await fetchUser(c.req.param("id")));
 });
 ```
 
 ---
 
-## Environment Variables
+## 환경 변수
 
 ```typescript
 app.get("/config", (c) => {
@@ -86,16 +86,16 @@ app.get("/config", (c) => {
 });
 ```
 
-| Auto-provided Variables | Description |
-|------------------------|-------------|
-| `VERCEL` | Vercel environment ("1") |
-| `VERCEL_ENV` | Environment |
-| `VERCEL_URL` | Deployment URL |
-| `VERCEL_REGION` | Execution region |
+| 자동 제공 변수 | 설명 |
+|---------------|------|
+| `VERCEL` | Vercel 환경 ("1") |
+| `VERCEL_ENV` | 환경 |
+| `VERCEL_URL` | 배포 URL |
+| `VERCEL_REGION` | 실행 리전 |
 
 ---
 
-## Database
+## 데이터베이스
 
 ### Vercel Postgres
 
@@ -161,22 +161,22 @@ jobs:
 
 ---
 
-## Troubleshooting
+## 문제 해결
 
-| Issue | Solution |
-|-------|----------|
-| Function Timeout | Increase `maxDuration` |
-| Edge compatibility errors | Use Edge-compatible APIs |
-| Bundle size exceeded | Configure externals |
+| 문제 | 해결 |
+|------|------|
+| Function Timeout | `maxDuration` 증가 |
+| Edge 호환성 오류 | Edge 호환 API 사용 |
+| 번들 크기 초과 | externals 설정 |
 
 ```bash
-vercel dev      # Local simulation
-vercel logs     # Check logs
-vercel env ls   # Check environment variables
+vercel dev      # 로컬 시뮬레이션
+vercel logs     # 로그 확인
+vercel env ls   # 환경 변수 확인
 ```
 
 ---
 
-## Related Documentation
+## 관련 문서
 
-- [Deployment Guide](./index.md)
+- [배포 가이드](./index.md)

package/templates/hono/docs/guides/conventions.md

@@ -1,18 +1,18 @@
-# Code Conventions
+# 코드 컨벤션
 
-> Code writing rules for Hono projects
+> Hono 프로젝트 코드 작성 규칙
 
 ---
 
 <naming>
 
-## File Naming
+## 파일 네이밍
 
-| Type | Rule | Example |
-|------|------|---------|
-| **General Files** | kebab-case | `user-service.ts`, `auth-middleware.ts` |
-| **Route Files** | kebab-case | `users.ts`, `posts.ts` |
-| **Type Files** | kebab-case | `user-types.ts`, `api-types.ts` |
+| 타입 | 규칙 | 예시 |
+|------|------|------|
+| **일반 파일** | kebab-case | `user-service.ts`, `auth-middleware.ts` |
+| **Route 파일** | kebab-case | `users.ts`, `posts.ts` |
+| **타입 파일** | kebab-case | `user-types.ts`, `api-types.ts` |
 
 </naming>
 
@@ -20,39 +20,39 @@
 
 <typescript>
 
-## TypeScript Rules
+## TypeScript 규칙
 
-| Rule | Description | Example |
-|------|-------------|---------|
-| **Function Declaration** | const functions, explicit return types | `const fn = (): ReturnType => {}` |
-| **Type Definition** | interface (objects), type (unions) | `interface User {}`, `type Status = 'a' \| 'b'` |
-| **No any** | Use unknown instead | `const data: unknown = JSON.parse(str)` |
-| **Import Types** | Separate type imports | `import type { User } from '@/types'` |
+| 규칙 | 설명 | 예시 |
+|------|------|------|
+| **함수 선언** | const 함수, 명시적 return type | `const fn = (): ReturnType => {}` |
+| **타입 정의** | interface (객체), type (유니온) | `interface User {}`, `type Status = 'a' \| 'b'` |
+| **any 금지** | unknown 사용 | `const data: unknown = JSON.parse(str)` |
+| **Import 타입** | type import 분리 | `import type { User } from '@/types'` |
 
-## Patterns
+## 패턴
 
 ```typescript
-// ✅ const function with explicit type
+// ✅ const 함수, 명시적 타입
 const getUserById = async (id: string): Promise<User | null> => {
   return prisma.user.findUnique({ where: { id } })
 }
 
-// ✅ Even simple functions should have explicit types
+// ✅ 간단한 함수도 명시적 타입
 const formatDate = (date: Date): string => {
   return date.toISOString()
 }
 
-// ✅ No any → use unknown
+// ✅ any 금지 → unknown 사용
 const parseJSON = (data: string): unknown => {
   return JSON.parse(data)
 }
 
-// ❌ Don't use any
+// ❌ any 사용 금지
 const badParse = (data: string): any => {  // ❌
   return JSON.parse(data)
 }
 
-// ❌ Don't use function keyword
+// ❌ function 키워드 금지
 function badFunction() {  // ❌
   return 'use const arrow function'
 }
@@ -64,7 +64,7 @@ function badFunction() {  // ❌
 
 <imports>
 
-## Import Order
+## Import 순서
 
 ```typescript
 // 1. External libraries
@@ -88,12 +88,12 @@ import type { Context } from 'hono'
 
 <comments>
 
-## Korean Comments (Per Code Block)
+## 한글 주석 (묶음 단위)
 
 ```typescript
-// ✅ Comments per code block
+// ✅ 코드 묶음 단위 주석
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Retrieve users
+// 사용자 조회
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 users.get('/', async (c) => {
   const users = await prisma.user.findMany()
@@ -108,7 +108,7 @@ users.get('/:id', async (c) => {
 })
 
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Create/Update users
+// 사용자 생성/수정
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 users.post('/', zValidator('json', createUserSchema), async (c) => {
   const data = c.req.valid('json')
@@ -118,10 +118,10 @@ users.post('/', zValidator('json', createUserSchema), async (c) => {
 ```
 
 ```typescript
-// ❌ Granular comments (prohibited)
-users.get('/', async (c) => {  // Retrieve user list
-  const users = await prisma.user.findMany()  // Query from DB
-  return c.json({ users })  // Return JSON
+// ❌ 세세한 주석 (금지)
+users.get('/', async (c) => {  // 사용자 목록 조회
+  const users = await prisma.user.findMany()  // DB에서 조회
+  return c.json({ users })  // JSON 반환
 })
 ```
 
@@ -131,14 +131,14 @@ users.get('/', async (c) => {  // Retrieve user list
 
 <error_handling>
 
-## Error Handling Patterns
+## 에러 처리 패턴
 
-### Using HTTPException
+### HTTPException 사용
 
 ```typescript
 import { HTTPException } from 'hono/http-exception'
 
-// ✅ Use HTTPException
+// ✅ HTTPException 사용
 users.get('/:id', async (c) => {
   const id = c.req.param('id')
   const user = await prisma.user.findUnique({ where: { id } })
@@ -150,7 +150,7 @@ users.get('/:id', async (c) => {
   return c.json({ user })
 })
 
-// ❌ Don't use generic Error
+// ❌ 일반 Error 사용 금지
 users.get('/:id', async (c) => {
   const id = c.req.param('id')
   const user = await prisma.user.findUnique({ where: { id } })
@@ -163,7 +163,7 @@ users.get('/:id', async (c) => {
 })
 ```
 
-### Global Error Handler
+### 전역 에러 핸들러
 
 ```typescript
 // src/index.ts
@@ -204,7 +204,7 @@ app.notFound((c) => {
 })
 ```
 
-### Custom Error Classes
+### 커스텀 에러 클래스
 
 ```typescript
 // lib/errors.ts
@@ -228,7 +228,7 @@ export class UnauthorizedError extends HTTPException {
   }
 }
 
-// Usage
+// 사용
 import { NotFoundError } from '@/lib/errors'
 
 users.get('/:id', async (c) => {
@@ -244,15 +244,15 @@ users.get('/:id', async (c) => {
 
 <validation>
 
-## Validation Patterns
+## Validation 패턴
 
-### Using zValidator
+### zValidator 사용
 
 ```typescript
 import { zValidator } from '@hono/zod-validator'
 import { z } from 'zod'
 
-// ✅ Use zValidator
+// ✅ zValidator 사용
 const createUserSchema = z.object({
   name: z.string().min(1).trim(),
   email: z.email(),
@@ -260,12 +260,12 @@ const createUserSchema = z.object({
 })
 
 users.post('/', zValidator('json', createUserSchema), async (c) => {
-  const data = c.req.valid('json')  // Type-safe
+  const data = c.req.valid('json')  // 타입 안전
   const user = await prisma.user.create({ data })
   return c.json({ user }, 201)
 })
 
-// ❌ Don't manually validate
+// ❌ 수동 검증 금지
 users.post('/', async (c) => {
   const body = await c.req.json()
 
@@ -278,7 +278,7 @@ users.post('/', async (c) => {
 })
 ```
 
-### Multiple Validators
+### 여러 Validator
 
 ```typescript
 // Query Params
@@ -306,17 +306,17 @@ users.post('/', zValidator('json', createUserSchema), (c) => {
 
 <examples>
 
-## File Naming Examples
+## 파일명 예시
 
-| Type | ❌ Incorrect | ✅ Correct |
-|------|-------------|-----------|
+| 타입 | ❌ 잘못된 예시 | ✅ 올바른 예시 |
+|------|---------------|---------------|
 | Route | `Users.ts` | `users.ts` |
 | Service | `userService.ts` | `user-service.ts` |
 | Middleware | `authMiddleware.ts` | `auth-middleware.ts` |
 | Utility | `formatUtils.ts` | `format-utils.ts` |
 | Type | `UserTypes.ts` | `user-types.ts` |
 
-## Directory Structure
+## 디렉토리 구조
 
 ```
 src/
@@ -325,19 +325,19 @@ src/
 │   ├── posts.ts           # /posts/*
 │   └── auth.ts            # /auth/*
 ├── middleware/
-│   ├── auth.ts            # Authentication middleware
-│   ├── logger.ts          # Logging middleware
-│   └── cors.ts            # CORS middleware
+│   ├── auth.ts            # 인증 미들웨어
+│   ├── logger.ts          # 로깅 미들웨어
+│   └── cors.ts            # CORS 미들웨어
 ├── services/
-│   ├── user-service.ts    # User business logic
-│   └── post-service.ts    # Post business logic
+│   ├── user-service.ts    # 사용자 비즈니스 로직
+│   └── post-service.ts    # 게시글 비즈니스 로직
 ├── lib/
-│   ├── prisma.ts          # Prisma client
-│   ├── env.ts             # Environment variables
-│   └── errors.ts          # Custom errors
+│   ├── prisma.ts          # Prisma 클라이언트
+│   ├── env.ts             # 환경 변수
+│   └── errors.ts          # 커스텀 에러
 └── types/
-    ├── user-types.ts      # User types
-    └── api-types.ts       # API types
+    ├── user-types.ts      # 사용자 타입
+    └── api-types.ts       # API 타입
 ```
 
 </examples>

package/templates/hono/docs/guides/env-setup.md

@@ -1,6 +1,6 @@
-# Environment Variables
+# 환경 변수 설정
 
-> Managing Hono environment variables (Node.js, Cloudflare Workers)
+> Hono 환경 변수 관리 (Node.js, Cloudflare Workers)
 
 <instructions>
 @../library/t3-env/index.md
@@ -10,9 +10,9 @@
 
 <runtime_differences>
 
-| Runtime | Environment Access | Use Case |
-|---------|-------------------|----------|
-| **Node.js** | `process.env.*` | General server |
+| 런타임 | 환경 변수 접근 | 용도 |
+|--------|---------------|------|
+| **Node.js** | `process.env.*` | 일반 서버 |
 | **Cloudflare Workers** | `c.env.*` (Bindings) | Edge Runtime |
 | **Deno** | `Deno.env.get()` | Deno Runtime |
 | **Bun** | `process.env.*` | Bun Runtime |
@@ -23,22 +23,22 @@
 
 <file_structure>
 
-## Environment File Structure
+## 환경 파일 구조
 
 ```
-├── .env                    # Defaults (commit YES)
-├── .env.development        # Development (commit YES)
-├── .env.production         # Production (commit YES)
-├── .env.local              # Local override (commit NO)
-└── src/lib/env.ts          # Validation & types (t3-env)
+├── .env                    # 기본 (커밋 O)
+├── .env.development        # 개발 (커밋 O)
+├── .env.production         # 프로덕션 (커밋 O)
+├── .env.local              # 로컬 오버라이드 (커밋 X)
+└── src/lib/env.ts          # 검증 및 타입 (t3-env)
 ```
 
-| Priority | File | Description |
-|----------|------|-------------|
-| 1 | `.env.{mode}.local` | Highest priority (gitignore) |
-| 2 | `.env.local` | Local override |
-| 3 | `.env.{mode}` | Environment-specific |
-| 4 | `.env` | Defaults |
+| 우선순위 | 파일 | 설명 |
+|----------|------|------|
+| 1 | `.env.{mode}.local` | 최우선 (gitignore) |
+| 2 | `.env.local` | 로컬 오버라이드 |
+| 3 | `.env.{mode}` | 환경별 설정 |
+| 4 | `.env` | 기본 설정 |
 
 </file_structure>
 
@@ -46,9 +46,9 @@
 
 <patterns>
 
-## Environment File Examples
+## 환경 파일 예시
 
-### .env.local (gitignore, secrets)
+### .env.local (gitignore, 시크릿)
 
 ```env
 DATABASE_URL=postgresql://user:password@localhost:5432/myapp
@@ -72,9 +72,9 @@ PORT=8080
 LOG_LEVEL=info
 ```
 
-## Node.js Environment Variables
+## Node.js 환경 변수
 
-### Type-safe Environment Variables (t3-env)
+### 타입 안전한 환경 변수 (t3-env)
 
 ```typescript
 // src/lib/env.ts
@@ -94,7 +94,7 @@ export const env = createEnv({
 })
 ```
 
-### Usage Example
+### 사용 예시
 
 ```typescript
 // src/index.ts
@@ -116,9 +116,9 @@ export default {
 }
 ```
 
-## Cloudflare Workers Environment Variables
+## Cloudflare Workers 환경 변수
 
-### Bindings Type Definition
+### Bindings 타입 정의
 
 ```typescript
 // src/types/index.ts
@@ -139,12 +139,12 @@ compatibility_date = "2024-01-01"
 [vars]
 NODE_ENV = "production"
 
-# Set secrets with wrangler secret put command
+# 시크릿은 wrangler secret put 명령어로 설정
 # wrangler secret put DATABASE_URL
 # wrangler secret put JWT_SECRET
 ```
 
-### Usage Example
+### 사용 예시
 
 ```typescript
 // src/index.ts
@@ -154,7 +154,7 @@ import type { Bindings } from './types'
 const app = new Hono<{ Bindings: Bindings }>()
 
 app.get('/', (c) => {
-  // Access environment variables via c.env
+  // c.env를 통해 환경 변수 접근
   const dbUrl = c.env.DATABASE_URL
   const jwtSecret = c.env.JWT_SECRET
 
@@ -167,7 +167,7 @@ app.get('/', (c) => {
 export default app
 ```
 
-### Using in Middleware
+### 미들웨어에서 사용
 
 ```typescript
 // src/middleware/auth.ts
@@ -186,26 +186,26 @@ export const authMiddleware = createMiddleware<{
   const token = c.req.header('Authorization')?.replace('Bearer ', '')
   if (!token) throw new HTTPException(401, { message: 'Unauthorized' })
 
-  // Use JWT Secret
+  // JWT Secret 사용
   const jwtSecret = c.env.JWT_SECRET
-  // JWT verification logic...
+  // JWT 검증 로직...
 
   c.set('userId', 'user-id')
   await next()
 })
 ```
 
-## Cloudflare Workers Secrets Management
+## Cloudflare Workers 시크릿 설정
 
 ```bash
-# Add secret
+# 시크릿 추가
 wrangler secret put DATABASE_URL
 wrangler secret put JWT_SECRET
 
-# List secrets
+# 시크릿 목록 확인
 wrangler secret list
 
-# Delete secret
+# 시크릿 삭제
 wrangler secret delete DATABASE_URL
 ```
 
@@ -218,14 +218,14 @@ wrangler secret delete DATABASE_URL
 ## .gitignore
 
 ```gitignore
-# Contains secrets (NEVER commit)
+# 시크릿 포함 (절대 커밋 X)
 .env.local
 .env.*.local
 
 # Cloudflare Workers
 .dev.vars
 
-# Public config (commit OK)
+# 공개 설정 (커밋 O)
 !.env
 !.env.development
 !.env.production
@@ -237,7 +237,7 @@ wrangler secret delete DATABASE_URL
 
 <typescript_types>
 
-## TypeScript Types
+## TypeScript 타입
 
 ### Node.js
 
@@ -286,13 +286,13 @@ export type Bindings = {
 
 <best_practices>
 
-| Principle | Description |
-|-----------|-------------|
-| **Separate Secrets** | Store secrets only in `.env.local`, never commit |
-| **Type Safety** | Validate with t3-env or Zod |
-| **Defaults** | Set safe defaults in `.env` |
-| **Documentation** | Provide required variables list via `.env.example` |
-| **Runtime Differences** | Node.js uses `process.env`, Cloudflare uses `c.env` |
+| 원칙 | 설명 |
+|------|------|
+| **시크릿 분리** | `.env.local`에만 시크릿 저장, 커밋 금지 |
+| **타입 안전성** | t3-env 또는 Zod로 검증 |
+| **기본값** | `.env`에 안전한 기본값 설정 |
+| **문서화** | `.env.example` 파일로 필수 변수 목록 제공 |
+| **런타임별 차이** | Node.js는 `process.env`, Cloudflare는 `c.env` |
 
 </best_practices>
 
@@ -300,7 +300,7 @@ export type Bindings = {
 
 <cloudflare_specific>
 
-## Cloudflare Workers Additional Features
+## Cloudflare Workers 추가 기능
 
 ### KV Namespace
 
@@ -310,7 +310,7 @@ export type Bindings = {
 binding = "MY_KV"
 id = "your-kv-id"
 
-// Usage
+// 사용
 app.get('/cache/:key', async (c) => {
   const key = c.req.param('key')
   const value = await c.env.MY_KV.get(key)
@@ -327,7 +327,7 @@ binding = "DB"
 database_name = "my-database"
 database_id = "your-db-id"
 
-// Usage
+// 사용
 app.get('/users', async (c) => {
   const { results } = await c.env.DB.prepare('SELECT * FROM users').all()
   return c.json({ users: results })