@kood/claude-code 0.5.4 → 0.5.5

package/templates/nextjs/CLAUDE.md

@@ -4,17 +4,17 @@
 
 <context>
 
-**Purpose:** Next.js App Router-based web application development guidelines
+**Purpose:** Next.js App Router 기반 웹 애플리케이션 개발 지침
 
-**Scope:** Full-stack React application implementation
+**Scope:** Full-stack React 애플리케이션 구현
 
 **Key Features:**
 - App Router (file-based routing)
-- Server Actions (type-safe API)
+- Server Actions (타입 안전 API)
 - Server/Client Components
 - Route Handlers (REST API)
 - Middleware
-- Built-in Optimization (images, fonts, scripts)
+- Built-in Optimization (이미지, 폰트, 스크립트)
 - Deployment (Vercel, Docker, Node.js)
 
 </context>
@@ -35,14 +35,14 @@
 
 <forbidden>
 
-| Category | Forbidden Actions |
-|----------|-------------------|
-| **Git Commits** | AI markers (`Generated with Claude Code`, `🤖`, `Co-Authored-By:`), multi-line messages, emojis |
-| **Prisma** | Auto-running `db push/migrate/generate`, unauthorized `schema.prisma` modifications |
-| **Server Actions** | Direct definition in client components, usage without try-catch, missing Zod validation (POST/PUT/PATCH) |
-| **Route Handlers** | Creation outside `/app/api/`, creation when Server Actions are suitable |
-| **Client** | Direct Server Action calls (use TanStack Query), missing `"use client"` |
-| **Code Search** | Bash grep/rg/find commands (use ast-grep or dedicated tools) |
+| 분류 | 금지 행동 |
+|------|----------|
+| **Git 커밋** | AI 표시 (`Generated with Claude Code`, `🤖`, `Co-Authored-By:`), 여러 줄 메시지, 이모지 |
+| **Prisma** | `db push/migrate/generate` 자동 실행, `schema.prisma` 무단 수정 |
+| **Server Actions** | 클라이언트 컴포넌트에서 직접 정의, try-catch 없이 사용, Zod 검증 누락 (POST/PUT/PATCH) |
+| **Route Handlers** | `/app/api/` 외부에 생성, Server Actions로 대체 가능한 경우 생성 |
+| **클라이언트** | Server Action 직접 호출 (TanStack Query 사용), `"use client"` 누락 |
+| **코드 검색** | Bash의 grep/rg/find 명령어 (ast-grep 또는 전용 도구 사용) |
 
 </forbidden>
 
@@ -50,18 +50,18 @@
 
 <required>
 
-| Task | Required Actions |
-|------|------------------|
-| **Before Starting** | Read relevant docs (UI → design, API → nextjs, DB → prisma, auth → next-auth) |
-| **Document Search** | Use serena mcp (document indexing/search, context length optimization) |
-| **Code Search** | Use ast-grep (function/component/pattern search) |
-| **Complex Tasks** | Sequential Thinking MCP (5+ step tasks) |
-| **Large Changes** | gemini-review (3+ file changes, architectural decisions) |
-| **Server Actions** | `"use server"` declaration, Zod validation (POST/PUT/PATCH), try-catch + revalidatePath/redirect |
-| **Client API** | Call Server Actions via TanStack Query (`useQuery`/`useMutation`) |
-| **Custom Hook Order** | State → Global Hooks (useParams, useRouter, useSearchParams) → React Query → Handlers → Memo → Effect |
-| **Code Writing** | UTF-8 encoding, Korean comments per code block, const function declarations |
-| **Prisma** | Multi-File structure (`prisma/schema/`), Korean comments required for all elements |
+| 작업 | 필수 행동 |
+|------|----------|
+| **작업 시작 전** | 관련 docs 읽기 (UI → design, API → nextjs, DB → prisma, 인증 → next-auth) |
+| **문서 검색** | serena mcp 사용 (문서 인덱싱/검색, context 길이 최적화) |
+| **코드 검색** | ast-grep 사용 (함수/컴포넌트/패턴 검색) |
+| **복잡한 작업** | Sequential Thinking MCP (5+ 단계 작업) |
+| **대규모 수정** | gemini-review (3+ 파일 변경, 아키텍처 결정) |
+| **Server Actions** | `"use server"` 선언, Zod 검증 (POST/PUT/PATCH), try-catch + revalidatePath/redirect |
+| **클라이언트 API** | TanStack Query (`useQuery`/`useMutation`)로 Server Action 호출 |
+| **Custom Hook 순서** | State → Global Hooks (useParams, useRouter, useSearchParams) → React Query → Handlers → Memo → Effect |
+| **코드 작성** | UTF-8 인코딩, 코드 묶음별 한글 주석, const 함수 선언 |
+| **Prisma** | Multi-File 구조 (`prisma/schema/`), 모든 요소 한글 주석 필수 |
 
 </required>
 
@@ -69,15 +69,15 @@
 
 <tech_stack>
 
-| Technology | Version | Note |
-|------------|---------|------|
-| Next.js | **15.x** | App Router only |
+| 기술 | 버전 | 주의 |
+|------|------|------|
+| Next.js | **15.x** | App Router 전용 |
 | React | **19.x** | Server Components |
 | TypeScript | 5.x | strict |
 | Tailwind CSS | 4.x | @theme |
-| Prisma | **7.x** | `prisma-client`, output required |
+| Prisma | **7.x** | `prisma-client`, output 필수 |
 | Zod | **4.x** | `z.email()`, `z.url()` |
-| NextAuth.js | **5.x** (Auth.js) | App Router support |
+| NextAuth.js | **5.x** (Auth.js) | App Router 지원 |
 | TanStack Query | 5.x | - |
 
 </tech_stack>
@@ -92,41 +92,41 @@ src/
 │   ├── page.tsx                # Home page
 │   ├── [slug]/
 │   │   ├── page.tsx            # Dynamic route
-│   │   ├── _components/        # Page-specific components (required)
-│   │   ├── _hooks/             # Page-specific hooks (required)
-│   │   └── _actions/           # Page-specific Server Actions (required)
+│   │   ├── _components/        # 페이지 전용 컴포넌트 (필수)
+│   │   ├── _hooks/             # 페이지 전용 훅 (필수)
+│   │   └── _actions/           # 페이지 전용 Server Actions (필수)
 │   ├── api/
 │   │   └── [endpoint]/
 │   │       └── route.ts        # Route Handler (REST API)
-│   └── _actions/               # Shared Server Actions
-├── components/ui/              # Shared UI components (Server Components)
+│   └── _actions/               # 공통 Server Actions
+├── components/ui/              # 공통 UI 컴포넌트 (Server Components)
 ├── middleware.ts               # Middleware
 ├── database/prisma.ts
 └── lib/
 ```
 
-**Required Rules:**
-- Each page MUST have `_components/`, `_hooks/`, `_actions/` folders (regardless of line count)
-- Custom Hooks MUST be separated into `_hooks/` folder regardless of page size
-- Server Components by default → use `"use client"` only when necessary
-- Server Actions: global (`app/_actions/`) or page-specific (`[route]/_actions/`)
-- Route Handlers only in `/app/api/` path
+**필수 규칙:**
+- 페이지당 `_components/`, `_hooks/`, `_actions/` 폴더 필수 (줄 수 무관)
+- Custom Hook은 페이지 크기와 무관하게 **반드시** `_hooks/` 폴더에 분리
+- Server Components가 기본 → `"use client"` 명시 필요 시만 사용
+- Server Actions는 글로벌(`app/_actions/`) 또는 페이지 전용(`[route]/_actions/`)에 분리
+- Route Handlers는 `/app/api/` 경로에만 생성
 </structure>
 
 ---
 
 <conventions>
 
-File names: kebab-case, Routes: `page.tsx`, `layout.tsx`, `[slug]/page.tsx`
-TypeScript: const declarations, explicit return types, interface (objects)/type (unions), any→unknown
-Import order: external → @/ → relative → type
+파일명: kebab-case, Routes: `page.tsx`, `layout.tsx`, `[slug]/page.tsx`
+TypeScript: const 선언, 명시적 return type, interface(객체)/type(유니온), any→unknown
+Import 순서: 외부 → @/ → 상대경로 → type
 
 Prisma Multi-File:
 ```
 prisma/schema/
 ├── +base.prisma   # datasource, generator
 ├── +enum.prisma   # enum
-└── [model].prisma # per model (Korean comments required!)
+└── [model].prisma # 모델별 (한글 주석!)
 ```
 
 </conventions>
@@ -136,7 +136,7 @@ prisma/schema/
 <quick_patterns>
 
 ```typescript
-// Server Action (file top)
+// Server Action (파일 상단)
 "use server"
 
 export async function createPost(formData: FormData) {
@@ -150,7 +150,7 @@ export async function createPost(formData: FormData) {
   return post
 }
 
-// Server Action (with auth)
+// Server Action (인증)
 "use server"
 
 import { auth } from "@/lib/auth"
@@ -209,12 +209,12 @@ export default async function PostsPage() {
 
 <ui_ux>
 
-| Principle | Value |
-|-----------|-------|
-| Color | 60-30-10 (background-secondary-accent) |
-| Spacing | 8px grid |
-| Accessibility | WCAG AA (contrast 4.5:1+) |
-| Fonts | 2-3 types |
+| 원칙 | 값 |
+|------|------|
+| 색상 | 60-30-10 (배경-보조-강조) |
+| 간격 | 8px 그리드 |
+| 접근성 | WCAG AA (대비 4.5:1+) |
+| 폰트 | 2-3개 |
 | Safe Area | tailwindcss-safe-area |
 
 </ui_ux>
@@ -224,8 +224,8 @@ export default async function PostsPage() {
 <docs_structure>
 ```
 docs/
-├── guides/          # Getting started, conventions, patterns
+├── guides/          # 시작하기, 규칙, 패턴
 ├── library/         # nextjs, prisma, next-auth, tanstack-query, zod
-└── design.md        # UI/UX guide
+└── design.md        # UI/UX 가이드
 ```
 </docs_structure>