@kood/claude-code 0.3.0 → 0.3.2

package/dist/index.js

@@ -409,7 +409,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.3.0");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.3.2");
 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.3.0",
+  "version": "0.3.2",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/.claude/commands/git-all.md

@@ -4,7 +4,55 @@ description: 모든 변경사항 커밋 후 푸시
 
 # Git All Command
 
-@git-operator 에이전트를 사용하여 모든 변경사항을 커밋하고 푸시.
+> @git-operator 에이전트를 사용하여 모든 변경사항을 커밋하고 푸시.
+
+---
+
+<critical_requirements>
+
+## ⚠️ CRITICAL: 작업 시작 전 필수 확인
+
+**이 커맨드는 반드시 @git-operator 에이전트를 사용해야 합니다.**
+
+### MANDATORY: Task 도구로 @git-operator 호출
+
+```typescript
+Task({
+  subagent_type: 'git-operator',
+  description: '모든 변경사항 커밋 후 푸시',
+  prompt: `
+    전체 커밋 모드:
+    - 모든 변경사항을 논리적 단위로 분리하여 전부 커밋
+    - 반드시 푸시 (git push)
+    - clean working directory 확인 필수
+  `
+})
+```
+
+**❌ 절대 금지:**
+- Bash 도구로 git 명령 직접 실행
+- @git-operator 없이 커밋/푸시 수행
+- 커맨드 내에서 직접 파일 분석
+
+**✅ 필수:**
+- Task 도구로 @git-operator 에이전트 호출
+- 모든 git 작업을 에이전트에 위임
+- 완료 후 clean working directory 확인
+
+---
+
+**진행 전 자가 점검:**
+```text
+□ Task 도구 사용 준비?
+□ @git-operator 에이전트로 작업 위임?
+□ Bash로 git 직접 실행 안 함?
+```
+
+**⚠️ 위 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
+
+</critical_requirements>
+
+---
 
 <mode>
 

package/templates/.claude/commands/git-session.md

@@ -4,7 +4,55 @@ description: 현재 세션에서 수정한 파일만 커밋 후 푸시
 
 # Git Session Command
 
-@git-operator 에이전트를 사용하여 현재 세션 파일만 선택적으로 커밋하고 푸시.
+> @git-operator 에이전트를 사용하여 현재 세션 파일만 선택적으로 커밋하고 푸시.
+
+---
+
+<critical_requirements>
+
+## ⚠️ CRITICAL: 작업 시작 전 필수 확인
+
+**이 커맨드는 반드시 @git-operator 에이전트를 사용해야 합니다.**
+
+### MANDATORY: Task 도구로 @git-operator 호출
+
+```typescript
+Task({
+  subagent_type: 'git-operator',
+  description: '세션 파일만 커밋 후 푸시',
+  prompt: `
+    세션 커밋 모드:
+    - 현재 세션 관련 파일만 선택적 커밋
+    - 반드시 푸시 (git push)
+    - 이전 세션의 미완성 작업은 제외
+  `
+})
+```
+
+**❌ 절대 금지:**
+- Bash 도구로 git 명령 직접 실행
+- @git-operator 없이 커밋/푸시 수행
+- 커맨드 내에서 직접 파일 분석
+
+**✅ 필수:**
+- Task 도구로 @git-operator 에이전트 호출
+- 모든 git 작업을 에이전트에 위임
+- 현재 세션 파일만 선택
+
+---
+
+**진행 전 자가 점검:**
+```text
+□ Task 도구 사용 준비?
+□ @git-operator 에이전트로 작업 위임?
+□ Bash로 git 직접 실행 안 함?
+```
+
+**⚠️ 위 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
+
+</critical_requirements>
+
+---
 
 <mode>
 

package/templates/.claude/commands/git.md

@@ -5,7 +5,52 @@ argument-hint: [push|pull|커밋 지시사항...]
 
 # Git Command
 
-@git-operator 에이전트를 사용하여 Git 작업 수행.
+> @git-operator 에이전트를 사용하여 Git 작업 수행.
+
+---
+
+<critical_requirements>
+
+## ⚠️ CRITICAL: 작업 시작 전 필수 확인
+
+**이 커맨드는 반드시 @git-operator 에이전트를 사용해야 합니다.**
+
+### MANDATORY: Task 도구로 @git-operator 호출
+
+```typescript
+Task({
+  subagent_type: 'git-operator',
+  description: 'Git 커밋 작업',
+  prompt: `
+    $ARGUMENTS 처리:
+    [사용자 인수 또는 기본 동작 설명]
+  `
+})
+```
+
+**❌ 절대 금지:**
+- Bash 도구로 git 명령 직접 실행
+- @git-operator 없이 커밋/푸시 수행
+- 커맨드 내에서 직접 파일 분석
+
+**✅ 필수:**
+- Task 도구로 @git-operator 에이전트 호출
+- 모든 git 작업을 에이전트에 위임
+
+---
+
+**진행 전 자가 점검:**
+```text
+□ Task 도구 사용 준비?
+□ @git-operator 에이전트로 작업 위임?
+□ Bash로 git 직접 실행 안 함?
+```
+
+**⚠️ 위 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
+
+</critical_requirements>
+
+---
 
 <mode>
 

package/templates/.claude/commands/lint-fix.md

@@ -1,12 +1,70 @@
 ---
-description: tsc/eslint 오류 검사 및 하나씩 꼼꼼히 수정. ultrathink + sequential thinking 필수 사용.
-allowed-tools: Bash(tsc:*, npx:*, yarn:*, npm:*, pnpm:*), Read, Edit, mcp__sequential-thinking__sequentialthinking
+description: tsc/eslint 오류 검사 및 하나씩 꼼꼼히 수정. @lint-fixer 에이전트 필수 사용.
+allowed-tools: Task
 argument-hint: [파일/디렉토리 경로...]
 ---
 
 # Lint Fix Command
 
-> tsc/eslint 오류를 Sequential Thinking으로 분석하여 하나씩 수정
+> @lint-fixer 에이전트를 사용하여 tsc/eslint 오류를 자동으로 수정.
+
+---
+
+<critical_requirements>
+
+## ⚠️ CRITICAL: 작업 시작 전 필수 확인
+
+**이 커맨드는 반드시 @lint-fixer 에이전트를 사용해야 합니다.**
+
+### MANDATORY: Task 도구로 @lint-fixer 호출
+
+```typescript
+Task({
+  subagent_type: 'lint-fixer',
+  description: 'tsc/eslint 오류 수정',
+  prompt: `
+    $ARGUMENTS 처리:
+    ${$ARGUMENTS ? `특정 경로: ${$ARGUMENTS}` : '전체 프로젝트 검사'}
+
+    수행할 작업:
+    1. tsc + eslint 병렬 검사
+    2. 오류 분류 (간단/복잡)
+    3. TodoWrite로 오류 목록 생성
+    4. 간단한 오류: 즉시 수정
+    5. 복잡한 오류: Sequential Thinking으로 분석 후 수정
+    6. 전체 재검사로 완료 확인
+  `
+})
+```
+
+**❌ 절대 금지:**
+- Bash 도구로 tsc/eslint 직접 실행 후 수동 수정
+- @lint-fixer 없이 오류 수정
+- 커맨드 내에서 직접 오류 분석/수정
+
+**✅ 필수:**
+- Task 도구로 @lint-fixer 에이전트 호출
+- 모든 lint 작업을 에이전트에 위임
+- 에이전트가 자동으로 간단/복잡 판단 후 처리
+
+**@lint-fixer 에이전트 장점:**
+- 간단한 오류는 즉시 수정 (Sequential Thinking 불필요)
+- 복잡한 오류만 Sequential Thinking 사용 (효율적)
+- TodoWrite로 진행 상황 자동 추적
+- 우선순위 자동 정렬 (타입 오류 → 린트 오류)
+
+---
+
+**진행 전 자가 점검:**
+```text
+□ Task 도구 사용 준비?
+□ @lint-fixer 에이전트로 작업 위임?
+□ Bash로 tsc/eslint 직접 실행 안 함?
+```
+
+**⚠️ 위 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
+
+</critical_requirements>
 
 ---
 

package/templates/tanstack-start/docs/architecture.md

@@ -19,6 +19,7 @@
 | **레이어** | Service Layer 건너뛰기, Routes에서 직접 DB 접근 |
 | **검증** | Handler 내부 수동 검증, 인증 로직 분산 |
 | **Server Fn** | `createServerFn` 사용 (명시 요청 없으면 `createServerOnlyFn`) |
+| **Barrel Export** | `functions/index.ts` 생성 (Tree Shaking 실패, 서버 라이브러리 Client 오염) |
 
 </forbidden>
 
@@ -144,7 +145,6 @@ services/<domain>/
 
 ```
 functions/                    # 글로벌 (재사용)
-├── index.ts
 ├── <function-name>.ts        # 파일당 하나
 └── middlewares/
     └── <middleware-name>.ts
@@ -153,6 +153,24 @@ routes/<route>/-functions/    # 페이지 전용
 └── <function-name>.ts
 ```
 
+> ⚠️ **`functions/index.ts` 생성 금지**
+>
+> `functions/` 폴더에 `index.ts` (barrel export) 파일을 만들지 마세요.
+>
+> **문제점:**
+> 1. **Tree Shaking 실패** - 번들러가 사용하지 않는 함수도 포함
+> 2. **Client 번들 오염** - `pg`, `prisma` 등 서버 전용 라이브러리가 클라이언트에 import되어 빌드 에러 발생
+>
+> ```typescript
+> // ❌ functions/index.ts 만들지 말 것
+> export * from './get-users'
+> export * from './create-post'  // pg import → 클라이언트 빌드 실패
+>
+> // ✅ 개별 파일에서 직접 import
+> import { getUsers } from '@/functions/get-users'
+> import { createPost } from '@/functions/create-post'
+> ```
+
 ### 4. Database Layer
 
 ```typescript

package/templates/tanstack-start/docs/guides/conventions.md

@@ -8,12 +8,20 @@
 
 ## 파일 네이밍
 
+> ⚠️ **camelCase 파일명 금지** - 모든 파일명은 **kebab-case** 사용
+
 | 타입 | 규칙 | 예시 |
 |------|------|------|
 | **일반 파일** | kebab-case | `user-profile.tsx`, `auth-service.ts` |
 | **Route 파일** | TanStack Router 규칙 | `__root.tsx`, `index.tsx`, `$id.tsx` |
-| **Hook 파일** | `use-` 접두사 | `use-user-filter.ts`, `use-auth.ts` |
-| **Component** | PascalCase (파일은 kebab) | `UserCard` in `user-card.tsx` |
+| **Hook 파일** | `use-` 접두사 + kebab-case | `use-user-filter.ts`, `use-auth.ts` |
+| **Component** | PascalCase 컴포넌트, kebab-case 파일 | `UserCard` in `user-card.tsx` |
+| **Server Function** | kebab-case | `get-users.ts`, `create-post.ts` |
+
+```
+❌ camelCase 금지: getUserById.ts, authService.ts, useUserFilter.ts
+✅ kebab-case 필수: get-user-by-id.ts, auth-service.ts, use-user-filter.ts
+```
 
 </naming>