@kood/claude-code 0.2.4 → 0.3.0

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

@@ -1,40 +1,36 @@
-# Hono - Web Framework
+# Hono
 
-> Web Standards 기반 초경량 서버 프레임워크
+> Web Standards 기반 초경량 프레임워크
 
-@env-setup.md
+<references>
 @middleware.md
 @validation.md
 @error-handling.md
 @rpc.md
+</references>
 
 ---
 
-## 설치
-
+<setup>
 ```bash
 npm install hono
 ```
+</setup>
 
 ---
 
-## 기본 사용법
+<quick_patterns>
+
+## 라우트
 
 ```typescript
 import { Hono } from 'hono'
 
 const app = new Hono()
 
-app.get('/', (c) => c.text('Hello Hono!'))
+app.get('/', (c) => c.text('Hello'))
 app.post('/', (c) => c.text('POST /'))
-
-// 동적 파라미터
-app.get('/users/:id', (c) => {
-  const id = c.req.param('id')
-  return c.json({ id })
-})
-
-// 여러 파라미터
+app.get('/users/:id', (c) => c.json({ id: c.req.param('id') }))
 app.get('/posts/:postId/comments/:commentId', (c) => {
   const { postId, commentId } = c.req.param()
   return c.json({ postId, commentId })
@@ -43,13 +39,9 @@ app.get('/posts/:postId/comments/:commentId', (c) => {
 export default app
 ```
 
----
-
-## 라우트 그룹화
+## 라우트 그룹
 
 ```typescript
-const app = new Hono()
-
 const users = new Hono()
 users.get('/', (c) => c.json({ users: [] }))
 users.get('/:id', (c) => c.json({ id: c.req.param('id') }))
@@ -58,13 +50,10 @@ users.post('/', (c) => c.json({ created: true }, 201))
 app.route('/users', users)
 ```
 
----
-
-## Context (c)
-
-### Request
+## Context
 
 ```typescript
+// Request
 app.get('/info', (c) => {
   const url = c.req.url
   const path = c.req.path
@@ -74,11 +63,8 @@ app.get('/info', (c) => {
   const auth = c.req.header('Authorization')
   return c.json({ url, path, method })
 })
-```
-
-### Request Body
 
-```typescript
+// Body
 app.post('/json', async (c) => {
   const body = await c.req.json()
   return c.json(body)
@@ -88,21 +74,16 @@ app.post('/form', async (c) => {
   const body = await c.req.parseBody()
   return c.json(body)
 })
-```
-
-### Response
 
-```typescript
-c.text('Hello')                    // Text
-c.json({ message: 'Hello' })       // JSON
-c.json({ id: 1 }, 201)             // JSON + status
-c.html('<h1>Hello</h1>')           // HTML
-c.redirect('/new')                 // Redirect
-c.notFound()                       // 404
+// Response
+c.text('Hello')
+c.json({ message: 'Hello' })
+c.json({ id: 1 }, 201)
+c.html('<h1>Hello</h1>')
+c.redirect('/new')
+c.notFound()
 ```
 
----
-
 ## Bindings & Variables
 
 ```typescript
@@ -118,13 +99,13 @@ type Variables = {
 
 const app = new Hono<{ Bindings: Bindings; Variables: Variables }>()
 
-// 환경 변수 접근
+// 환경 변수
 app.get('/', (c) => {
   const dbUrl = c.env.DATABASE_URL
   return c.json({ connected: true })
 })
 
-// Variables 설정/사용
+// Variables
 app.use(async (c, next) => {
   c.set('userId', '123')
   await next()
@@ -136,12 +117,4 @@ app.get('/me', (c) => {
 })
 ```
 
----
-
-## 관련 문서
-
-- [환경 변수 설정](./env-setup.md)
-- [미들웨어](./middleware.md)
-- [Zod 검증](./validation.md)
-- [에러 처리](./error-handling.md)
-- [RPC Client](./rpc.md)
+</quick_patterns>

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

@@ -2,7 +2,7 @@
 
 > 요청/응답 처리 파이프라인
 
----
+<patterns>
 
 ## 기본 사용법
 
@@ -15,11 +15,8 @@ const app = new Hono()
 
 app.use(logger())           // 모든 라우트
 app.use('/api/*', cors())   // 특정 경로
-```
-
-### 실행 순서
 
-```typescript
+// 실행 순서
 app.use(async (c, next) => {
   console.log('1. 요청 전')
   await next()
@@ -34,17 +31,13 @@ app.use(async (c, next) => {
 // 출력: 1 → 2 → handler → 3 → 4
 ```
 
----
-
 ## 커스텀 미들웨어
 
 ```typescript
 import { createMiddleware } from 'hono/factory'
 import { HTTPException } from 'hono/http-exception'
 
-type Env = {
-  Variables: { userId: string }
-}
+type Env = { Variables: { userId: string } }
 
 export const authMiddleware = createMiddleware<Env>(async (c, next) => {
   const token = c.req.header('Authorization')?.replace('Bearer ', '')
@@ -64,68 +57,6 @@ app.get('/me', authMiddleware, (c) => {
 })
 ```
 
----
-
-## 내장 미들웨어
-
-### Logger
-
-```typescript
-import { logger } from 'hono/logger'
-app.use(logger())
-```
-
-### CORS
-
-```typescript
-import { cors } from 'hono/cors'
-
-app.use('/api/*', cors({
-  origin: ['https://example.com'],
-  allowMethods: ['GET', 'POST', 'PUT', 'DELETE'],
-  allowHeaders: ['Content-Type', 'Authorization'],
-  credentials: true,
-}))
-```
-
-### Bearer Auth
-
-```typescript
-import { bearerAuth } from 'hono/bearer-auth'
-
-app.use('/api/*', bearerAuth({
-  verifyToken: async (token) => token === 'valid-token',
-}))
-```
-
-### Secure Headers
-
-```typescript
-import { secureHeaders } from 'hono/secure-headers'
-app.use(secureHeaders())
-```
-
-### Request ID
-
-```typescript
-import { requestId } from 'hono/request-id'
-
-app.use('*', requestId())
-
-app.get('/', (c) => {
-  return c.text(`Request ID: ${c.get('requestId')}`)
-})
-```
-
-### Compress
-
-```typescript
-import { compress } from 'hono/compress'
-app.use(compress())
-```
-
----
-
 ## 타입 안전 미들웨어
 
 ```typescript
@@ -159,9 +90,19 @@ app.get('/users', (c) => {
 })
 ```
 
+</patterns>
+
 ---
 
-## 관련 문서
+<builtin>
+
+| 미들웨어 | 사용 |
+|---------|------|
+| **logger** | `app.use(logger())` |
+| **cors** | `app.use('/api/*', cors({ origin: ['https://example.com'] }))` |
+| **bearerAuth** | `app.use('/api/*', bearerAuth({ verifyToken: async (t) => t === 'valid' }))` |
+| **secureHeaders** | `app.use(secureHeaders())` |
+| **requestId** | `app.use(requestId())` → `c.get('requestId')` |
+| **compress** | `app.use(compress())` |
 
-- [기본 사용법](./index.md)
-- [에러 처리](./error-handling.md)
+</builtin>

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

@@ -2,7 +2,7 @@
 
 > Type-safe API 호출
 
----
+<patterns>
 
 ## 서버 설정
 
@@ -26,14 +26,11 @@ const app = new Hono()
     }
   )
 
-// 타입 export 필수
-export type AppType = typeof app
+export type AppType = typeof app  // ✅ 필수
 export default app
 ```
 
----
-
-## 클라이언트 사용
+## 클라이언트
 
 ```typescript
 // client.ts
@@ -54,13 +51,7 @@ const data = await res.json() // { id: string, name: string }
 const res = await client.users.$post({
   json: { name: 'John', email: 'john@example.com' },
 })
-```
-
----
 
-## 요청 옵션
-
-```typescript
 // Query
 const res = await client.search.$get({
   query: { q: 'hono', page: '1' },
@@ -76,21 +67,14 @@ const res = await client.posts.$post(
   { json: { title: 'Test' } },
   { headers: { 'X-Custom': 'value' } }
 )
-```
-
----
 
-## 클라이언트 설정
-
-```typescript
+// Config
 const client = hc<AppType>('http://localhost:8787/', {
   headers: { Authorization: 'Bearer TOKEN' },
   init: { credentials: 'include' },
 })
 ```
 
----
-
 ## 타입 추론
 
 ```typescript
@@ -103,9 +87,7 @@ type UserResponse = InferResponseType<typeof client.users[':id'].$get>
 // { id: string; name: string }
 ```
 
----
-
-## CRUD 예제
+## CRUD 래퍼
 
 ```typescript
 const userApi = {
@@ -134,20 +116,10 @@ const userApi = {
     return res.json()
   },
 }
-```
-
----
 
-## URL 생성
-
-```typescript
+// URL 생성
 const url = client.posts[':id'].$url({ param: { id: '123' } })
 console.log(url.pathname) // /posts/123
 ```
 
----
-
-## 관련 문서
-
-- [기본 사용법](./index.md)
-- [Zod 검증](./validation.md)
+</patterns>

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

@@ -2,40 +2,38 @@
 
 > @hono/zod-validator로 타입 안전 요청 검증
 
----
-
-## 설치
-
+<setup>
 ```bash
 npm install zod @hono/zod-validator
 ```
+</setup>
 
 ---
 
-## 기본 사용법
+<patterns>
 
-### JSON Body
+## JSON Body
 
 ```typescript
 import { zValidator } from '@hono/zod-validator'
 import { z } from 'zod'
 
-// ✅ Zod v4 문법
 const createUserSchema = z.object({
-  email: z.email(),              // v4
+  email: z.email(),              // ✅ v4
   name: z.string().min(1).trim(),
-  website: z.url().optional(),   // v4
+  website: z.url().optional(),   // ✅ v4
 })
 
 app.post('/users', zValidator('json', createUserSchema), (c) => {
-  const data = c.req.valid('json') // 타입 추론됨
+  const data = c.req.valid('json')
   return c.json({ user: data }, 201)
 })
 ```
 
-### Query Parameter
+## Query / Param / Header
 
 ```typescript
+// Query
 const searchSchema = z.object({
   q: z.string(),
   page: z.coerce.number().positive().optional(),
@@ -46,11 +44,8 @@ app.get('/search', zValidator('query', searchSchema), (c) => {
   const { q, page = 1, limit = 10 } = c.req.valid('query')
   return c.json({ query: q, page, limit })
 })
-```
 
-### Path Parameter
-
-```typescript
+// Param
 app.get('/users/:id',
   zValidator('param', z.object({ id: z.string().uuid() })),
   (c) => {
@@ -58,23 +53,16 @@ app.get('/users/:id',
     return c.json({ id })
   }
 )
-```
 
-### Header
-
-```typescript
-// 헤더 이름은 소문자
-const headerSchema = z.object({
-  'x-api-key': z.string().uuid(),
-})
-
-app.get('/api/protected', zValidator('header', headerSchema), (c) => {
-  return c.json({ apiKey: c.req.valid('header')['x-api-key'] })
-})
+// Header (소문자!)
+app.get('/api/protected',
+  zValidator('header', z.object({ 'x-api-key': z.string().uuid() })),
+  (c) => {
+    return c.json({ apiKey: c.req.valid('header')['x-api-key'] })
+  }
+)
 ```
 
----
-
 ## 복합 검증
 
 ```typescript
@@ -92,9 +80,7 @@ app.post(
 )
 ```
 
----
-
-## 커스텀 에러 처리
+## 커스텀 에러
 
 ```typescript
 app.post(
@@ -114,13 +100,10 @@ app.post(
 )
 ```
 
----
-
-## 재사용 가능한 스키마
-
-### validators/user.ts
+## 재사용 스키마
 
 ```typescript
+// validators/user.ts
 import { z } from 'zod'
 
 export const createUserSchema = z.object({
@@ -134,12 +117,14 @@ export const updateUserSchema = createUserSchema.partial()
 export type CreateUserInput = z.infer<typeof createUserSchema>
 ```
 
+</patterns>
+
 ---
 
-## 고급 패턴
+<advanced>
 
 ```typescript
-// Coerce (타입 변환)
+// Coerce
 z.coerce.number()    // string → number
 z.coerce.boolean()   // 'true' → boolean
 z.coerce.date()      // string → Date
@@ -160,9 +145,4 @@ z.object({
 })
 ```
 
----
-
-## 관련 문서
-
-- [Zod 가이드](../zod/index.md)
-- [에러 처리](./error-handling.md)
+</advanced>