@kood/claude-code 0.3.6 → 0.3.8

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

@@ -1,18 +1,18 @@
-# 코드 컨벤션
+# Code Conventions
 
-> Hono 프로젝트 코드 작성 규칙
+> Code writing rules for Hono projects
 
 ---
 
 <naming>
 
-## 파일 네이밍
+## File Naming
 
-| 타입 | 규칙 | 예시 |
-|------|------|------|
-| **일반 파일** | kebab-case | `user-service.ts`, `auth-middleware.ts` |
-| **Route 파일** | kebab-case | `users.ts`, `posts.ts` |
-| **타입 파일** | kebab-case | `user-types.ts`, `api-types.ts` |
+| 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` |
 
 </naming>
 
@@ -20,39 +20,39 @@
 
 <typescript>
 
-## TypeScript 규칙
+## TypeScript Rules
 
-| 규칙 | 설명 | 예시 |
-|------|------|------|
-| **함수 선언** | 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'` |
+| 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'` |
 
-## 패턴
+## Patterns
 
 ```typescript
-// ✅ const 함수, 명시적 타입
+// ✅ const function with explicit type
 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()
 }
 
-// ✅ any 금지 → unknown 사용
+// ✅ No any → use unknown
 const parseJSON = (data: string): unknown => {
   return JSON.parse(data)
 }
 
-// ❌ any 사용 금지
+// ❌ Don't use any
 const badParse = (data: string): any => {  // ❌
   return JSON.parse(data)
 }
 
-// ❌ function 키워드 금지
+// ❌ Don't use function keyword
 function badFunction() {  // ❌
   return 'use const arrow function'
 }
@@ -64,7 +64,7 @@ function badFunction() {  // ❌
 
 <imports>
 
-## Import 순서
+## Import Order
 
 ```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
-// ❌ 세세한 주석 (금지)
-users.get('/', async (c) => {  // 사용자 목록 조회
-  const users = await prisma.user.findMany()  // DB에서 조회
-  return c.json({ users })  // JSON 반환
+// ❌ 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
 })
 ```
 
@@ -131,14 +131,14 @@ users.get('/', async (c) => {  // 사용자 목록 조회
 
 <error_handling>
 
-## 에러 처리 패턴
+## Error Handling Patterns
 
-### HTTPException 사용
+### Using HTTPException
 
 ```typescript
 import { HTTPException } from 'hono/http-exception'
 
-// ✅ HTTPException 사용
+// ✅ Use 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 })
 })
 
-// ❌ 일반 Error 사용 금지
+// ❌ Don't use generic 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 패턴
+## Validation Patterns
 
-### zValidator 사용
+### Using zValidator
 
 ```typescript
 import { zValidator } from '@hono/zod-validator'
 import { z } from 'zod'
 
-// ✅ zValidator 사용
+// ✅ Use 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')  // 타입 안전
+  const data = c.req.valid('json')  // Type-safe
   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) => {
 })
 ```
 
-### 여러 Validator
+### Multiple Validators
 
 ```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            # 인증 미들웨어
-│   ├── logger.ts          # 로깅 미들웨어
-│   └── cors.ts            # CORS 미들웨어
+│   ├── auth.ts            # Authentication middleware
+│   ├── logger.ts          # Logging middleware
+│   └── cors.ts            # CORS middleware
 ├── services/
-│   ├── user-service.ts    # 사용자 비즈니스 로직
-│   └── post-service.ts    # 게시글 비즈니스 로직
+│   ├── user-service.ts    # User business logic
+│   └── post-service.ts    # Post business logic
 ├── lib/
-│   ├── prisma.ts          # Prisma 클라이언트
-│   ├── env.ts             # 환경 변수
-│   └── errors.ts          # 커스텀 에러
+│   ├── prisma.ts          # Prisma client
+│   ├── env.ts             # Environment variables
+│   └── errors.ts          # Custom errors
 └── types/
-    ├── user-types.ts      # 사용자 타입
-    └── api-types.ts       # API 타입
+    ├── user-types.ts      # User types
+    └── api-types.ts       # API types
 ```
 
 </examples>

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

@@ -1,6 +1,6 @@
-# 환경 변수 설정
+# Environment Variables
 
-> Hono 환경 변수 관리 (Node.js, Cloudflare Workers)
+> Managing Hono environment variables (Node.js, Cloudflare Workers)
 
 <instructions>
 @../library/t3-env/index.md
@@ -10,9 +10,9 @@
 
 <runtime_differences>
 
-| 런타임 | 환경 변수 접근 | 용도 |
-|--------|---------------|------|
-| **Node.js** | `process.env.*` | 일반 서버 |
+| Runtime | Environment Access | Use Case |
+|---------|-------------------|----------|
+| **Node.js** | `process.env.*` | General server |
 | **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                    # 기본 (커밋 O)
-├── .env.development        # 개발 (커밋 O)
-├── .env.production         # 프로덕션 (커밋 O)
-├── .env.local              # 로컬 오버라이드 (커밋 X)
-└── src/lib/env.ts          # 검증 및 타입 (t3-env)
+├── .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)
 ```
 
-| 우선순위 | 파일 | 설명 |
-|----------|------|------|
-| 1 | `.env.{mode}.local` | 최우선 (gitignore) |
-| 2 | `.env.local` | 로컬 오버라이드 |
-| 3 | `.env.{mode}` | 환경별 설정 |
-| 4 | `.env` | 기본 설정 |
+| Priority | File | Description |
+|----------|------|-------------|
+| 1 | `.env.{mode}.local` | Highest priority (gitignore) |
+| 2 | `.env.local` | Local override |
+| 3 | `.env.{mode}` | Environment-specific |
+| 4 | `.env` | Defaults |
 
 </file_structure>
 
@@ -46,9 +46,9 @@
 
 <patterns>
 
-## 환경 파일 예시
+## Environment File Examples
 
-### .env.local (gitignore, 시크릿)
+### .env.local (gitignore, secrets)
 
 ```env
 DATABASE_URL=postgresql://user:password@localhost:5432/myapp
@@ -72,9 +72,9 @@ PORT=8080
 LOG_LEVEL=info
 ```
 
-## Node.js 환경 변수
+## Node.js Environment Variables
 
-### 타입 안전한 환경 변수 (t3-env)
+### Type-safe Environment Variables (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 환경 변수
+## Cloudflare Workers Environment Variables
 
-### Bindings 타입 정의
+### Bindings Type Definition
 
 ```typescript
 // src/types/index.ts
@@ -139,12 +139,12 @@ compatibility_date = "2024-01-01"
 [vars]
 NODE_ENV = "production"
 
-# 시크릿은 wrangler secret put 명령어로 설정
+# Set secrets with wrangler secret put command
 # 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) => {
-  // c.env를 통해 환경 변수 접근
+  // Access environment variables via 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' })
 
-  // JWT Secret 사용
+  // Use JWT Secret
   const jwtSecret = c.env.JWT_SECRET
-  // JWT 검증 로직...
+  // JWT verification logic...
 
   c.set('userId', 'user-id')
   await next()
 })
 ```
 
-## Cloudflare Workers 시크릿 설정
+## Cloudflare Workers Secrets Management
 
 ```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
-# 시크릿 포함 (절대 커밋 X)
+# Contains secrets (NEVER commit)
 .env.local
 .env.*.local
 
 # Cloudflare Workers
 .dev.vars
 
-# 공개 설정 (커밋 O)
+# Public config (commit OK)
 !.env
 !.env.development
 !.env.production
@@ -237,7 +237,7 @@ wrangler secret delete DATABASE_URL
 
 <typescript_types>
 
-## TypeScript 타입
+## TypeScript Types
 
 ### Node.js
 
@@ -286,13 +286,13 @@ export type Bindings = {
 
 <best_practices>
 
-| 원칙 | 설명 |
-|------|------|
-| **시크릿 분리** | `.env.local`에만 시크릿 저장, 커밋 금지 |
-| **타입 안전성** | t3-env 또는 Zod로 검증 |
-| **기본값** | `.env`에 안전한 기본값 설정 |
-| **문서화** | `.env.example` 파일로 필수 변수 목록 제공 |
-| **런타임별 차이** | Node.js는 `process.env`, Cloudflare는 `c.env` |
+| 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` |
 
 </best_practices>
 
@@ -300,7 +300,7 @@ export type Bindings = {
 
 <cloudflare_specific>
 
-## Cloudflare Workers 추가 기능
+## Cloudflare Workers Additional Features
 
 ### 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
 
-> Hono 프로젝트 빠른 시작
+> Quick start for Hono projects
 
 <instructions>
 @conventions.md
@@ -12,10 +12,10 @@
 
 <prerequisites>
 
-| 요구사항 | 버전 |
-|----------|------|
+| Requirement | Version |
+|-------------|---------|
 | Node.js | 18+ |
-| 패키지 관리자 | npm / yarn / pnpm |
+| Package Manager | 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 진입점
+├── index.ts           # App entry point
 ├── routes/
 │   ├── index.ts       # Root routes
 │   ├── users.ts       # /users/*
@@ -82,7 +82,7 @@ src/
     └── index.ts
 ```
 
-## App 설정
+## App Configuration
 
 ```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 검증 로직
+    // JWT verification logic
     // 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` | 개발 서버 시작 |
-| `npm run build` | 프로덕션 빌드 |
-| `npm start` | 프로덕션 서버 실행 |
-| `npm run deploy` | 배포 (Cloudflare Workers 등) |
+| `npm run dev` | Start development server |
+| `npm run build` | Build for production |
+| `npm start` | Run production server |
+| `npm run deploy` | Deploy (Cloudflare Workers, etc.) |
 
 </commands>
 
@@ -218,13 +218,13 @@ export const authMiddleware = createMiddleware<{ Variables: Variables }>(
 
 <next_steps>
 
-| 문서 | 내용 |
-|------|------|
-| [conventions.md](./conventions.md) | 코드 컨벤션, 파일명 규칙 |
-| [env-setup.md](./env-setup.md) | 환경 변수 설정 |
-| [../library/hono/](../library/hono/) | Hono API 상세 가이드 |
-| [../library/prisma/](../library/prisma/) | Prisma ORM 사용법 |
-| [../deployment/](../deployment/) | 배포 가이드 |
+| 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 |
 
 </next_steps>