@kood/claude-code 0.6.5 → 0.6.6

package/dist/index.js

@@ -23,6 +23,7 @@ var banner = () => {
 
 // src/commands/init.ts
 import fs8 from "fs-extra";
+import os from "os";
 
 // src/features/templates/template-path-resolver.ts
 import path2 from "path";
@@ -319,6 +320,7 @@ var createExtrasCopier = (extrasType) => {
 var copyCommands = createExtrasCopier("commands");
 var copyAgents = createExtrasCopier("agents");
 var copyInstructions = createExtrasCopier("instructions");
+var copyScripts = createExtrasCopier("scripts");
 var getSkillsToInstall = async (skillsSrc, templates) => {
   const metadataMap = await loadAllSkillMetadata(skillsSrc);
   const isNonUITemplate = templates.some((t) => NON_UI_TEMPLATES.includes(t));
@@ -363,6 +365,7 @@ var checkExistingClaudeFiles = async (targetDir) => {
   const commandsDir = path8.join(targetDir, ".claude", "commands");
   const agentsDir = path8.join(targetDir, ".claude", "agents");
   const instructionsDir = path8.join(targetDir, ".claude", "instructions");
+  const scriptsDir = path8.join(targetDir, ".claude", "scripts");
   if (await fs6.pathExists(skillsDir)) {
     existingFiles.push(".claude/skills/");
   }
@@ -375,6 +378,9 @@ var checkExistingClaudeFiles = async (targetDir) => {
   if (await fs6.pathExists(instructionsDir)) {
     existingFiles.push(".claude/instructions/");
   }
+  if (await fs6.pathExists(scriptsDir)) {
+    existingFiles.push(".claude/scripts/");
+  }
   return existingFiles;
 };
 var checkAllExtrasExist = async (_templates) => {
@@ -383,13 +389,150 @@ var checkAllExtrasExist = async (_templates) => {
   const commandsSrc = path8.join(claudeDir, "commands");
   const agentsSrc = path8.join(claudeDir, "agents");
   const instructionsSrc = path8.join(claudeDir, "instructions");
+  const scriptsSrc = path8.join(claudeDir, "scripts");
   const hasSkills = await hasFiles(skillsSrc);
   const hasCommands = await hasFiles(commandsSrc);
   const hasAgents = await hasFiles(agentsSrc);
   const hasInstructions = await hasFiles(instructionsSrc);
-  return { hasSkills, hasCommands, hasAgents, hasInstructions };
+  const hasScripts = await hasFiles(scriptsSrc);
+  return { hasSkills, hasCommands, hasAgents, hasInstructions, hasScripts };
 };
 
+// src/features/extras/extras-installer.ts
+function logExistingFilesUpdate(existingClaudeFiles) {
+  if (existingClaudeFiles.length > 0) {
+    logger.info("Updating existing extras:");
+    existingClaudeFiles.forEach((f) => logger.step(f));
+  }
+}
+async function installSkillsIfNeeded(templates, targetDir, shouldInstall, hasSkills) {
+  if (!shouldInstall) {
+    return { files: 0, directories: 0 };
+  }
+  if (!hasSkills) {
+    logger.warn("No skills found in selected templates.");
+    return { files: 0, directories: 0 };
+  }
+  logger.blank();
+  logger.info("Installing skills...");
+  const skillsResult = await copySkills(templates, targetDir);
+  logger.success(
+    `Skills: ${skillsResult.files} files, ${skillsResult.directories} directories`
+  );
+  return skillsResult;
+}
+async function installCommandsIfNeeded(templates, targetDir, shouldInstall, hasCommands) {
+  if (!shouldInstall) {
+    return { files: 0, directories: 0 };
+  }
+  if (!hasCommands) {
+    logger.warn("No commands found in selected templates.");
+    return { files: 0, directories: 0 };
+  }
+  logger.blank();
+  logger.info("Installing commands...");
+  const commandsResult = await copyCommands(templates, targetDir);
+  logger.success(
+    `Commands: ${commandsResult.files} files, ${commandsResult.directories} directories`
+  );
+  return commandsResult;
+}
+async function installAgentsIfNeeded(templates, targetDir, shouldInstall, hasAgents) {
+  if (!shouldInstall) {
+    return { files: 0, directories: 0 };
+  }
+  if (!hasAgents) {
+    logger.warn("No agents found in selected templates.");
+    return { files: 0, directories: 0 };
+  }
+  logger.blank();
+  logger.info("Installing agents...");
+  const agentsResult = await copyAgents(templates, targetDir);
+  logger.success(
+    `Agents: ${agentsResult.files} files, ${agentsResult.directories} directories`
+  );
+  return agentsResult;
+}
+async function installScriptsIfNeeded(templates, targetDir, shouldInstall, hasScripts) {
+  if (!shouldInstall) {
+    return { files: 0, directories: 0 };
+  }
+  if (!hasScripts) {
+    logger.warn("No scripts found in selected templates.");
+    return { files: 0, directories: 0 };
+  }
+  logger.blank();
+  logger.info("Installing scripts...");
+  const scriptsResult = await copyScripts(templates, targetDir);
+  logger.success(
+    `Scripts: ${scriptsResult.files} files, ${scriptsResult.directories} directories`
+  );
+  return scriptsResult;
+}
+async function installInstructionsIfNeeded(templates, targetDir, shouldInstall, hasInstructions) {
+  if (!shouldInstall) {
+    return { files: 0, directories: 0 };
+  }
+  if (!hasInstructions) {
+    logger.warn("No instructions found in selected templates.");
+    return { files: 0, directories: 0 };
+  }
+  logger.blank();
+  logger.info("Installing instructions...");
+  const instructionsResult = await copyInstructions(templates, targetDir);
+  logger.success(
+    `Instructions: ${instructionsResult.files} files, ${instructionsResult.directories} directories`
+  );
+  return instructionsResult;
+}
+async function installExtras(templates, targetDir, flags, availability) {
+  const {
+    installSkills,
+    installCommands,
+    installAgents,
+    installInstructions,
+    installScripts
+  } = flags;
+  if (!installSkills && !installCommands && !installAgents && !installInstructions && !installScripts) {
+    return { files: 0, directories: 0 };
+  }
+  const existingClaudeFiles = await checkExistingClaudeFiles(targetDir);
+  logExistingFilesUpdate(existingClaudeFiles);
+  const skillsResult = await installSkillsIfNeeded(
+    templates,
+    targetDir,
+    installSkills,
+    availability.hasSkills
+  );
+  const commandsResult = await installCommandsIfNeeded(
+    templates,
+    targetDir,
+    installCommands,
+    availability.hasCommands
+  );
+  const agentsResult = await installAgentsIfNeeded(
+    templates,
+    targetDir,
+    installAgents,
+    availability.hasAgents
+  );
+  const instructionsResult = await installInstructionsIfNeeded(
+    templates,
+    targetDir,
+    installInstructions,
+    availability.hasInstructions
+  );
+  const scriptsResult = await installScriptsIfNeeded(
+    templates,
+    targetDir,
+    installScripts,
+    availability.hasScripts
+  );
+  const totalFiles = skillsResult.files + commandsResult.files + agentsResult.files + instructionsResult.files + scriptsResult.files;
+  const totalDirectories = skillsResult.directories + commandsResult.directories + agentsResult.directories + instructionsResult.directories + scriptsResult.directories;
+  return { files: totalFiles, directories: totalDirectories };
+}
+
 // src/shared/prompts/prompt-helpers.ts
 import prompts from "prompts";
 async function promptConfirm(message, initial = false) {
@@ -401,6 +544,15 @@ async function promptConfirm(message, initial = false) {
   });
   return { confirmed: response.confirmed ?? false };
 }
+async function promptSelect(message, choices) {
+  const response = await prompts({
+    type: "select",
+    name: "value",
+    message,
+    choices
+  });
+  return { value: response.value };
+}
 async function promptMultiselect(message, choices, options) {
   const response = await prompts({
     type: "multiselect",
@@ -461,17 +613,20 @@ async function promptExtrasSelection(options) {
     commands,
     agents,
     instructions,
+    scripts,
     hasSkills,
     hasCommands,
     hasAgents,
-    hasInstructions
+    hasInstructions,
+    hasScripts
   } = options;
   let installSkills = skills ?? false;
   let installCommands = commands ?? false;
   const installAgents = agents ?? hasAgents;
   const installInstructions = instructions ?? hasInstructions;
-  const noOptionsProvided = skills === void 0 && commands === void 0 && agents === void 0 && instructions === void 0;
-  if (noOptionsProvided && (hasSkills || hasCommands || hasAgents || hasInstructions)) {
+  const installScripts = scripts ?? hasScripts;
+  const noOptionsProvided = skills === void 0 && commands === void 0 && agents === void 0 && instructions === void 0 && scripts === void 0;
+  if (noOptionsProvided && (hasSkills || hasCommands || hasAgents || hasInstructions || hasScripts)) {
     logger.blank();
     if (hasSkills) {
       const result = await promptConfirm(
@@ -492,126 +647,41 @@ async function promptExtrasSelection(options) {
     installSkills,
     installCommands,
     installAgents,
-    installInstructions
+    installInstructions,
+    installScripts
   };
 }
-
-// src/features/extras/extras-installer.ts
-async function handleDuplicateFiles(existingClaudeFiles, force) {
-  if (existingClaudeFiles.length === 0 || force) {
-    return true;
-  }
-  logger.warn("The following .claude files/folders already exist:");
-  existingClaudeFiles.forEach((f) => logger.step(f));
-  logger.blank();
-  const response = await promptConfirm(
-    "Overwrite existing .claude files?",
-    false
-  );
-  return response.confirmed;
-}
-async function installSkillsIfNeeded(templates, targetDir, shouldInstall, hasSkills) {
-  if (!shouldInstall) {
-    return { files: 0, directories: 0 };
-  }
-  if (!hasSkills) {
-    logger.warn("No skills found in selected templates.");
-    return { files: 0, directories: 0 };
-  }
-  logger.blank();
-  logger.info("Installing skills...");
-  const skillsResult = await copySkills(templates, targetDir);
-  logger.success(
-    `Skills: ${skillsResult.files} files, ${skillsResult.directories} directories`
-  );
-  return skillsResult;
-}
-async function installCommandsIfNeeded(templates, targetDir, shouldInstall, hasCommands) {
-  if (!shouldInstall) {
-    return { files: 0, directories: 0 };
-  }
-  if (!hasCommands) {
-    logger.warn("No commands found in selected templates.");
-    return { files: 0, directories: 0 };
-  }
-  logger.blank();
-  logger.info("Installing commands...");
-  const commandsResult = await copyCommands(templates, targetDir);
-  logger.success(
-    `Commands: ${commandsResult.files} files, ${commandsResult.directories} directories`
-  );
-  return commandsResult;
-}
-async function installAgentsIfNeeded(templates, targetDir, shouldInstall, hasAgents) {
-  if (!shouldInstall) {
-    return { files: 0, directories: 0 };
-  }
-  if (!hasAgents) {
-    logger.warn("No agents found in selected templates.");
-    return { files: 0, directories: 0 };
-  }
-  logger.blank();
-  logger.info("Installing agents...");
-  const agentsResult = await copyAgents(templates, targetDir);
-  logger.success(
-    `Agents: ${agentsResult.files} files, ${agentsResult.directories} directories`
-  );
-  return agentsResult;
-}
-async function installInstructionsIfNeeded(templates, targetDir, shouldInstall, hasInstructions) {
-  if (!shouldInstall) {
-    return { files: 0, directories: 0 };
-  }
-  if (!hasInstructions) {
-    logger.warn("No instructions found in selected templates.");
-    return { files: 0, directories: 0 };
+async function promptScopeSelection(options) {
+  const { providedScope } = options;
+  if (providedScope) {
+    if (providedScope !== "project" && providedScope !== "user") {
+      logger.error(
+        `Invalid scope: "${providedScope}". Use "project" or "user".`
+      );
+      process.exit(1);
+    }
+    return { scope: providedScope };
   }
-  logger.blank();
-  logger.info("Installing instructions...");
-  const instructionsResult = await copyInstructions(templates, targetDir);
-  logger.success(
-    `Instructions: ${instructionsResult.files} files, ${instructionsResult.directories} directories`
+  const response = await promptSelect(
+    "Select installation scope:",
+    [
+      {
+        title: "Project",
+        description: "Install to current project (.claude/)",
+        value: "project"
+      },
+      {
+        title: "User",
+        description: "Install to user home (~/.claude/)",
+        value: "user"
+      }
+    ]
   );
-  return instructionsResult;
-}
-async function installExtras(templates, targetDir, flags, availability, force) {
-  const { installSkills, installCommands, installAgents, installInstructions } = flags;
-  if (!installSkills && !installCommands && !installAgents && !installInstructions) {
-    return { files: 0, directories: 0 };
-  }
-  const existingClaudeFiles = await checkExistingClaudeFiles(targetDir);
-  const shouldProceed = await handleDuplicateFiles(existingClaudeFiles, force);
-  if (!shouldProceed) {
-    logger.info("Skipping extras installation.");
-    return { files: 0, directories: 0 };
+  if (!response.value) {
+    logger.info("Operation cancelled.");
+    process.exit(0);
   }
-  const skillsResult = await installSkillsIfNeeded(
-    templates,
-    targetDir,
-    installSkills,
-    availability.hasSkills
-  );
-  const commandsResult = await installCommandsIfNeeded(
-    templates,
-    targetDir,
-    installCommands,
-    availability.hasCommands
-  );
-  const agentsResult = await installAgentsIfNeeded(
-    templates,
-    targetDir,
-    installAgents,
-    availability.hasAgents
-  );
-  const instructionsResult = await installInstructionsIfNeeded(
-    templates,
-    targetDir,
-    installInstructions,
-    availability.hasInstructions
-  );
-  const totalFiles = skillsResult.files + commandsResult.files + agentsResult.files + instructionsResult.files;
-  const totalDirectories = skillsResult.directories + commandsResult.directories + agentsResult.directories + instructionsResult.directories;
-  return { files: totalFiles, directories: totalDirectories };
+  return { scope: response.value };
 }
 
 // src/shared/gitignore-manager.ts
@@ -756,29 +826,38 @@ async function installTemplates(templates, targetDir) {
   logger.success(`Total: ${totalFiles} files, ${totalDirectories} directories`);
   return { files: totalFiles, directories: totalDirectories };
 }
-async function promptForExtrasInstallation(options, hasSkills, hasCommands, hasAgents, hasInstructions) {
+async function promptForExtrasInstallation(options, hasSkills, hasCommands, hasAgents, hasInstructions, hasScripts) {
   return await promptExtrasSelection({
     skills: options.skills,
     commands: options.commands,
     agents: options.agents,
     instructions: options.instructions,
+    scripts: options.scripts,
     hasSkills,
     hasCommands,
     hasAgents,
-    hasInstructions
+    hasInstructions,
+    hasScripts
   });
 }
-function showInstallationSummary(templates, flags, hasSkills, hasCommands, hasAgents, hasInstructions) {
-  const { installSkills, installCommands, installAgents, installInstructions } = flags;
-  const hasExtrasInstalled = installSkills && hasSkills || installCommands && hasCommands || installAgents && hasAgents || installInstructions && hasInstructions;
+function showInstallationSummary(templates, flags, hasSkills, hasCommands, hasAgents, hasInstructions, hasScripts, scope) {
+  const {
+    installSkills,
+    installCommands,
+    installAgents,
+    installInstructions,
+    installScripts
+  } = flags;
+  const hasExtrasInstalled = installSkills && hasSkills || installCommands && hasCommands || installAgents && hasAgents || installInstructions && hasInstructions || installScripts && hasScripts;
   if (templates.length === 0 && !hasExtrasInstalled) {
     logger.blank();
     logger.info("No templates or extras installed.");
     logger.blank();
     return;
   }
+  const scopeLabel = scope === "user" ? "(user scope \u2192 ~/.claude/)" : "(project scope)";
   logger.blank();
-  logger.success("Claude Code documentation installed!");
+  logger.success(`Claude Code documentation installed! ${scopeLabel}`);
   if (templates.length > 0) {
     logger.blank();
     logger.info("Installed templates:");
@@ -799,6 +878,9 @@ function showInstallationSummary(templates, flags, hasSkills, hasCommands, hasAg
     if (installInstructions && hasInstructions) {
       logger.step("Instructions \u2192 .claude/instructions/");
     }
+    if (installScripts && hasScripts) {
+      logger.step("Scripts \u2192 .claude/scripts/");
+    }
   }
   logger.blank();
   logger.info("Next steps:");
@@ -812,48 +894,65 @@ function showInstallationSummary(templates, flags, hasSkills, hasCommands, hasAg
   logger.blank();
 }
 var init = async (options) => {
-  const targetDir = options.cwd || process.cwd();
-  await validateTargetDirectory(targetDir);
+  const projectDir = options.cwd || process.cwd();
+  await validateTargetDirectory(projectDir);
+  const { scope } = await promptScopeSelection({
+    providedScope: options.scope
+  });
+  const targetDir = scope === "user" ? os.homedir() : projectDir;
+  const isUserScope = scope === "user";
+  if (isUserScope) {
+    logger.blank();
+    logger.info(`Installing to ~/.claude/ (user scope)`);
+  }
   const availableTemplates = await listAvailableTemplates();
   if (availableTemplates.length === 0) {
     logger.error("No templates found. Package may be corrupted.");
     process.exit(1);
   }
-  const templates = await selectTemplates(options, availableTemplates);
-  if (templates.length > 0) {
-    await confirmOverwriteIfNeeded(targetDir, options.force ?? false);
-    await installTemplates(templates, targetDir);
+  let templates = [];
+  if (!isUserScope) {
+    templates = await selectTemplates(options, availableTemplates);
+    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 { hasSkills, hasCommands, hasAgents, hasInstructions, hasScripts } = await checkAllExtrasExist(templatesToCheck);
   const flags = await promptForExtrasInstallation(
     options,
     hasSkills,
     hasCommands,
     hasAgents,
-    hasInstructions
-  );
-  await installExtras(
-    templatesToCheck,
-    targetDir,
-    flags,
-    { hasSkills, hasCommands, hasAgents, hasInstructions },
-    options.force ?? false
+    hasInstructions,
+    hasScripts
   );
+  await installExtras(templatesToCheck, targetDir, flags, {
+    hasSkills,
+    hasCommands,
+    hasAgents,
+    hasInstructions,
+    hasScripts
+  });
   showInstallationSummary(
     templates,
     flags,
     hasSkills,
     hasCommands,
     hasAgents,
-    hasInstructions
+    hasInstructions,
+    hasScripts,
+    scope
   );
-  try {
-    await updateGitignore(targetDir);
-  } catch (error) {
-    logger.warn(
-      `Failed to update .gitignore: ${error instanceof Error ? error.message : "Unknown error"}`
-    );
+  if (!isUserScope) {
+    try {
+      await updateGitignore(targetDir);
+    } catch (error) {
+      logger.warn(
+        `Failed to update .gitignore: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
   }
 };
 
@@ -863,7 +962,7 @@ program.name("claude-code").description("Claude Code documentation installer for
 program.option(
   "-t, --template <names>",
   "template names (comma-separated: tanstack-start,hono)"
-).option("-f, --force", "overwrite existing files without prompting").option("--cwd <path>", "target directory (default: current directory)").option("--list", "list available templates").option("-s, --skills", "install skills to .claude/skills/").option("-c, --commands", "install commands to .claude/commands/").option("-a, --agents", "install agents to .claude/agents/").action(async (options) => {
+).option("-f, --force", "overwrite existing files without prompting").option("--cwd <path>", "target directory (default: current directory)").option("--list", "list available templates").option("-s, --skills", "install skills to .claude/skills/").option("-c, --commands", "install commands to .claude/commands/").option("-a, --agents", "install agents to .claude/agents/").option("--scope <scope>", "installation scope (project|user)").action(async (options) => {
   banner();
   if (options.list) {
     const templates = await listAvailableTemplates();
@@ -876,6 +975,7 @@ program.option(
     templates: options.template?.split(",").map((t) => t.trim()),
     force: options.force,
     cwd: options.cwd,
+    scope: options.scope,
     skills: options.skills,
     commands: options.commands,
     agents: options.agents

package/package.json

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

package/templates/.claude/scripts/deploy/build-run.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# build-run.sh - Package manager 감지 후 build 실행
+# Usage: ./build-run.sh
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PM_DIR="$SCRIPT_DIR/../pm"
+
+# Package manager 감지
+PM=$("$PM_DIR/pm-detect.sh")
+
+echo "=== Building with $PM ==="
+
+# Build 실행
+case "$PM" in
+  bun)
+    bun run build
+    ;;
+  pnpm)
+    pnpm run build
+    ;;
+  yarn)
+    yarn build
+    ;;
+  npm)
+    npm run build
+    ;;
+  *)
+    echo "Error: Unknown package manager: $PM" >&2
+    exit 1
+    ;;
+esac
+
+echo ""
+echo "✓ Build completed successfully"

package/templates/.claude/scripts/deploy/deploy-check.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# deploy-check.sh - 배포 전 전체 검증 (tsc + eslint + build)
+# Usage: ./deploy-check.sh
+# 검사 실패 시 조기 종료
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LINT_DIR="$SCRIPT_DIR/../lint"
+
+echo "=========================================="
+echo "  Pre-Deploy Verification"
+echo "=========================================="
+
+# 스크립트 존재 검증
+if [ ! -x "$LINT_DIR/lint-check.sh" ]; then
+  echo "Error: lint-check.sh not found or not executable" >&2
+  exit 1
+fi
+if [ ! -x "$SCRIPT_DIR/build-run.sh" ]; then
+  echo "Error: build-run.sh not found or not executable" >&2
+  exit 1
+fi
+
+# Step 1: Lint 검사 (tsc + eslint 병렬)
+echo ""
+echo "[1/2] Running lint checks..."
+"$LINT_DIR/lint-check.sh"
+
+# Step 2: Build
+echo ""
+echo "[2/2] Running build..."
+"$SCRIPT_DIR/build-run.sh"
+
+echo ""
+echo "=========================================="
+echo "  ✓ All checks passed - Ready to deploy"
+echo "=========================================="

package/templates/.claude/scripts/git/git-all.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# git-all.sh - 모든 변경사항 add + commit + push (단순 케이스)
+# Usage: ./git-all.sh "커밋 메시지"
+# WARNING: git add -A 사용 - 민감 파일(.env 등) 포함 주의
+
+set -euo pipefail
+
+# Git 저장소 확인
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+  echo "Error: Not a git repository"
+  exit 1
+fi
+
+if [ -z "$1" ]; then
+  echo "Usage: $0 \"commit message\""
+  exit 1
+fi
+
+COMMIT_MSG="$1"
+
+# 빈 메시지 체크
+if [ -z "$(echo "$COMMIT_MSG" | xargs)" ]; then
+  echo "Error: Commit message cannot be empty" >&2
+  exit 1
+fi
+
+# 변경사항 확인
+if [ -n "$(git status --porcelain)" ]; then
+  # 민감 파일 검증
+  SENSITIVE=$(git status --porcelain | grep -E '^\?\?.*\.(env|pem|key|secret|credentials)' || true)
+  if [ -n "$SENSITIVE" ]; then
+    echo "ERROR: Sensitive files detected:" >&2
+    echo "$SENSITIVE" >&2
+    echo "" >&2
+    echo "Please use git-commit.sh with specific files instead" >&2
+    exit 1
+  fi
+
+  echo "=== Adding all changes ==="
+  git add -A
+
+  echo "=== Committing ==="
+  git commit -m "$COMMIT_MSG"
+
+  echo "=== Pushing ==="
+  BRANCH=$(git branch --show-current)
+  if ! git rev-parse --abbrev-ref "@{upstream}" >/dev/null 2>&1; then
+    git push -u origin "$BRANCH"
+  else
+    git push
+  fi
+
+  echo "Done: All changes committed and pushed"
+else
+  echo "No changes to commit"
+  exit 0
+fi

package/templates/.claude/scripts/git/git-clean-check.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# git-clean-check.sh - Working directory clean 여부 확인
+# Usage: ./git-clean-check.sh [--quiet]
+# Exit 0: clean, Exit 1: dirty
+
+set -uo pipefail
+
+# Git 저장소 확인
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+  echo "Error: Not a git repository"
+  exit 1
+fi
+
+QUIET=false
+if [ "${1:-}" = "--quiet" ]; then
+  QUIET=true
+fi
+
+if [ -n "$(git status --porcelain)" ]; then
+  if [ "$QUIET" = false ]; then
+    echo "Working directory is DIRTY"
+    echo ""
+    git status --short
+  fi
+  exit 1
+else
+  if [ "$QUIET" = false ]; then
+    echo "Working directory is CLEAN"
+  fi
+  exit 0
+fi

package/templates/.claude/scripts/git/git-commit.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+# git-commit.sh - 커밋 실행
+# Usage: ./git-commit.sh "커밋 메시지" [files...]
+# files 미지정 시 staged files만 커밋
+
+set -euo pipefail
+
+# Git 저장소 확인
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+  echo "Error: Not a git repository"
+  exit 1
+fi
+
+if [ -z "$1" ]; then
+  echo "Usage: $0 \"commit message\" [files...]"
+  echo "  files: 커밋할 파일들 (미지정 시 staged files만)"
+  exit 1
+fi
+
+COMMIT_MSG="$1"
+
+# 빈 메시지 체크
+if [ -z "$(echo "$COMMIT_MSG" | xargs)" ]; then
+  echo "Error: Commit message cannot be empty" >&2
+  exit 1
+fi
+
+shift
+FILES_PROVIDED=$#
+
+# 파일 지정된 경우 add
+if [ $FILES_PROVIDED -gt 0 ]; then
+  git add "$@"
+fi
+
+# staged 파일 확인
+if git diff --cached --quiet; then
+  if [ $FILES_PROVIDED -eq 0 ]; then
+    echo "Error: No staged changes to commit"
+    echo "Tip: Stage files with 'git add' or pass files as arguments"
+  else
+    echo "Error: No changes in specified files"
+    echo "Tip: Check if files exist and have modifications"
+  fi
+  exit 1
+fi
+
+# 커밋
+git commit -m "$COMMIT_MSG"
+
+echo "Committed successfully"

package/templates/.claude/scripts/git/git-info.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# git-info.sh - Git 상태 및 diff 요약 출력
+# 에이전트가 분석할 정보를 빠르게 수집
+
+set -euo pipefail
+
+# Git 저장소 확인
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+  echo "Error: Not a git repository"
+  exit 1
+fi
+
+echo "=== Git Status ==="
+if [ -n "$(git status --porcelain)" ]; then
+  git status --short
+else
+  echo "(clean)"
+fi
+
+echo ""
+echo "=== Changed Files ==="
+git diff --stat
+
+echo ""
+echo "=== Staged Files ==="
+git diff --cached --stat
+
+echo ""
+echo "=== Recent Commits (5) ==="
+git log --oneline -5
+
+echo ""
+echo "=== Current Branch ==="
+git branch --show-current

package/templates/.claude/scripts/git/git-push.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# git-push.sh - 안전한 푸시 (상태 확인 후)
+# Usage: ./git-push.sh [--force]
+
+set -euo pipefail
+
+# Git 저장소 확인
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+  echo "Error: Not a git repository"
+  exit 1
+fi
+
+# 현재 브랜치
+BRANCH=$(git branch --show-current)
+
+if [ -z "$BRANCH" ]; then
+  echo "Error: Not on any branch (detached HEAD)"
+  exit 1
+fi
+
+# Force push 처리
+USE_FORCE=false
+if [ "${1:-}" = "--force" ]; then
+  # main/master 보호
+  if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
+    echo "ERROR: Cannot force push to $BRANCH"
+    echo "This operation is too dangerous on protected branches"
+    exit 1
+  fi
+  USE_FORCE=true
+  echo "Warning: Force push enabled (with lease) to $BRANCH"
+fi
+
+# upstream 확인 및 push
+if ! git rev-parse --abbrev-ref "@{upstream}" >/dev/null 2>&1; then
+  echo "Setting upstream for branch: $BRANCH"
+  if [ "$USE_FORCE" = true ]; then
+    git push -u origin "$BRANCH" --force-with-lease
+  else
+    git push -u origin "$BRANCH"
+  fi
+else
+  if [ "$USE_FORCE" = true ]; then
+    git push --force-with-lease
+  else
+    git push
+  fi
+fi
+
+echo "Pushed to origin/$BRANCH"

package/templates/.claude/scripts/lint/lint-check.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# lint-check.sh - tsc + eslint 병렬 실행
+# Usage: ./lint-check.sh
+# 두 검사를 병렬로 실행하고 결과를 수집
+
+set -uo pipefail
+
+# 임시 파일
+TSC_OUT=$(mktemp)
+ESLINT_OUT=$(mktemp)
+TSC_EXIT=0
+ESLINT_EXIT=0
+
+# Cleanup (ERR, INT, TERM도 처리)
+trap "rm -f $TSC_OUT $ESLINT_OUT" EXIT ERR INT TERM
+
+echo "=== Running TypeScript + ESLint in parallel ==="
+
+# 병렬 실행
+(npx tsc --noEmit > "$TSC_OUT" 2>&1) &
+TSC_PID=$!
+
+(npx eslint . > "$ESLINT_OUT" 2>&1) &
+ESLINT_PID=$!
+
+# 대기
+wait $TSC_PID || TSC_EXIT=$?
+wait $ESLINT_PID || ESLINT_EXIT=$?
+
+# 결과 출력
+echo ""
+echo "=== TypeScript Results ==="
+if [ $TSC_EXIT -eq 0 ]; then
+  echo "✓ No type errors"
+else
+  cat "$TSC_OUT"
+fi
+
+echo ""
+echo "=== ESLint Results ==="
+if [ $ESLINT_EXIT -eq 0 ]; then
+  echo "✓ No lint errors"
+else
+  cat "$ESLINT_OUT"
+fi
+
+echo ""
+echo "=== Summary ==="
+if [ $TSC_EXIT -eq 0 ] && [ $ESLINT_EXIT -eq 0 ]; then
+  echo "✓ All checks passed"
+  exit 0
+else
+  [ $TSC_EXIT -ne 0 ] && echo "✗ TypeScript: FAILED"
+  [ $ESLINT_EXIT -ne 0 ] && echo "✗ ESLint: FAILED"
+  exit 1
+fi

package/templates/.claude/scripts/lint/lint-file.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# lint-file.sh - 특정 파일/디렉토리만 검사
+# Usage: ./lint-file.sh <file|directory> [file2...]
+# Example: ./lint-file.sh src/utils/api.ts
+#          ./lint-file.sh src/components/
+
+set -uo pipefail
+
+if [ $# -eq 0 ]; then
+  echo "Usage: $0 <file|directory> [file2...]"
+  echo "Example: $0 src/utils/api.ts"
+  exit 1
+fi
+
+TSC_EXIT=0
+ESLINT_EXIT=0
+
+echo "=== Checking: $@ ==="
+
+# TypeScript 검사 (전체 프로젝트 - tsc는 개별 파일 검사 미지원)
+echo ""
+echo "=== TypeScript ==="
+echo "(Note: tsc checks entire project)"
+npx tsc --noEmit || TSC_EXIT=$?
+
+# ESLint 검사
+echo ""
+echo "=== ESLint ==="
+npx eslint "$@" || ESLINT_EXIT=$?
+
+# 결과
+echo ""
+echo "=== Summary ==="
+if [ $TSC_EXIT -eq 0 ] && [ $ESLINT_EXIT -eq 0 ]; then
+  echo "✓ All checks passed"
+  exit 0
+else
+  [ $TSC_EXIT -ne 0 ] && echo "✗ TypeScript: FAILED"
+  [ $ESLINT_EXIT -ne 0 ] && echo "✗ ESLint: FAILED"
+  exit 1
+fi

package/templates/.claude/scripts/pm/pm-detect.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# pm-detect.sh - Package manager 자동 감지
+# Usage: ./pm-detect.sh
+# Output: npm | yarn | pnpm | bun
+# Exit 1 if no lock file found
+
+set -euo pipefail
+
+# Lock 파일 기반 감지
+if [ -f "bun.lockb" ]; then
+  echo "bun"
+elif [ -f "pnpm-lock.yaml" ]; then
+  echo "pnpm"
+elif [ -f "yarn.lock" ]; then
+  echo "yarn"
+elif [ -f "package-lock.json" ]; then
+  echo "npm"
+elif [ -f "package.json" ]; then
+  # Lock 파일 없으면 기본 npm
+  echo "Warning: No lock file found, defaulting to npm" >&2
+  echo "npm"
+else
+  echo "Error: No package.json found" >&2
+  exit 1
+fi

package/templates/.claude/scripts/pm/pm-run.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# pm-run.sh - 감지된 package manager로 스크립트 실행
+# Usage: ./pm-run.sh <script> [args...]
+# Example: ./pm-run.sh build
+#          ./pm-run.sh test --watch
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+if [ $# -eq 0 ] || [ -z "${1:-}" ]; then
+  echo "Usage: $0 <script> [args...]"
+  echo "Example: $0 build"
+  exit 1
+fi
+
+SCRIPT="$1"
+shift
+
+# Package manager 감지
+PM=$("$SCRIPT_DIR/pm-detect.sh")
+
+# 실행
+case "$PM" in
+  bun)
+    bun run "$SCRIPT" "$@"
+    ;;
+  pnpm)
+    pnpm run "$SCRIPT" "$@"
+    ;;
+  yarn)
+    yarn "$SCRIPT" "$@"
+    ;;
+  npm)
+    npm run "$SCRIPT" "$@"
+    ;;
+  *)
+    echo "Error: Unknown package manager: $PM" >&2
+    exit 1
+    ;;
+esac

package/templates/.claude/scripts/version/version-bump.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# version-bump.sh - 버전 계산
+# Usage: ./version-bump.sh <current_version> <bump_type>
+# bump_type: +1 (patch), +minor, +major, or direct version (x.x.x)
+# Example: ./version-bump.sh 1.2.3 +1      → 1.2.4
+#          ./version-bump.sh 1.2.3 +minor  → 1.3.0
+#          ./version-bump.sh 1.2.3 +major  → 2.0.0
+#          ./version-bump.sh 1.2.3 2.0.0   → 2.0.0
+
+set -euo pipefail
+
+if [ $# -lt 2 ]; then
+  echo "Usage: $0 <current_version> <bump_type>"
+  echo "bump_type: +1, +minor, +major, or x.x.x"
+  exit 1
+fi
+
+CURRENT="$1"
+BUMP="$2"
+
+# 버전 형식 먼저 검증
+if ! [[ "$CURRENT" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+  echo "Error: Invalid version format: $CURRENT" >&2
+  echo "Expected: x.x.x (e.g., 1.2.3)" >&2
+  exit 1
+fi
+
+# 버전 파싱
+IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
+
+# 새 버전 계산
+case "$BUMP" in
+  +1|+patch)
+    NEW_VERSION="$MAJOR.$MINOR.$((PATCH + 1))"
+    ;;
+  +minor)
+    NEW_VERSION="$MAJOR.$((MINOR + 1)).0"
+    ;;
+  +major)
+    NEW_VERSION="$((MAJOR + 1)).0.0"
+    ;;
+  *)
+    # 직접 버전 지정 검증
+    if [[ "$BUMP" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+      NEW_VERSION="$BUMP"
+    else
+      echo "Error: Invalid bump type: $BUMP"
+      echo "Use: +1, +minor, +major, or x.x.x"
+      exit 1
+    fi
+    ;;
+esac
+
+echo "$NEW_VERSION"

package/templates/.claude/scripts/version/version-find.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# version-find.sh - 버전 파일 탐색
+# Usage: ./version-find.sh
+# package.json과 .version() 코드 파일을 병렬로 탐색
+
+set -uo pipefail
+
+echo "=== Searching version files ==="
+
+# 임시 파일
+PKG_OUT=$(mktemp)
+CODE_OUT=$(mktemp)
+
+trap "rm -f $PKG_OUT $CODE_OUT" EXIT ERR INT TERM
+
+# 병렬 탐색 (fd 우선, 없으면 find)
+if command -v fd &>/dev/null; then
+  fd -t f 'package.json' -E node_modules > "$PKG_OUT" 2>&1 &
+else
+  find . -name 'package.json' -not -path '*/node_modules/*' > "$PKG_OUT" 2>&1 &
+fi
+PID1=$!
+
+(rg "\.version\(['\"]" --type ts --type js -l 2>/dev/null || true) > "$CODE_OUT" &
+PID2=$!
+
+wait $PID1
+wait $PID2
+
+# 결과 출력
+echo ""
+echo "=== package.json files ==="
+if [ -s "$PKG_OUT" ]; then
+  cat "$PKG_OUT"
+else
+  echo "(none found)"
+fi
+
+echo ""
+echo "=== Code files with .version() ==="
+if [ -s "$CODE_OUT" ]; then
+  cat "$CODE_OUT"
+else
+  echo "(none found)"
+fi
+
+echo ""
+echo "=== All version files ==="
+cat "$PKG_OUT" "$CODE_OUT" | sort -u