@kood/claude-code 0.5.4 → 0.5.5

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 })

package/templates/hono/docs/guides/getting-started.md

@@ -1,6 +1,6 @@
 # Getting Started
 
-> Quick start for Hono projects
+> Hono 프로젝트 빠른 시작
 
 <instructions>
 @conventions.md
@@ -12,10 +12,10 @@
 
 <prerequisites>
 
-| Requirement | Version |
-|-------------|---------|
+| 요구사항 | 버전 |
+|----------|------|
 | Node.js | 18+ |
-| Package Manager | npm / yarn / pnpm |
+| 패키지 관리자 | npm / yarn / pnpm |
 
 </prerequisites>
 
@@ -23,13 +23,13 @@
 
 <installation>
 
-## Create Project
+## 프로젝트 생성
 
 ```bash
 # npm
 npm create hono@latest my-app
 
-# Select template
+# 템플릿 선택
 ? Which template do you want to use?
 ❯ cloudflare-workers
   nodejs
@@ -40,7 +40,7 @@ cd my-app
 npm install
 ```
 
-## Required Packages
+## 필수 패키지
 
 ```bash
 # Validation (Zod 4.x)
@@ -60,11 +60,11 @@ npm install @t3-oss/env-core
 
 <project_setup>
 
-## Project Structure
+## 프로젝트 구조
 
 ```
 src/
-├── index.ts           # App entry point
+├── index.ts           # App 진입점
 ├── routes/
 │   ├── index.ts       # Root routes
 │   ├── users.ts       # /users/*
@@ -82,7 +82,7 @@ src/
     └── index.ts
 ```
 
-## App Configuration
+## App 설정
 
 ```typescript
 // src/index.ts
@@ -101,15 +101,15 @@ type Bindings = {
 
 const app = new Hono<{ Bindings: Bindings }>()
 
-// Middleware
+// 미들웨어
 app.use('*', logger())
 app.use('*', cors())
 
-// Routes
+// 라우트
 app.route('/users', users)
 app.route('/posts', posts)
 
-// Error handler
+// 에러 핸들러
 app.onError((err, c) => {
   if (err instanceof HTTPException) {
     return c.json({ error: err.message }, err.status)
@@ -123,7 +123,7 @@ app.notFound((c) => c.json({ error: 'Not Found' }, 404))
 export default app
 ```
 
-## Route Example
+## 라우트 예시
 
 ```typescript
 // src/routes/users.ts
@@ -171,7 +171,7 @@ users.post('/', zValidator('json', createUserSchema), async (c) => {
 export default users
 ```
 
-## Middleware Example
+## 미들웨어 예시
 
 ```typescript
 // src/middleware/auth.ts
@@ -190,7 +190,7 @@ export const authMiddleware = createMiddleware<{ Variables: Variables }>(
       throw new HTTPException(401, { message: 'Unauthorized' })
     }
 
-    // JWT verification logic
+    // JWT 검증 로직
     // const decoded = await verifyJWT(token)
 
     c.set('userId', 'user-id')
@@ -207,10 +207,10 @@ export const authMiddleware = createMiddleware<{ Variables: Variables }>(
 
 | Command | Description |
 |---------|-------------|
-| `npm run dev` | Start development server |
-| `npm run build` | Build for production |
-| `npm start` | Run production server |
-| `npm run deploy` | Deploy (Cloudflare Workers, etc.) |
+| `npm run dev` | 개발 서버 시작 |
+| `npm run build` | 프로덕션 빌드 |
+| `npm start` | 프로덕션 서버 실행 |
+| `npm run deploy` | 배포 (Cloudflare Workers 등) |
 
 </commands>
 
@@ -218,13 +218,13 @@ export const authMiddleware = createMiddleware<{ Variables: Variables }>(
 
 <next_steps>
 
-| Document | Content |
-|----------|---------|
-| [conventions.md](./conventions.md) | Code conventions, file naming rules |
-| [env-setup.md](./env-setup.md) | Environment variable setup |
-| [../library/hono/](../library/hono/) | Detailed Hono API guide |
-| [../library/prisma/](../library/prisma/) | Prisma ORM usage |
-| [../deployment/](../deployment/) | Deployment guides |
+| 문서 | 내용 |
+|------|------|
+| [conventions.md](./conventions.md) | 코드 컨벤션, 파일명 규칙 |
+| [env-setup.md](./env-setup.md) | 환경 변수 설정 |
+| [../library/hono/](../library/hono/) | Hono API 상세 가이드 |
+| [../library/prisma/](../library/prisma/) | Prisma ORM 사용법 |
+| [../deployment/](../deployment/) | 배포 가이드 |
 
 </next_steps>
 

package/templates/hono/docs/library/hono/error-handling.md

@@ -1,6 +1,6 @@
-# Hono Error Handling
+# Hono 에러 처리
 
-> Systematic error management with HTTPException and onError
+> HTTPException과 onError로 체계적 에러 관리
 
 <patterns>
 
@@ -20,7 +20,7 @@ app.get('/users/:id', async (c) => {
 })
 ```
 
-## Global Handler
+## 글로벌 핸들러
 
 ```typescript
 import { Hono } from 'hono'
@@ -43,7 +43,7 @@ app.notFound((c) => {
 })
 ```
 
-## Detailed Response
+## 상세 응답
 
 ```typescript
 app.onError((err, c) => {
@@ -69,7 +69,7 @@ app.onError((err, c) => {
 })
 ```
 
-## Custom Error Classes
+## 커스텀 에러 클래스
 
 ```typescript
 // lib/errors.ts
@@ -95,7 +95,7 @@ export class ConflictError extends HTTPException {
 ```
 
 ```typescript
-// Usage
+// 사용
 import { NotFoundError, ConflictError } from '@/lib/errors'
 
 app.get('/users/:id', async (c) => {
@@ -117,13 +117,13 @@ app.post('/users', async (c) => {
 
 <status_codes>
 
-| Code | Usage |
-|------|-------|
+| 코드 | 사용 |
+|-----|------|
 | 400 | Invalid input |
-| 401 | Unauthorized (authentication required) |
-| 403 | Access denied (insufficient permissions) |
+| 401 | Unauthorized (인증 필요) |
+| 403 | Access denied (권한 없음) |
 | 404 | Not found |
-| 409 | Already exists (conflict) |
+| 409 | Already exists (충돌) |
 | 422 | Validation failed |
 | 429 | Rate limit exceeded |
 

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

@@ -1,6 +1,6 @@
 # Hono
 
-> Ultra-lightweight framework based on Web Standards
+> Web Standards 기반 초경량 프레임워크
 
 <references>
 @middleware.md
@@ -21,7 +21,7 @@ npm install hono
 
 <quick_patterns>
 
-## Routes
+## 라우트
 
 ```typescript
 import { Hono } from 'hono'
@@ -39,7 +39,7 @@ app.get('/posts/:postId/comments/:commentId', (c) => {
 export default app
 ```
 
-## Route Groups
+## 라우트 그룹
 
 ```typescript
 const users = new Hono()
@@ -99,7 +99,7 @@ type Variables = {
 
 const app = new Hono<{ Bindings: Bindings; Variables: Variables }>()
 
-// Environment variables
+// 환경 변수
 app.get('/', (c) => {
   const dbUrl = c.env.DATABASE_URL
   return c.json({ connected: true })

package/templates/hono/docs/library/hono/middleware.md

@@ -1,10 +1,10 @@
-# Hono Middleware
+# Hono 미들웨어
 
-> Request/Response processing pipeline
+> 요청/응답 처리 파이프라인
 
 <patterns>
 
-## Basic Usage
+## 기본 사용법
 
 ```typescript
 import { Hono } from 'hono'
@@ -13,25 +13,25 @@ import { cors } from 'hono/cors'
 
 const app = new Hono()
 
-app.use(logger())           // All routes
-app.use('/api/*', cors())   // Specific path
+app.use(logger())           // 모든 라우트
+app.use('/api/*', cors())   // 특정 경로
 
-// Execution order
+// 실행 순서
 app.use(async (c, next) => {
-  console.log('1. Before request')
+  console.log('1. 요청 전')
   await next()
-  console.log('4. After response')
+  console.log('4. 응답 후')
 })
 
 app.use(async (c, next) => {
-  console.log('2. Before request')
+  console.log('2. 요청 전')
   await next()
-  console.log('3. After response')
+  console.log('3. 응답 후')
 })
-// Output: 1 → 2 → handler → 3 → 4
+// 출력: 1 → 2 → handler → 3 → 4
 ```
 
-## Custom Middleware
+## 커스텀 미들웨어
 
 ```typescript
 import { createMiddleware } from 'hono/factory'
@@ -51,13 +51,13 @@ export const authMiddleware = createMiddleware<Env>(async (c, next) => {
   await next()
 })
 
-// Usage
+// 사용
 app.get('/me', authMiddleware, (c) => {
   return c.json({ userId: c.get('userId') })
 })
 ```
 
-## Type-safe Middleware
+## 타입 안전 미들웨어
 
 ```typescript
 import { Hono } from 'hono'
@@ -84,8 +84,8 @@ app.use(dbMiddleware)
 app.use(authMiddleware)
 
 app.get('/users', (c) => {
-  const db = c.get('db')      // Database type
-  const user = c.get('user')  // User | null type
+  const db = c.get('db')      // Database 타입
+  const user = c.get('user')  // User | null 타입
   return c.json({ users: [] })
 })
 ```
@@ -96,8 +96,8 @@ app.get('/users', (c) => {
 
 <builtin>
 
-| Middleware | Usage |
-|------------|-------|
+| 미들웨어 | 사용 |
+|---------|------|
 | **logger** | `app.use(logger())` |
 | **cors** | `app.use('/api/*', cors({ origin: ['https://example.com'] }))` |
 | **bearerAuth** | `app.use('/api/*', bearerAuth({ verifyToken: async (t) => t === 'valid' }))` |

package/templates/hono/docs/library/hono/rpc.md

@@ -1,10 +1,10 @@
 # Hono RPC Client
 
-> Type-safe API calls
+> Type-safe API 호출
 
 <patterns>
 
-## Server Setup
+## 서버 설정
 
 ```typescript
 // server.ts
@@ -26,11 +26,11 @@ const app = new Hono()
     }
   )
 
-export type AppType = typeof app  // ✅ Required
+export type AppType = typeof app  // ✅ 필수
 export default app
 ```
 
-## Client
+## 클라이언트
 
 ```typescript
 // client.ts
@@ -75,7 +75,7 @@ const client = hc<AppType>('http://localhost:8787/', {
 })
 ```
 
-## Type Inference
+## 타입 추론
 
 ```typescript
 import type { InferRequestType, InferResponseType } from 'hono/client'
@@ -87,7 +87,7 @@ type UserResponse = InferResponseType<typeof client.users[':id'].$get>
 // { id: string; name: string }
 ```
 
-## CRUD Wrapper
+## CRUD 래퍼
 
 ```typescript
 const userApi = {
@@ -117,7 +117,7 @@ const userApi = {
   },
 }
 
-// URL generation
+// URL 생성
 const url = client.posts[':id'].$url({ param: { id: '123' } })
 console.log(url.pathname) // /posts/123
 ```

package/templates/hono/docs/library/hono/validation.md

@@ -1,6 +1,6 @@
-# Hono + Zod Validation
+# Hono + Zod 검증
 
-> Type-safe request validation with @hono/zod-validator
+> @hono/zod-validator로 타입 안전 요청 검증
 
 <setup>
 ```bash
@@ -54,7 +54,7 @@ app.get('/users/:id',
   }
 )
 
-// Header (lowercase!)
+// Header (소문자!)
 app.get('/api/protected',
   zValidator('header', z.object({ 'x-api-key': z.string().uuid() })),
   (c) => {
@@ -63,7 +63,7 @@ app.get('/api/protected',
 )
 ```
 
-## Multiple Validators
+## 복합 검증
 
 ```typescript
 app.post(
@@ -80,7 +80,7 @@ app.post(
 )
 ```
 
-## Custom Errors
+## 커스텀 에러
 
 ```typescript
 app.post(
@@ -100,7 +100,7 @@ app.post(
 )
 ```
 
-## Reusable Schemas
+## 재사용 스키마
 
 ```typescript
 // validators/user.ts