@kood/claude-code 0.6.3 → 0.6.5

package/dist/index.js

@@ -426,14 +426,10 @@ async function promptTemplateSelection(options) {
         value: t
       })),
       {
-        min: 1,
-        hint: "- Space to select. Return to submit"
+        min: 0,
+        hint: "- Space to select, Enter to confirm (or skip to install extras only)"
       }
     );
-    if (response.values.length === 0) {
-      logger.warn("Operation cancelled.");
-      process.exit(0);
-    }
     templates = response.values;
   }
   const invalidTemplates = templates.filter(
@@ -773,13 +769,22 @@ async function promptForExtrasInstallation(options, hasSkills, hasCommands, hasA
   });
 }
 function showInstallationSummary(templates, flags, hasSkills, hasCommands, hasAgents, hasInstructions) {
+  const { installSkills, installCommands, installAgents, installInstructions } = flags;
+  const hasExtrasInstalled = installSkills && hasSkills || installCommands && hasCommands || installAgents && hasAgents || installInstructions && hasInstructions;
+  if (templates.length === 0 && !hasExtrasInstalled) {
+    logger.blank();
+    logger.info("No templates or extras installed.");
+    logger.blank();
+    return;
+  }
   logger.blank();
   logger.success("Claude Code documentation installed!");
-  logger.blank();
-  logger.info("Installed templates:");
-  templates.forEach((t) => logger.step(t));
-  const { installSkills, installCommands, installAgents, installInstructions } = flags;
-  if (installSkills && hasSkills || installCommands && hasCommands || installAgents && hasAgents || installInstructions && hasInstructions) {
+  if (templates.length > 0) {
+    logger.blank();
+    logger.info("Installed templates:");
+    templates.forEach((t) => logger.step(t));
+  }
+  if (hasExtrasInstalled) {
     logger.blank();
     logger.info("Installed extras:");
     if (installSkills && hasSkills) {
@@ -797,8 +802,13 @@ function showInstallationSummary(templates, flags, hasSkills, hasCommands, hasAg
   }
   logger.blank();
   logger.info("Next steps:");
-  logger.step("Read CLAUDE.md for project guidelines");
-  logger.step("Explore docs/ for detailed documentation");
+  if (templates.length > 0) {
+    logger.step("Read CLAUDE.md for project guidelines");
+    logger.step("Explore docs/ for detailed documentation");
+  } else {
+    logger.step("Explore .claude/ for installed extras");
+    logger.step('Run "npx @kood/claude-code init" again to install templates');
+  }
   logger.blank();
 }
 var init = async (options) => {
@@ -810,9 +820,12 @@ var init = async (options) => {
     process.exit(1);
   }
   const templates = await selectTemplates(options, availableTemplates);
-  await confirmOverwriteIfNeeded(targetDir, options.force ?? false);
-  await installTemplates(templates, targetDir);
-  const { hasSkills, hasCommands, hasAgents, hasInstructions } = await checkAllExtrasExist(templates);
+  if (templates.length > 0) {
+    await confirmOverwriteIfNeeded(targetDir, options.force ?? false);
+    await installTemplates(templates, targetDir);
+  }
+  const templatesToCheck = templates.length > 0 ? templates : availableTemplates;
+  const { hasSkills, hasCommands, hasAgents, hasInstructions } = await checkAllExtrasExist(templatesToCheck);
   const flags = await promptForExtrasInstallation(
     options,
     hasSkills,
@@ -821,7 +834,7 @@ var init = async (options) => {
     hasInstructions
   );
   await installExtras(
-    templates,
+    templatesToCheck,
     targetDir,
     flags,
     { hasSkills, hasCommands, hasAgents, hasInstructions },

package/package.json

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

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

@@ -2,58 +2,58 @@
 description: 모든 변경사항 커밋 후 푸시
 ---
 
-@../instructions/multi-agent/coordination-guide.md
-@../instructions/multi-agent/execution-patterns.md
-
 # Git All Command
 
-> @git-operator 에이전트를 사용하여 모든 변경사항을 커밋하고 푸시.
+> 모든 변경사항을 커밋하고 푸시.
 
 ---
 
-<critical_requirements>
+<scripts>
 
-## ⚠️ CRITICAL: 작업 시작 전 필수 확인
+## 사용 가능한 스크립트
 
-**이 커맨드는 반드시 @git-operator 에이전트를 사용해야 합니다.**
+| 스크립트 | 용도 |
+|----------|------|
+| `.claude/scripts/git/git-info.sh` | 상태 + diff 요약 출력 |
+| `.claude/scripts/git/git-commit.sh "msg" [files]` | Co-Authored-By 포함 커밋 |
+| `.claude/scripts/git/git-push.sh` | 안전한 푸시 |
+| `.claude/scripts/git/git-all.sh "msg"` | add all + commit + push (단순 케이스) |
+| `.claude/scripts/git/git-clean-check.sh` | clean 여부 확인 |
 
-### MANDATORY: Task 도구로 @git-operator 호출
+</scripts>
 
-```typescript
-Task({
-  subagent_type: 'git-operator',
-  description: '모든 변경사항 커밋 후 푸시',
-  prompt: `
-    전체 커밋 모드:
-    - 모든 변경사항을 논리적 단위로 분리하여 전부 커밋
-    - 반드시 푸시 (git push)
-    - clean working directory 확인 필수
-  `
-})
-```
+---
 
-**❌ 절대 금지:**
-- Bash 도구로 git 명령 직접 실행
-- @git-operator 없이 커밋/푸시 수행
-- 커맨드 내에서 직접 파일 분석
+<workflow>
 
-**✅ 필수:**
-- Task 도구로 @git-operator 에이전트 호출
-- 모든 git 작업을 에이전트에 위임
-- 완료 후 clean working directory 확인
+## 워크플로우
 
----
+### 단순 케이스 (단일 커밋)
 
-**진행 전 자가 점검:**
-```text
-□ Task 도구 사용 준비?
-□ @git-operator 에이전트로 작업 위임?
-□ Bash로 git 직접 실행 안 함?
+```bash
+# 1. 상태 확인
+.claude/scripts/git/git-info.sh
+
+# 2. 모든 변경사항 커밋 + 푸시
+.claude/scripts/git/git-all.sh "feat: 기능 추가"
 ```
 
-**⚠️ 위 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
+### 복잡한 케이스 (논리적 분리 필요)
+
+```bash
+# 1. 상태 확인
+.claude/scripts/git/git-info.sh
+
+# 2. 그룹별 커밋
+.claude/scripts/git/git-commit.sh "feat: A 기능" src/a.ts src/a.test.ts
+.claude/scripts/git/git-commit.sh "fix: B 버그 수정" src/b.ts
+
+# 3. clean 확인 후 푸시
+.claude/scripts/git/git-clean-check.sh
+.claude/scripts/git/git-push.sh
+```
 
-</critical_requirements>
+</workflow>
 
 ---
 
@@ -67,15 +67,3 @@ Task({
 
 </mode>
 
----
-
-<workflow>
-
-1. 모든 변경사항 분석
-2. 논리적 단위로 그룹핑
-3. 각 그룹별 커밋 (반복)
-4. clean working directory 확인
-5. git push 실행
-
-</workflow>
-

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

@@ -2,58 +2,43 @@
 description: 현재 세션에서 수정한 파일만 커밋 후 푸시
 ---
 
-@../instructions/multi-agent/coordination-guide.md
-@../instructions/multi-agent/execution-patterns.md
-
 # Git Session Command
 
-> @git-operator 에이전트를 사용하여 현재 세션 파일만 선택적으로 커밋하고 푸시.
+> 현재 세션 파일만 선택적으로 커밋하고 푸시.
 
 ---
 
-<critical_requirements>
+<scripts>
 
-## ⚠️ CRITICAL: 작업 시작 전 필수 확인
+## 사용 가능한 스크립트
 
-**이 커맨드는 반드시 @git-operator 에이전트를 사용해야 합니다.**
+| 스크립트 | 용도 |
+|----------|------|
+| `.claude/scripts/git/git-info.sh` | 상태 + diff 요약 출력 |
+| `.claude/scripts/git/git-commit.sh "msg" [files]` | Co-Authored-By 포함 커밋 |
+| `.claude/scripts/git/git-push.sh` | 안전한 푸시 |
+| `.claude/scripts/git/git-clean-check.sh` | clean 여부 확인 |
 
-### MANDATORY: Task 도구로 @git-operator 호출
+</scripts>
 
-```typescript
-Task({
-  subagent_type: 'git-operator',
-  description: '세션 파일만 커밋 후 푸시',
-  prompt: `
-    세션 커밋 모드:
-    - 현재 세션 관련 파일만 선택적 커밋
-    - 반드시 푸시 (git push)
-    - 이전 세션의 미완성 작업은 제외
-  `
-})
-```
+---
+
+<workflow>
 
-**❌ 절대 금지:**
-- Bash 도구로 git 명령 직접 실행
-- @git-operator 없이 커밋/푸시 수행
-- 커맨드 내에서 직접 파일 분석
+## 워크플로우
 
-**✅ 필수:**
-- Task 도구로 @git-operator 에이전트 호출
-- 모든 git 작업을 에이전트에 위임
-- 현재 세션 파일만 선택
+```bash
+# 1. 상태 확인
+.claude/scripts/git/git-info.sh
 
----
+# 2. 현재 세션 파일만 선택하여 커밋
+.claude/scripts/git/git-commit.sh "feat: 로그인 기능" src/auth/login.ts src/auth/logout.ts
 
-**진행 전 자가 점검:**
-```text
-□ Task 도구 사용 준비?
-□ @git-operator 에이전트로 작업 위임?
-□ Bash로 git 직접 실행 안 함?
+# 3. 푸시
+.claude/scripts/git/git-push.sh
 ```
 
-**⚠️ 위 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
-
-</critical_requirements>
+</workflow>
 
 ---
 
@@ -80,31 +65,19 @@ Task({
 
 ---
 
-<workflow>
-
-1. 모든 변경사항 분석
-2. **현재 세션 관련 파일만 선택**
-3. 논리적 단위로 그룹핑
-4. 각 그룹별 커밋
-5. git push 실행
-
-</workflow>
-
----
-
 <example>
 
 ```bash
 # 상황: 로그인 기능 작업 중, 이전 프로필 기능은 미완성
 
-git status
+.claude/scripts/git/git-info.sh
 # modified: src/auth/login.ts (현재 세션)
 # modified: src/auth/logout.ts (현재 세션)
 # modified: src/profile/edit.ts (이전 세션)
 
 # ✅ 로그인 관련만 커밋
-git add src/auth/login.ts src/auth/logout.ts && git commit -m "feat: 로그인/로그아웃 기능 추가"
-git push
+.claude/scripts/git/git-commit.sh "feat: 로그인/로그아웃 기능 추가" src/auth/login.ts src/auth/logout.ts
+.claude/scripts/git/git-push.sh
 ```
 
 </example>

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

@@ -4,70 +4,47 @@ allowed-tools: Task
 argument-hint: [파일/디렉토리 경로...]
 ---
 
-@../instructions/multi-agent/coordination-guide.md
-@../instructions/multi-agent/execution-patterns.md
-
 # Lint Fix Command
 
-> @lint-fixer 에이전트를 사용하여 tsc/eslint 오류를 자동으로 수정.
+> tsc/eslint 오류를 자동으로 수정.
 
 ---
 
-<critical_requirements>
+<scripts>
 
-## ⚠️ CRITICAL: 작업 시작 전 필수 확인
+## 사용 가능한 스크립트
 
-**이 커맨드는 반드시 @lint-fixer 에이전트를 사용해야 합니다.**
+| 스크립트 | 용도 |
+|----------|------|
+| `.claude/scripts/lint/lint-check.sh` | tsc + eslint 병렬 검사 |
+| `.claude/scripts/lint/lint-file.sh [files]` | 특정 파일만 검사 |
 
-### MANDATORY: Task 도구로 @lint-fixer 호출
+</scripts>
 
-```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 없이 오류 수정
-- 커맨드 내에서 직접 오류 분석/수정
+<workflow>
 
-**✅ 필수:**
-- Task 도구로 @lint-fixer 에이전트 호출
-- 모든 lint 작업을 에이전트에 위임
-- 에이전트가 자동으로 간단/복잡 판단 후 처리
+## 워크플로우
 
-**@lint-fixer 에이전트 장점:**
-- 간단한 오류는 즉시 수정 (Sequential Thinking 불필요)
-- 복잡한 오류만 Sequential Thinking 사용 (효율적)
-- TodoWrite로 진행 상황 자동 추적
-- 우선순위 자동 정렬 (타입 오류 → 린트 오류)
+### 전체 검사
 
----
+```bash
+# 1. 병렬 검사 (tsc + eslint 동시)
+.claude/scripts/lint/lint-check.sh
 
-**진행 전 자가 점검:**
-```text
-□ Task 도구 사용 준비?
-□ @lint-fixer 에이전트로 작업 위임?
-□ Bash로 tsc/eslint 직접 실행 안 함?
+# 2. 오류 수정 후 재검사
+.claude/scripts/lint/lint-check.sh
 ```
 
-**⚠️ 위 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
+### 특정 파일 검사
 
-</critical_requirements>
+```bash
+# 특정 파일만
+.claude/scripts/lint/lint-file.sh src/utils/api.ts src/components/Button.tsx
+```
+
+</workflow>
 
 ---
 

package/templates/.claude/commands/pre-deploy.md

@@ -1,129 +1,52 @@
 ---
-description: 배포 전 typecheck/lint/build 검증 및 수정. ultrathink + sequential thinking 필수 사용.
-allowed-tools: Bash(tsc:*, npx:*, yarn:*, npm:*, pnpm:*), Read, Edit, mcp__sequential-thinking__sequentialthinking
+description: 배포 전 typecheck/lint/build 검증 및 수정.
+allowed-tools: Bash, Read, Edit, mcp__sequential-thinking__sequentialthinking
 argument-hint: [파일/디렉토리 경로...]
 ---
 
-@../instructions/multi-agent/coordination-guide.md
-@../instructions/multi-agent/execution-patterns.md
-
 # Pre-Deploy Command
 
-> 배포 전 typecheck/lint/build를 Sequential Thinking으로 검증하고 수정
+> 배포 전 typecheck/lint/build 검증
 
 ---
 
-<forbidden>
+<scripts>
 
-| 분류 | 금지 |
-|------|------|
-| **회피** | 오류 무시하고 배포, `any` 타입, `@ts-ignore`, `eslint-disable` 남발 |
-| **전략** | 여러 오류 동시 수정, build 생략, 오류 메시지만 보고 급하게 수정 |
-| **분석** | Sequential Thinking 없이 수정 |
+## 사용 가능한 스크립트
+
+| 스크립트 | 용도 |
+|----------|------|
+| `.claude/scripts/deploy/deploy-check.sh` | 전체 검증 (tsc + eslint + build) |
+| `.claude/scripts/deploy/build-run.sh` | build만 실행 |
+| `.claude/scripts/lint/lint-check.sh` | tsc + eslint 병렬 검사 |
+| `.claude/scripts/pm/pm-detect.sh` | package manager 감지 |
 
-</forbidden>
+</scripts>
 
 ---
 
-<agent_usage>
+<workflow>
 
-## @deployment-validator Agent 활용
+## 워크플로우
 
-**언제 사용:**
-- PR 생성 전 전체 검증
-- 배포 전 품질 보증
-- CI/CD 전 로컬 검증
+### 전체 검증 (권장)
 
-**호출 방법:**
 ```bash
-@deployment-validator
-# 또는 자연어
-"배포 준비 완료 체크해줘"
-"pre-deploy 검증해줘"
+# 한 번에 tsc + eslint + build 검증
+.claude/scripts/deploy/deploy-check.sh
 ```
 
-**장점:**
-- typecheck + lint + build 전체 자동화
-- Build 실패 시 Sequential Thinking으로 원인 자동 분석
-- 배포 가능 여부 최종 판단
-- 독립적 context에서 실행 (메인 작업 병렬 가능)
-
-**직접 검증 vs Agent:**
-
-| 상황 | 권장 방법 |
-|------|----------|
-| 빠른 개발 중 | 직접 검증 (command) |
-| PR 생성 전 | @deployment-validator |
-| 배포 전 최종 확인 | @deployment-validator |
-| CI/CD 전 로컬 확인 | @deployment-validator |
-| 자동화된 검증 | @deployment-validator |
+### 단계별 검증
 
----
-
-## @security-reviewer Agent 활용
-
-**언제 사용:**
-- 배포 전 보안 취약점 검토
-- 코드 변경 후 보안 검증
-- 인증/권한/데이터 처리 로직 추가 시
-
-**호출 방법:**
 ```bash
-@security-reviewer
-# 또는 자연어
-"배포 전 보안 검토해줘"
-"보안 취약점 체크해줘"
-```
+# 1. lint 검사
+.claude/scripts/lint/lint-check.sh
 
-**장점:**
-- OWASP Top 10 자동 검토
-- 시크릿 노출 탐지 (API 키, 비밀번호 하드코딩)
-- 입력 검증 체크 (SQL Injection, XSS, CSRF)
-- 인증/권한 로직 검증
-- 독립적 context에서 실행 (메인 작업 병렬 가능)
-
-**검토 범위:**
-- SQL Injection: Prisma raw query 사용 시
-- XSS: HTML/dangerouslySetInnerHTML 사용 시
-- CSRF: POST/PUT/DELETE 엔드포인트
-- 인증: middleware 누락 여부
-- 시크릿: .env 변수 하드코딩 여부
-- 입력 검증: Zod validator 누락 여부
-
----
-
-## @build-fixer Agent 활용
-
-**언제 사용:**
-- 빌드/타입 오류 다수 발생
-- 빠른 자동 수정 필요
-- 반복적인 타입 오류 일괄 수정
-
-**호출 방법:**
-```bash
-@build-fixer
-# 또는 자연어
-"빌드 오류 수정해줘"
-"타입 오류 자동 수정해줘"
+# 2. 오류 수정 후 build
+.claude/scripts/deploy/build-run.sh
 ```
 
-**장점:**
-- 최소 diff로 오류 수정
-- 언어 자동 감지 (TypeScript, Python, Go 등)
-- 여러 오류 효율적 처리
-- Sequential Thinking 자동 적용
-- 독립적 context에서 실행
-
-**직접 수정 vs Agent:**
-
-| 상황 | 권장 방법 |
-|------|----------|
-| 1-2개 단순 오류 | 직접 수정 (command) |
-| 5개+ 반복적 오류 | @build-fixer |
-| 리팩토링 후 다수 오류 | @build-fixer |
-| 라이브러리 업그레이드 후 | @build-fixer |
-
-</agent_usage>
+</workflow>
 
 ---
 

package/templates/.claude/commands/version-update.md

@@ -4,15 +4,29 @@ allowed-tools: Bash, Read, Edit
 argument-hint: <new-version | +1 | +minor | +major>
 ---
 
-@../instructions/multi-agent/coordination-guide.md
-@../instructions/multi-agent/execution-patterns.md
-
 # Version Update Command
 
 프로젝트 전체 버전을 업데이트하고 커밋.
 
 **인수**: $ARGUMENTS
 
+---
+
+<scripts>
+
+## 사용 가능한 스크립트
+
+| 스크립트 | 용도 |
+|----------|------|
+| `.claude/scripts/version/version-find.sh` | 버전 파일 탐색 (package.json + .version()) |
+| `.claude/scripts/version/version-bump.sh <current> <type>` | 새 버전 계산 |
+| `.claude/scripts/git/git-commit.sh "msg" [files]` | 커밋 |
+| `.claude/scripts/git/git-push.sh` | 푸시 |
+
+</scripts>
+
+---
+
 <version_rules>
 
 | 인수 | 동작 | 예시 |
@@ -24,39 +38,27 @@ argument-hint: <new-version | +1 | +minor | +major>
 
 </version_rules>
 
-<workflow>
-
-1. **버전 파일 탐색**
-   ```bash
-   # package.json 찾기 (root 또는 monorepo packages/)
-   fd -t f 'package.json' -E node_modules
+---
 
-   # 버전 코드 찾기 (.version() 패턴)
-   rg "\.version\(['\"]" --type ts --type js -l
-   ```
+<workflow>
 
-2. **현재 버전 확인** (병렬 읽기)
-   - 발견된 package.json 파일들
-   - 버전 코드 포함 파일들
+## 워크플로우
 
-3. **새 버전 계산**
+```bash
+# 1. 버전 파일 탐색
+.claude/scripts/version/version-find.sh
 
-4. **모든 파일 Edit로 업데이트**
+# 2. 현재 버전 확인 (package.json 읽기)
 
-5. **스테이징**
-   ```bash
-   git add <발견된-버전-파일들>
-   ```
+# 3. 새 버전 계산
+.claude/scripts/version/version-bump.sh 1.2.3 +1
+# → 1.2.4
 
-6. **커밋**
-   ```bash
-   git commit -m "chore: 버전 X.X.X로 업데이트"
-   ```
+# 4. 모든 파일 Edit로 업데이트
 
-7. **완료 확인**
-   ```bash
-   git status
-   ```
+# 5. 커밋
+.claude/scripts/git/git-commit.sh "chore: 버전 1.2.4로 업데이트" package.json packages/*/package.json
+```
 
 </workflow>