@kood/claude-code 0.5.4 → 0.5.5

package/dist/index.js

@@ -629,7 +629,11 @@ async function installExtras(templates, targetDir, flags, availability, force) {
 // src/shared/gitignore-manager.ts
 import fs6 from "fs-extra";
 import path8 from "path";
-var CLAUDE_GENERATED_FOLDERS = ["CLAUDE.md", "docs/", ".claude/"];
+var CLAUDE_GENERATED_FOLDERS = [
+  ".claude/plan/",
+  ".claude/ralph/",
+  ".claude/refactor/"
+];
 async function updateGitignore(targetDir) {
   const gitignorePath = path8.join(targetDir, ".gitignore");
   const sectionComment = "# Claude Code generated files";
@@ -835,7 +839,7 @@ var init = async (options) => {
 
 // src/index.ts
 var program = new Command();
-program.name("claude-code").description("Claude Code documentation installer for projects").version("0.5.4");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.5.5");
 program.option(
   "-t, --template <names>",
   "template names (comma-separated: tanstack-start,hono)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kood/claude-code",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/.claude/agents/document-writer.md

@@ -52,7 +52,7 @@ model: haiku
 
 <instructions>
 @path/to/common-rules.md
-@docs/library/[library]/index.md
+@.claude/docs/library/[library]/index.md
 </instructions>
 
 <forbidden>
@@ -155,7 +155,7 @@ description: 한 줄 설명
 
 <instructions>
 @.claude/instructions/git-rules.md
-@docs/library/tanstack-start/index.md
+@.claude/docs/library/tanstack-start/index.md
 </instructions>
 
 <forbidden>

package/templates/.claude/skills/docs-creator/SKILL.md

@@ -151,7 +151,7 @@ Edit("docs/library/react-query/index.md", ...)
 
 <instructions>
 @path/to/common.md
-@docs/library/[lib]/index.md
+@.claude/docs/library/[lib]/index.md
 </instructions>
 
 ---
@@ -276,7 +276,7 @@ argument-hint: <인자>
 
 <instructions>
 @.claude/instructions/git-rules.md
-@docs/library/tanstack-start/index.md
+@.claude/docs/library/tanstack-start/index.md
 </instructions>
 
 ---

package/templates/.claude/skills/docs-refactor/SKILL.md

@@ -156,7 +156,7 @@ Git 커밋 시에는 반드시 다음 규칙을 따라야 합니다:
 
 <instructions>
 @.claude/instructions/git-rules.md
-@docs/library/tanstack-start/index.md
+@.claude/docs/library/tanstack-start/index.md
 </instructions>
 
 ---

package/templates/.claude/skills/plan/SKILL.md

@@ -47,7 +47,7 @@ Task({
 
 - 2-3개 옵션 제시 (장단점, 영향 범위)
 - 추천안 및 근거
-- 선택 후 `.claude/plans/00.[기능명]/` 폴더에 여러 문서 자동 생성
+- 선택 후 `.claude/plan/00.[기능명]/` 폴더에 여러 문서 자동 생성
   - OVERVIEW.md, OPTIONS.md, IMPLEMENTATION.md, RISKS.md, REFERENCES.md
 
 </when_to_use>
@@ -634,7 +634,7 @@ Task({
   `
 })
 
-// → 각 모듈별 .claude/plans/00.User_모듈/, 01.Payment_모듈/ 문서 생성
+// → 각 모듈별 .claude/plan/00.User_모듈/, 01.Payment_모듈/ 문서 생성
 ```
 
 **예시 3: 실시간 기능 기술 조사 (조사 병렬)**
@@ -1047,10 +1047,10 @@ Task({
 
 ### 폴더 구조
 
-옵션 선택 후 `.claude/plans/00.[기능명]/` 폴더 생성:
+옵션 선택 후 `.claude/plan/00.[기능명]/` 폴더 생성:
 
 ```
-.claude/plans/00.실시간_알림/
+.claude/plan/00.실시간_알림/
 ├── OVERVIEW.md        # 개요, 현재 상태, 선택된 옵션
 ├── OPTIONS.md         # 모든 옵션 비교 분석 (장단점, 영향 범위)
 ├── IMPLEMENTATION.md  # 구현 단계 상세 계획
@@ -1373,13 +1373,13 @@ Write({ file_path: "OPTIONS.md", ... })   // 대기...
 
 ## 계획 문서 병렬 생성
 
-사용자가 옵션을 선택하면 `.claude/plans/[기능명]-{timestamp}/` 폴더에 여러 문서를 **병렬로** 생성합니다.
+사용자가 옵션을 선택하면 `.claude/plan/[기능명]-{timestamp}/` 폴더에 여러 문서를 **병렬로** 생성합니다.
 
 ### 병렬 생성 워크플로우
 
 ```text
-1. 넘버링 결정: ls .claude/plans/ → 다음 번호 자동 부여
-2. 폴더 생성: .claude/plans/00.[기능명]/
+1. 넘버링 결정: ls .claude/plan/ → 다음 번호 자동 부여
+2. 폴더 생성: .claude/plan/00.[기능명]/
 3. document-writer 에이전트 5개 병렬 호출
    - OVERVIEW.md (haiku)
    - OPTIONS.md (haiku)
@@ -1397,10 +1397,10 @@ Write({ file_path: "OPTIONS.md", ... })   // 대기...
 ```typescript
 // 옵션 선택 후 실행
 // 1. 넘버링 결정
-Bash("ls .claude/plans/ | grep -E '^[0-9]+' | wc -l")
+Bash("ls .claude/plan/ | grep -E '^[0-9]+' | wc -l")
 const nextNumber = "00" // 결과 기반 계산
 const projectName = "실시간_알림"
-const basePath = `.claude/plans/${nextNumber}.${projectName}`
+const basePath = `.claude/plan/${nextNumber}.${projectName}`
 
 // 2. 폴더 생성
 Bash(`mkdir -p ${basePath}`)
@@ -1498,7 +1498,7 @@ Task({
 // 문서 생성 완료 후 즉시 실행
 Skill({
   skill: 'execute',
-  args: `@.claude/plans/${nextNumber}.${projectName}/IMPLEMENTATION.md 1단계부터 구현`
+  args: `@.claude/plan/${nextNumber}.${projectName}/IMPLEMENTATION.md 1단계부터 구현`
 })
 ```
 
@@ -1546,7 +1546,7 @@ Skill({
 3. planner agent 프로세스:
    - 인터뷰: 요구사항, 제약사항, 리스크 허용도 파악
    - 코드베이스 조사: Explore agent로 현재 구조 분석
-   - 계획 생성: .claude/plans/00.세션_인증/
+   - 계획 생성: .claude/plan/00.세션_인증/
    - 5개 문서 병렬 생성 (OVERVIEW, OPTIONS, IMPLEMENTATION, RISKS, REFERENCES)
    - 사용자 확인 후 핸드오프
 
@@ -1584,7 +1584,7 @@ Skill({
 4. 사용자 선택: 1
 
 5. document-writer 에이전트 5개 병렬 호출로 문서 생성
-   - .claude/plans/00.실시간_알림/
+   - .claude/plan/00.실시간_알림/
      ├── OVERVIEW.md
      ├── OPTIONS.md
      ├── IMPLEMENTATION.md
@@ -1621,7 +1621,7 @@ Skill({
    - 단점: 테스트 필요
 
 4. 사용자 선택 → document-writer 에이전트 병렬 호출로 계획 문서 생성
-   - .claude/plans/00.타입스크립트_전환/
+   - .claude/plan/00.타입스크립트_전환/
 
 5. 구현 자동 시작:
    Skill({ skill: 'execute' })
@@ -1644,9 +1644,9 @@ Skill({
 ✅ 옵션 최소 2개, 권장 3개
 ✅ 각 옵션에 장단점 명시
 ✅ 영향 범위 및 예상 작업량 제시
-✅ 넘버링 자동 결정 (ls .claude/plans/)
+✅ 넘버링 자동 결정 (ls .claude/plan/)
 ✅ document-writer 에이전트 병렬 호출로 문서 생성
-✅ .claude/plans/00.[기능명]/ 폴더 구조 사용 (한글 설명)
+✅ .claude/plan/00.[기능명]/ 폴더 구조 사용 (한글 설명)
 ```
 
 절대 금지:

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)