@kood/claude-code 0.1.0

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

@@ -0,0 +1,291 @@
+# 배포 가이드
+
+> Hono 애플리케이션 배포 옵션
+
+---
+
+## 지원 런타임
+
+Hono는 Web Standards 기반으로 다양한 런타임에서 동작합니다.
+
+| 런타임 | 특징 |
+|--------|------|
+| **Cloudflare Workers** | 엣지 컴퓨팅, 글로벌 배포 |
+| **Deno Deploy** | TypeScript 네이티브 |
+| **Bun** | 빠른 실행 속도 |
+| **Node.js** | 전통적인 서버 환경 |
+| **AWS Lambda** | 서버리스 |
+| **Vercel** | 프론트엔드 통합 |
+
+---
+
+## Cloudflare Workers
+
+### 프로젝트 생성
+
+```bash
+npm create hono@latest my-app
+# cloudflare-workers 템플릿 선택
+```
+
+### wrangler.toml
+
+```toml
+name = "my-hono-app"
+main = "src/index.ts"
+compatibility_date = "2024-01-01"
+
+[vars]
+NODE_ENV = "production"
+```
+
+### 배포
+
+```bash
+# 로컬 개발
+npm run dev
+
+# 배포
+npm run deploy
+# 또는
+npx wrangler deploy
+```
+
+### 환경 변수
+
+```bash
+# 시크릿 설정
+npx wrangler secret put DATABASE_URL
+npx wrangler secret put JWT_SECRET
+```
+
+### 로컬 환경 변수 (.dev.vars)
+
+```
+DATABASE_URL=postgresql://...
+JWT_SECRET=your-secret
+```
+
+### GitHub Actions 배포
+
+```yaml
+name: Deploy
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Deploy
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+```
+
+---
+
+## Bun
+
+### 프로젝트 생성
+
+```bash
+bun create hono@latest my-app
+# bun 템플릿 선택
+```
+
+### 실행
+
+```bash
+bun run src/index.ts
+```
+
+### package.json
+
+```json
+{
+  "scripts": {
+    "dev": "bun run --hot src/index.ts",
+    "start": "bun run src/index.ts"
+  }
+}
+```
+
+### Docker 배포
+
+```dockerfile
+FROM oven/bun:1 AS base
+WORKDIR /app
+
+# 의존성 설치
+COPY package.json bun.lockb ./
+RUN bun install --frozen-lockfile
+
+# 소스 복사
+COPY . .
+
+# 실행
+EXPOSE 3000
+CMD ["bun", "run", "src/index.ts"]
+```
+
+---
+
+## Node.js
+
+### 설치
+
+```bash
+npm install @hono/node-server
+```
+
+### Entry Point
+
+```typescript
+import { serve } from '@hono/node-server'
+import app from './app'
+
+serve({
+  fetch: app.fetch,
+  port: 3000,
+})
+
+console.log('Server is running on http://localhost:3000')
+```
+
+### package.json
+
+```json
+{
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  }
+}
+```
+
+---
+
+## Deno
+
+### 프로젝트 생성
+
+```bash
+deno init --npm hono@latest my-app
+# deno 템플릿 선택
+```
+
+### deno.json
+
+```json
+{
+  "tasks": {
+    "dev": "deno run --allow-net --allow-env --watch src/index.ts",
+    "start": "deno run --allow-net --allow-env src/index.ts"
+  }
+}
+```
+
+### Deno Deploy
+
+```bash
+deployctl deploy --project=my-app src/index.ts
+```
+
+---
+
+## Vercel
+
+### vercel.json
+
+```json
+{
+  "builds": [
+    {
+      "src": "src/index.ts",
+      "use": "@vercel/node"
+    }
+  ],
+  "routes": [
+    {
+      "src": "/(.*)",
+      "dest": "src/index.ts"
+    }
+  ]
+}
+```
+
+---
+
+## 환경별 설정
+
+### 환경 변수 타입
+
+```typescript
+// types/env.d.ts
+type Bindings = {
+  NODE_ENV: 'development' | 'production' | 'test'
+  DATABASE_URL: string
+  JWT_SECRET: string
+}
+
+// app.ts
+const app = new Hono<{ Bindings: Bindings }>()
+
+app.get('/', (c) => {
+  const env = c.env.NODE_ENV
+  return c.json({ env })
+})
+```
+
+### 환경별 설정 분기
+
+```typescript
+const app = new Hono()
+
+// 개발 환경에서만 logger
+if (process.env.NODE_ENV === 'development') {
+  app.use(logger())
+}
+
+// 프로덕션에서만 보안 헤더
+if (process.env.NODE_ENV === 'production') {
+  app.use(secureHeaders())
+}
+```
+
+---
+
+## 헬스 체크
+
+```typescript
+app.get('/health', (c) => {
+  return c.json({
+    status: 'ok',
+    timestamp: new Date().toISOString(),
+  })
+})
+
+app.get('/ready', async (c) => {
+  try {
+    // DB 연결 확인
+    await prisma.$queryRaw`SELECT 1`
+    return c.json({ status: 'ready' })
+  } catch {
+    return c.json({ status: 'not ready' }, 503)
+  }
+})
+```
+
+---
+
+## 관련 문서
+
+- [Cloudflare Workers 상세](./cloudflare.md)
+- [Bun 상세](./bun.md)
+- [Node.js 상세](./nodejs.md)

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

@@ -0,0 +1,180 @@
+# Git 커밋 컨벤션
+
+> 프로젝트 Git 워크플로우 및 커밋 메시지 규칙
+
+---
+
+## ⛔ 절대 금지 사항
+
+```
+❌ "Generated with Claude Code" 포함 금지
+❌ "🤖" 또는 AI 관련 이모지 포함 금지
+❌ "Co-Authored-By:" 헤더 포함 금지
+❌ AI/봇이 작성했다는 어떤 표시도 금지
+❌ 커밋 메시지 여러 줄 작성 금지
+❌ 커밋 메시지에 이모지 사용 금지
+```
+
+---
+
+## 커밋 메시지 형식
+
+### 기본 형식
+
+```
+<prefix>: <설명>
+```
+
+- **한 줄만 작성**
+- **본문 없음**
+- **마침표 없음**
+- **이모지 없음**
+
+### Prefix 목록
+
+| Prefix | 용도 | 예시 |
+|--------|------|------|
+| `feat` | 새 기능 | `feat: 사용자 인증 API 추가` |
+| `fix` | 버그 수정 | `fix: JWT 토큰 검증 오류 수정` |
+| `refactor` | 리팩토링 | `refactor: 사용자 서비스 구조 개선` |
+| `style` | 코드 스타일 | `style: prettier 적용` |
+| `docs` | 문서 | `docs: API 문서 업데이트` |
+| `test` | 테스트 | `test: 인증 미들웨어 테스트 추가` |
+| `chore` | 기타 작업 | `chore: 의존성 업데이트` |
+| `perf` | 성능 개선 | `perf: 쿼리 최적화` |
+| `ci` | CI/CD | `ci: GitHub Actions 설정` |
+
+---
+
+## 좋은 예시 vs 나쁜 예시
+
+### ✅ 좋은 예시
+
+```bash
+feat: 사용자 로그인 API 추가
+fix: 세션 만료 오류 수정
+docs: README 업데이트
+refactor: 인증 미들웨어 분리
+test: 사용자 CRUD 테스트 추가
+```
+
+### ❌ 나쁜 예시
+
+```bash
+# 이모지 사용
+🚀 feat: 새 기능 추가
+
+# 여러 줄
+feat: 새 기능 추가
+
+상세 설명...
+
+# AI 표시
+feat: 로그인 기능 추가
+
+Generated with Claude Code
+
+# Co-Authored-By 포함
+feat: 기능 추가
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+
+# 마침표 사용
+feat: 새 기능 추가.
+
+# 모호한 설명
+fix: 버그 수정
+chore: 업데이트
+```
+
+---
+
+## 커밋 명령어
+
+### 기본 커밋
+
+```bash
+git add .
+git commit -m "feat: 사용자 인증 API 추가"
+```
+
+### 파일 지정 커밋
+
+```bash
+git add src/routes/users.ts src/validators/user.ts
+git commit -m "feat: 사용자 CRUD API 구현"
+```
+
+---
+
+## 브랜치 전략
+
+### 브랜치 네이밍
+
+```
+feature/<기능명>
+fix/<버그명>
+refactor/<대상>
+docs/<문서명>
+```
+
+### 예시
+
+```bash
+git checkout -b feature/user-auth
+git checkout -b fix/jwt-validation
+git checkout -b refactor/middleware-structure
+git checkout -b docs/api-reference
+```
+
+---
+
+## 워크플로우
+
+### 1. 브랜치 생성
+
+```bash
+git checkout -b feature/new-feature
+```
+
+### 2. 작업 및 커밋
+
+```bash
+# 작업 진행
+git add .
+git commit -m "feat: 새 기능 구현"
+```
+
+### 3. 푸시
+
+```bash
+git push origin feature/new-feature
+```
+
+### 4. PR 생성
+
+```bash
+# GitHub에서 PR 생성
+# 또는 gh CLI 사용
+gh pr create --title "feat: 새 기능 추가" --body "설명"
+```
+
+---
+
+## 커밋 전 체크리스트
+
+```
+□ 커밋 메시지가 한 줄인가?
+□ 적절한 prefix를 사용했는가?
+□ 이모지가 없는가?
+□ AI 관련 표시가 없는가?
+□ Co-Authored-By가 없는가?
+□ 마침표가 없는가?
+□ 설명이 명확한가?
+```
+
+---
+
+## 관련 문서
+
+- [CLAUDE.md](../../CLAUDE.md)