@kood/claude-code 0.5.4 → 0.5.6

package/templates/hono/CLAUDE.md

@@ -1,6 +1,6 @@
 # CLAUDE.md - Hono
 
-> Ultra-lightweight framework based on Web Standards
+> Web Standards 기반 초경량 프레임워크
 
 <instructions>
 @../../commands/git.md
@@ -15,12 +15,12 @@
 
 <forbidden>
 
-| Category | Prohibited |
-|----------|------------|
-| **Git** | `Generated with Claude Code`, `🤖`, `Co-Authored-By:`, multi-line commits, emojis |
-| **Prisma** | Auto-run `db push/migrate/generate`, arbitrary schema changes |
-| **API** | Manual validation/auth in handlers, throwing generic Error |
-| **Search** | grep, rg, find |
+| 분류 | 금지 |
+|------|------|
+| **Git** | `Generated with Claude Code`, `🤖`, `Co-Authored-By:`, 여러 줄, 이모지 |
+| **Prisma** | `db push/migrate/generate` 자동 실행, schema 임의 변경 |
+| **API** | handler 내 수동 검증/인증, 일반 Error throw |
+| **검색** | grep, rg, find |
 
 </forbidden>
 
@@ -28,15 +28,15 @@
 
 <required>
 
-| Task | Required |
-|------|----------|
-| Before work | Read related docs (API→hono, DB→prisma) |
-| Document search | serena mcp (document indexing/search, context length optimization) |
-| Code search | ast-grep |
-| Complex tasks | Sequential Thinking MCP |
-| 3+ file changes | gemini-review |
-| Validation | zValidator, HTTPException error handling |
-| Code writing | UTF-8, Korean comments per code block, Prisma Multi-File all elements commented |
+| 작업 | 필수 |
+|------|------|
+| 작업 전 | 관련 docs 읽기 (API→hono, DB→prisma) |
+| 문서 검색 | serena mcp (문서 인덱싱/검색, context 길이 최적화) |
+| 코드 검색 | ast-grep |
+| 복잡한 작업 | Sequential Thinking MCP |
+| 3+ 파일 수정 | gemini-review |
+| Validation | zValidator, HTTPException 에러 처리 |
+| 코드 작성 | UTF-8, 코드 묶음별 한글 주석, Prisma Multi-File 모든 요소 주석 |
 
 </required>
 
@@ -44,11 +44,11 @@
 
 <tech_stack>
 
-| Technology | Version | Notes |
-|------------|---------|-------|
-| Hono | Latest | - |
+| 기술 | 버전 | 주의 |
+|------|------|------|
+| Hono | 최신 | - |
 | TypeScript | 5.x | strict |
-| Prisma | **7.x** | `prisma-client`, output required |
+| Prisma | **7.x** | `prisma-client`, output 필수 |
 | Zod | **4.x** | `z.email()`, `z.url()` |
 
 </tech_stack>
@@ -70,23 +70,23 @@ src/
 └── types/
 ```
 
-Common logic → `src/services/`, route-specific logic → individual route files
+공통 로직 → `src/services/`, 라우트별 로직 → 각 route 파일
 </structure>
 
 ---
 
 <conventions>
 
-File naming: kebab-case
-TypeScript: const declarations, explicit return types, interface (objects)/type (unions), any→unknown
-Import order: external → internal → relative paths → types
+파일명: kebab-case
+TypeScript: const 선언, 명시적 return type, interface(객체)/type(유니온), any→unknown
+Import 순서: 외부 → 내부 → 상대경로 → type
 
 Prisma Multi-File:
 ```
 prisma/schema/
 ├── +base.prisma   # datasource, generator
-├── +enum.prisma   # enums
-└── [model].prisma # per-model files (Korean comments!)
+├── +enum.prisma   # enum
+└── [model].prisma # 모델별 (한글 주석!)
 ```
 
 </conventions>
@@ -96,7 +96,7 @@ prisma/schema/
 <quick_patterns>
 
 ```typescript
-// App + Error handler
+// App + 에러 핸들러
 import { Hono } from 'hono'
 import { HTTPException } from 'hono/http-exception'
 
@@ -145,7 +145,7 @@ export const authMiddleware = createMiddleware(async (c, next) => {
   await next()
 })
 
-// Usage
+// 사용
 app.use('/api/*', authMiddleware)
 ```
 

package/templates/hono/docs/architecture.md

@@ -1,10 +1,10 @@
-# Hono Server Architecture
+# Hono 서버 아키텍처
 
-> Layer-based architecture
+> 레이어 기반 아키텍처
 
 ---
 
-## System Overview
+## 시스템 개요
 
 ```
 Client → Middleware → Routes → Validation → Services → Database
@@ -12,21 +12,21 @@ Client → Middleware → Routes → Validation → Services → Database
 
 ---
 
-## Project Structure
+## 프로젝트 구조
 
 ```
 src/
 ├── index.ts            # Entry point
-├── routes/             # Route modules
-├── middleware/         # Custom middleware
-├── validators/         # Zod schemas
-├── services/           # Business logic
+├── routes/             # 라우트 모듈
+├── middleware/         # 커스텀 미들웨어
+├── validators/         # Zod 스키마
+├── services/           # 비즈니스 로직
 │   └── user/
-│       ├── queries.ts  # Read operations
-│       └── mutations.ts # Create/Update/Delete
+│       ├── queries.ts  # 조회
+│       └── mutations.ts # 생성/수정/삭제
 ├── database/           # Prisma Client
-├── types/              # Type definitions
-└── lib/                # Utilities
+├── types/              # 타입 정의
+└── lib/                # 유틸리티
 ```
 
 ---
@@ -227,8 +227,8 @@ const data = await res.json()
 
 ## Tech Stack
 
-| Category | Technology | Version |
-|----------|------------|---------|
+| 분류 | 기술 | 버전 |
+|------|------|------|
 | Framework | Hono | latest |
 | Validation | Zod | **4.x** |
 | ORM | Prisma | **7.x** |
@@ -236,20 +236,20 @@ const data = await res.json()
 
 ---
 
-## Pattern Summary
+## 패턴 요약
 
-| Layer | Responsibility | Files |
-|-------|----------------|-------|
-| Routes | HTTP routing | `routes/*.ts` |
-| Middleware | Request/Response handling | `middleware/*.ts` |
-| Validators | Input validation | `validators/*.ts` |
-| Services | Business logic | `services/*/*.ts` |
-| Database | Data access | `database/prisma.ts` |
+| 레이어 | 역할 | 파일 |
+|--------|------|------|
+| Routes | HTTP 라우팅 | `routes/*.ts` |
+| Middleware | 요청/응답 처리 | `middleware/*.ts` |
+| Validators | 입력 검증 | `validators/*.ts` |
+| Services | 비즈니스 로직 | `services/*/*.ts` |
+| Database | 데이터 액세스 | `database/prisma.ts` |
 
 ---
 
-## Related Documentation
+## 관련 문서
 
 - [Hono](../library/hono/index.md)
 - [Prisma](../library/prisma/index.md)
-- [Cloudflare Deployment](../deployment/cloudflare.md)
+- [Cloudflare 배포](../deployment/cloudflare.md)

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

@@ -1,10 +1,10 @@
-# Nitro - Cloudflare Deployment
+# Nitro - Cloudflare 배포
 
-> Cloudflare Workers/Pages Edge deployment
+> Cloudflare Workers/Pages Edge 배포
 
 ---
 
-## Workers Configuration
+## Workers 설정
 
 ```typescript
 // nitro.config.ts
@@ -22,7 +22,7 @@ export default defineNitroConfig({
 
 ---
 
-## Pages Configuration
+## Pages 설정
 
 ```typescript
 // nitro.config.ts
@@ -65,7 +65,7 @@ bucket_name = "my-bucket"
 
 ---
 
-## Deployment
+## 배포
 
 ```bash
 wrangler login
@@ -78,7 +78,7 @@ wrangler pages deploy .output/public
 
 ---
 
-## Using Bindings
+## Bindings 사용
 
 ### D1
 
@@ -137,7 +137,7 @@ app.get("/download/:name", async (c) => {
 
 ---
 
-## Secrets
+## 시크릿
 
 ```bash
 wrangler secret put API_SECRET
@@ -146,7 +146,7 @@ wrangler secret list
 
 ---
 
-## D1 Migrations
+## D1 마이그레이션
 
 ```bash
 wrangler d1 migrations create my-database create_users
@@ -191,21 +191,21 @@ jobs:
 
 ---
 
-## Troubleshooting
+## 문제 해결
 
-| Issue | Solution |
-|-------|----------|
-| Worker size limit | Configure externals, minify |
-| D1 not found | Check wrangler.toml bindings |
-| Node.js API errors | Add `nodejs_compat` flag |
+| 문제 | 해결 |
+|------|------|
+| Worker size limit | externals 설정, minify |
+| D1 not found | wrangler.toml 바인딩 확인 |
+| Node.js API 오류 | `nodejs_compat` 플래그 |
 
 ```bash
-wrangler tail          # Real-time logs
-wrangler deploy --dry-run  # Validation
+wrangler tail          # 실시간 로그
+wrangler deploy --dry-run  # 검증
 ```
 
 ---
 
-## Related Documentation
+## 관련 문서
 
-- [Deployment Guide](./index.md)
+- [배포 가이드](./index.md)

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

@@ -1,6 +1,6 @@
-# Nitro - Docker Deployment
+# Nitro - Docker 배포
 
-> Container deployment
+> 컨테이너 배포
 
 ---
 
@@ -63,13 +63,13 @@ docs/
 
 ---
 
-## Build and Run
+## 빌드 및 실행
 
 ```bash
 docker build -t my-hono-app .
 docker run -p 3000:3000 my-hono-app
 
-# Environment variables
+# 환경 변수
 docker run -p 3000:3000 \
   -e DATABASE_URL="postgresql://..." \
   my-hono-app
@@ -119,7 +119,7 @@ docker compose down
 
 ---
 
-## Development
+## 개발용
 
 ```yaml
 # docker-compose.dev.yml
@@ -178,13 +178,13 @@ jobs:
 
 ---
 
-## Troubleshooting
+## 문제 해결
 
-| Issue | Solution |
-|-------|----------|
-| Port connection failed | Set `HOST=0.0.0.0` |
-| Permission errors | Use non-root user |
-| Out of memory | Use multi-stage build |
+| 문제 | 해결 |
+|------|------|
+| 포트 연결 실패 | `HOST=0.0.0.0` 설정 |
+| 권한 오류 | 비-root 사용자 |
+| 메모리 부족 | 멀티스테이지 빌드 |
 
 ```bash
 docker exec -it hono-app sh
@@ -194,6 +194,6 @@ docker stats hono-app
 
 ---
 
-## Related Documentation
+## 관련 문서
 
-- [Deployment Guide](./index.md)
+- [배포 가이드](./index.md)

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

@@ -1,6 +1,6 @@
-# Nitro v3 Deployment Guide
+# Nitro v3 배포 가이드
 
-> Hono + Nitro deployment
+> Hono + Nitro 배포
 
 @docker.md
 @railway.md
@@ -9,7 +9,7 @@
 
 ---
 
-## Installation
+## 설치
 
 ```bash
 npm install nitro@3
@@ -17,7 +17,7 @@ npm install nitro@3
 
 ---
 
-## Basic Configuration
+## 기본 설정
 
 ```typescript
 // nitro.config.ts
@@ -32,7 +32,7 @@ export default defineNitroConfig({
 
 ---
 
-## Entry Point
+## 엔트리포인트
 
 ```typescript
 // src/server.ts
@@ -51,19 +51,19 @@ export default app;
 ## CLI
 
 ```bash
-npx nitro dev              # Development server
-npx nitro build            # Build
-npx nitro preview          # Preview
-node .output/server/index.mjs  # Run
+npx nitro dev              # 개발 서버
+npx nitro build            # 빌드
+npx nitro preview          # 프리뷰
+node .output/server/index.mjs  # 실행
 ```
 
 ---
 
-## Preset Selection
+## Preset 선택
 
-| Preset | Usage |
-|--------|-------|
-| `node` | Node.js server, Docker |
+| Preset | 용도 |
+|--------|------|
+| `node` | Node.js 서버, Docker |
 | `cloudflare_module` | Cloudflare Workers |
 | `cloudflare_pages` | Cloudflare Pages |
 | `vercel` | Vercel Functions |
@@ -71,7 +71,7 @@ node .output/server/index.mjs  # Run
 
 ---
 
-## Environment Variables
+## 환경 변수
 
 ```typescript
 // nitro.config.ts
@@ -97,22 +97,22 @@ app.get("/config", (c) => {
 
 ---
 
-## Project Structure
+## 프로젝트 구조
 
 ```
-project/
+프로젝트/
 ├── nitro.config.ts
 ├── src/
-│   ├── server.ts      # Hono app
+│   ├── server.ts      # Hono 앱
 │   ├── routes/
 │   └── lib/
-├── .output/           # Build output
+├── .output/           # 빌드 결과물
 └── package.json
 ```
 
 ---
 
-## Related Documentation
+## 관련 문서
 
 - [Docker](./docker.md)
 - [Railway](./railway.md)

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

@@ -1,10 +1,10 @@
-# Nitro - Railway Deployment
+# Nitro - Railway 배포
 
-> Simple PaaS deployment
+> PaaS 간편 배포
 
 ---
 
-## Configuration
+## 설정
 
 ```typescript
 // nitro.config.ts
@@ -29,12 +29,12 @@ export default defineNitroConfig({
 
 ---
 
-## Deployment
+## 배포
 
-### GitHub Integration (Recommended)
+### GitHub 연동 (권장)
 
-1. [Railway Dashboard](https://railway.app) → New Project → Deploy from GitHub
-2. Automatic build/deploy setup
+1. [Railway 대시보드](https://railway.app) → New Project → Deploy from GitHub
+2. 자동 빌드/배포 설정
 
 ### CLI
 
@@ -44,14 +44,14 @@ railway login
 railway init
 railway up
 
-# Environment variables
+# 환경 변수
 railway variables set DATABASE_URL="postgresql://..."
 railway logs
 ```
 
 ---
 
-## railway.toml (Optional)
+## railway.toml (선택)
 
 ```toml
 [build]
@@ -64,7 +64,7 @@ healthcheckPath = "/health"
 
 ---
 
-## Environment Variables
+## 환경 변수
 
 ```typescript
 app.get("/health", (c) => {
@@ -75,30 +75,30 @@ app.get("/health", (c) => {
 });
 ```
 
-| Auto-provided Variables | Description |
-|------------------------|-------------|
-| `PORT` | Server port |
-| `RAILWAY_ENVIRONMENT` | Environment |
-| `RAILWAY_SERVICE_NAME` | Service name |
+| 자동 제공 변수 | 설명 |
+|---------------|------|
+| `PORT` | 서버 포트 |
+| `RAILWAY_ENVIRONMENT` | 환경 |
+| `RAILWAY_SERVICE_NAME` | 서비스명 |
 
 ---
 
-## Database
+## 데이터베이스
 
-Railway Dashboard → New → Database → PostgreSQL/Redis
+Railway 대시보드 → New → Database → PostgreSQL/Redis
 
 ```typescript
-// DATABASE_URL auto-connected
+// DATABASE_URL 자동 연결
 import { PrismaClient } from "@prisma/client";
 export const prisma = new PrismaClient();
 ```
 
 ---
 
-## Domains
+## 도메인
 
-- Automatic: `your-app.up.railway.app`
-- Custom: Settings → Domains → Add Custom Domain
+- 자동: `your-app.up.railway.app`
+- 커스텀: Settings → Domains → Add Custom Domain
 
 ---
 
@@ -125,22 +125,22 @@ jobs:
 
 ---
 
-## Troubleshooting
+## 문제 해결
 
-| Issue | Solution |
-|-------|----------|
-| Build failure | Verify `yarn.lock` is committed |
-| Port error | Use `process.env.PORT` |
-| Healthcheck failure | Add `/health` endpoint |
+| 문제 | 해결 |
+|------|------|
+| 빌드 실패 | `yarn.lock` 커밋 확인 |
+| 포트 오류 | `process.env.PORT` 사용 |
+| 헬스체크 실패 | `/health` 엔드포인트 추가 |
 
 ```bash
-railway run yarn dev  # Local simulation
-railway variables     # Check environment variables
-railway status        # Check status
+railway run yarn dev  # 로컬 시뮬레이션
+railway variables     # 환경 변수 확인
+railway status        # 상태 확인
 ```
 
 ---
 
-## Related Documentation
+## 관련 문서
 
-- [Deployment Guide](./index.md)
+- [배포 가이드](./index.md)