@kood/claude-code 0.5.0 → 0.5.3

package/dist/index.js

@@ -23,6 +23,7 @@ var banner = () => {
 
 // src/commands/init.ts
 import prompts from "prompts";
+import fs2 from "fs-extra";
 
 // src/utils/copy.ts
 import fs from "fs-extra";
@@ -33,12 +34,45 @@ var __dirname2 = path.dirname(__filename2);
 var getTemplatesDir = () => {
   return path.resolve(__dirname2, "../templates");
 };
+var validateTemplateName = (template) => {
+  const sanitized = path.basename(template);
+  if (sanitized !== template || template.includes("..")) {
+    throw new Error(`Invalid template name: "${template}"`);
+  }
+};
+var validateTargetDir = (targetDir) => {
+  const resolved = path.resolve(targetDir);
+  const protectedPaths = [
+    "/",
+    "/usr",
+    "/etc",
+    "/bin",
+    "/sbin",
+    "/home",
+    "/var",
+    "/root"
+  ];
+  if (process.platform === "win32") {
+    const winProtected = [
+      "C:\\Windows",
+      "C:\\Program Files",
+      "C:\\Program Files (x86)"
+    ];
+    protectedPaths.push(...winProtected);
+  }
+  for (const protectedPath of protectedPaths) {
+    if (resolved === protectedPath || resolved.startsWith(protectedPath + path.sep)) {
+      throw new Error(`Cannot modify protected system path: ${resolved}`);
+    }
+  }
+};
 var hasFiles = async (dir) => {
   if (!await fs.pathExists(dir)) return false;
   const items = await fs.readdir(dir);
   return items.length > 0;
 };
 var getTemplatePath = (template) => {
+  validateTemplateName(template);
   return path.join(getTemplatesDir(), template);
 };
 var copyRecursive = async (src, dest, counter) => {
@@ -56,6 +90,7 @@ var copyRecursive = async (src, dest, counter) => {
   }
 };
 var copySingleTemplate = async (template, targetDir) => {
+  validateTargetDir(targetDir);
   const templatePath = getTemplatePath(template);
   if (!await fs.pathExists(templatePath)) {
     throw new Error(`Template "${template}" not found at ${templatePath}`);
@@ -77,6 +112,7 @@ var copySingleTemplate = async (template, targetDir) => {
   return counter;
 };
 var copyMultipleTemplates = async (templates, targetDir) => {
+  validateTargetDir(targetDir);
   const counter = { files: 0, directories: 0 };
   const docsDir = path.join(targetDir, "docs");
   if (await fs.pathExists(docsDir)) {
@@ -99,18 +135,49 @@ var copyMultipleTemplates = async (templates, targetDir) => {
   return counter;
 };
 var generateIndexClaudeMd = (templates) => {
-  const templateLinks = templates.map((t) => `- [${t}](docs/${t}/CLAUDE.md)`).join("\n");
+  const templateMetadata = {
+    "tanstack-start": {
+      name: "TanStack Start",
+      description: "React + TanStack Router SSR \uD480\uC2A4\uD0DD \uD504\uB85C\uC81D\uD2B8",
+      stack: "React, TanStack Router, Vite, TypeScript"
+    },
+    hono: {
+      name: "Hono",
+      description: "Edge Runtime \uBC31\uC5D4\uB4DC API \uD504\uB85C\uC81D\uD2B8",
+      stack: "Hono, TypeScript, Cloudflare Workers"
+    },
+    npx: {
+      name: "NPX CLI",
+      description: "NPX\uB85C \uC2E4\uD589 \uAC00\uB2A5\uD55C CLI \uB3C4\uAD6C \uD504\uB85C\uC81D\uD2B8",
+      stack: "Node.js, TypeScript, Commander.js"
+    }
+  };
+  const templateSections = templates.map((template) => {
+    const meta = templateMetadata[template] || {
+      name: template,
+      description: `${template} \uD504\uB85C\uC81D\uD2B8`,
+      stack: "TypeScript"
+    };
+    return `### ${meta.name}
+- **\uC6A9\uB3C4:** ${meta.description}
+- **\uC8FC\uC694 \uC2A4\uD0DD:** ${meta.stack}
+- **\uAC00\uC774\uB4DC:** [docs/${template}/CLAUDE.md](docs/${template}/CLAUDE.md)`;
+  }).join("\n\n");
   return `# CLAUDE.md
 
-> \uC774 \uD504\uB85C\uC81D\uD2B8\uB294 \uC5EC\uB7EC \uD15C\uD50C\uB9BF\uC758 Claude Code \uBB38\uC11C\uB97C \uD3EC\uD568\uD569\uB2C8\uB2E4.
+> \uC774 \uD504\uB85C\uC81D\uD2B8\uB294 \uC5EC\uB7EC \uD504\uB808\uC784\uC6CC\uD06C\uC758 Claude Code \uAC00\uC774\uB4DC\uB97C \uD3EC\uD568\uD569\uB2C8\uB2E4.
+
+## \uC0AC\uC6A9 \uBC29\uBC95
+
+\uC544\uB798 \uD15C\uD50C\uB9BF \uC911 **\uD604\uC7AC \uD504\uB85C\uC81D\uD2B8\uC5D0 \uC0AC\uC6A9 \uC911\uC778 \uD504\uB808\uC784\uC6CC\uD06C**\uB97C \uC120\uD0DD\uD558\uC5EC \uD574\uB2F9 \uAC00\uC774\uB4DC\uB97C \uB530\uB974\uC138\uC694.
 
-## \uD15C\uD50C\uB9BF \uBB38\uC11C
+## \uD15C\uD50C\uB9BF \uBAA9\uB85D
 
-${templateLinks}
+${templateSections}
 
-## \uC0AC\uC6A9\uBC95
+---
 
-\uAC01 \uD15C\uD50C\uB9BF\uC758 \`CLAUDE.md\`\uB97C \uCC38\uC870\uD558\uC5EC \uD574\uB2F9 \uAE30\uC220 \uC2A4\uD0DD\uC758 \uAC00\uC774\uB4DC\uB77C\uC778\uC744 \uD655\uC778\uD558\uC138\uC694.
+**\uD604\uC7AC \uD504\uB85C\uC81D\uD2B8\uC5D0 \uB9DE\uB294 \uAC00\uC774\uB4DC\uB97C CLAUDE.md\uC758 \`@\` \uC778\uC2A4\uD2B8\uB7ED\uC158\uC5D0 \uCD94\uAC00\uD558\uC138\uC694.**
 `;
 };
 var checkExistingFiles = async (targetDir) => {
@@ -144,15 +211,24 @@ var listAvailableTemplates = async () => {
   }
   return templates;
 };
-var TEMPLATE_SKILLS_MAP = {
+var FRAMEWORK_SPECIFIC_SKILLS_MAP = {
   nextjs: ["nextjs-react-best-practices", "korea-uiux-design", "figma-to-code"],
   "tanstack-start": [
     "tanstack-start-react-best-practices",
     "korea-uiux-design",
     "figma-to-code"
   ]
-  // hono와 npx는 스킬 없음
+  // hono와 npx는 프레임워크별 스킬 없음
 };
+var COMMON_SKILLS = [
+  "global-uiux-design",
+  "docs-creator",
+  "docs-refactor",
+  "plan",
+  "prd",
+  "ralph",
+  "execute"
+];
 var copySkills = async (templates, targetDir) => {
   const counter = { files: 0, directories: 0 };
   const targetSkillsDir = path.join(targetDir, ".claude", "skills");
@@ -162,9 +238,17 @@ var copySkills = async (templates, targetDir) => {
   }
   await fs.ensureDir(targetSkillsDir);
   const skillsToCopy = /* @__PURE__ */ new Set();
+  const skillTemplateMap = /* @__PURE__ */ new Map();
+  COMMON_SKILLS.forEach((skill) => skillsToCopy.add(skill));
   for (const template of templates) {
-    const skills = TEMPLATE_SKILLS_MAP[template] || [];
-    skills.forEach((skill) => skillsToCopy.add(skill));
+    const skills = FRAMEWORK_SPECIFIC_SKILLS_MAP[template] || [];
+    skills.forEach((skill) => {
+      skillsToCopy.add(skill);
+      if (!skillTemplateMap.has(skill)) {
+        skillTemplateMap.set(skill, /* @__PURE__ */ new Set());
+      }
+      skillTemplateMap.get(skill).add(template);
+    });
   }
   for (const skill of skillsToCopy) {
     const skillSrc = path.join(skillsSrc, skill);
@@ -176,7 +260,19 @@ var copySkills = async (templates, targetDir) => {
       await copyRecursive(skillSrc, skillDest, counter);
     }
   }
-  return counter;
+  const duplicateSkills = [];
+  for (const [skill, templateSet] of skillTemplateMap.entries()) {
+    if (templateSet.size > 1) {
+      duplicateSkills.push({
+        skill,
+        templates: Array.from(templateSet).sort()
+      });
+    }
+  }
+  return {
+    ...counter,
+    ...duplicateSkills.length > 0 && { duplicateSkills }
+  };
 };
 var copyCommands = async (_templates, targetDir) => {
   const counter = { files: 0, directories: 0 };
@@ -237,10 +333,11 @@ var checkAllExtrasExist = async (templates) => {
   const commandsSrc = path.join(claudeDir, "commands");
   const agentsSrc = path.join(claudeDir, "agents");
   const instructionsSrc = path.join(claudeDir, "instructions");
-  const hasSkills = templates.some((template) => {
-    const skills = TEMPLATE_SKILLS_MAP[template];
+  const hasFrameworkSkills = templates.some((template) => {
+    const skills = FRAMEWORK_SPECIFIC_SKILLS_MAP[template];
     return skills && skills.length > 0;
   });
+  const hasSkills = COMMON_SKILLS.length > 0 || hasFrameworkSkills;
   const hasCommands = await hasFiles(commandsSrc);
   const hasAgents = await hasFiles(agentsSrc);
   const hasInstructions = await hasFiles(instructionsSrc);
@@ -255,6 +352,26 @@ var TEMPLATE_DESCRIPTIONS = {
 };
 var init = async (options) => {
   const targetDir = options.cwd || process.cwd();
+  try {
+    const stat = await fs2.stat(targetDir);
+    if (!stat.isDirectory()) {
+      logger.error(`Target is not a directory: ${targetDir}`);
+      process.exit(1);
+    }
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      logger.error(`Target directory does not exist: ${targetDir}`);
+    } else {
+      logger.error(`Cannot access target directory: ${targetDir}`);
+    }
+    process.exit(1);
+  }
+  try {
+    await fs2.access(targetDir, fs2.constants.W_OK);
+  } catch {
+    logger.error(`No write permission for: ${targetDir}`);
+    process.exit(1);
+  }
   const availableTemplates = await listAvailableTemplates();
   if (availableTemplates.length === 0) {
     logger.error("No templates found. Package may be corrupted.");
@@ -364,22 +481,10 @@ var init = async (options) => {
       installCommands = commandsResponse.install ?? false;
     }
     if (hasAgents) {
-      const agentsResponse = await prompts({
-        type: "confirm",
-        name: "install",
-        message: "Install agents to .claude/agents/?",
-        initial: false
-      });
-      installAgents = agentsResponse.install ?? false;
+      installAgents = true;
     }
     if (hasInstructions) {
-      const instructionsResponse = await prompts({
-        type: "confirm",
-        name: "install",
-        message: "Install instructions to .claude/instructions/?",
-        initial: false
-      });
-      installInstructions = instructionsResponse.install ?? false;
+      installInstructions = true;
     }
   }
   if (installSkills || installCommands || installAgents || installInstructions) {
@@ -406,11 +511,52 @@ var init = async (options) => {
       logger.blank();
       logger.info("Installing skills...");
       const skillsResult = await copySkills(templates, targetDir);
-      totalFiles += skillsResult.files;
-      totalDirectories += skillsResult.directories;
-      logger.success(
-        `Skills: ${skillsResult.files} files, ${skillsResult.directories} directories`
-      );
+      if (skillsResult.duplicateSkills && skillsResult.duplicateSkills.length > 0) {
+        logger.blank();
+        logger.warn("The following skills are included in multiple templates:");
+        skillsResult.duplicateSkills.forEach(
+          ({ skill, templates: skillTemplates }) => {
+            logger.step(`${skill} (${skillTemplates.join(", ")})`);
+          }
+        );
+        logger.blank();
+        const response = await prompts({
+          type: "select",
+          name: "selectedTemplate",
+          message: "Which template's version should be used?",
+          choices: templates.map((t) => ({
+            title: t,
+            value: t
+          }))
+        });
+        if (response.selectedTemplate) {
+          logger.info(
+            `Reinstalling skills with ${response.selectedTemplate} template...`
+          );
+          const reinstallResult = await copySkills(
+            [response.selectedTemplate],
+            targetDir
+          );
+          totalFiles += reinstallResult.files;
+          totalDirectories += reinstallResult.directories;
+          logger.success(
+            `Skills: ${reinstallResult.files} files, ${reinstallResult.directories} directories`
+          );
+        } else {
+          logger.warn("No template selected. Using all templates.");
+          totalFiles += skillsResult.files;
+          totalDirectories += skillsResult.directories;
+          logger.success(
+            `Skills: ${skillsResult.files} files, ${skillsResult.directories} directories`
+          );
+        }
+      } else {
+        totalFiles += skillsResult.files;
+        totalDirectories += skillsResult.directories;
+        logger.success(
+          `Skills: ${skillsResult.files} files, ${skillsResult.directories} directories`
+        );
+      }
     } else if (installSkills && !hasSkills) {
       logger.warn("No skills found in selected templates.");
     }
@@ -481,7 +627,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.0");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.5.3");
 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.0",
+  "version": "0.5.3",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/.claude/agents/analyst.md

@@ -5,6 +5,12 @@ tools: Read, Grep, Glob
 model: opus
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
 # Analyst Agent (Metis)
 
 계획 수립 전 요구사항 심층 분석. "다른 사람이 놓친 것을 발견"하는 전략 컨설턴트.
@@ -29,20 +35,6 @@ model: opus
 
 ---
 
-<parallel_execution>
-
-## Agent Coordination
-
-| 항목 | 설명 |
-|------|------|
-| **병렬 실행** | 불가 (전체 맥락 통합 분석 필요) |
-| **연계 Agent** | architect (기술 분석), planner (계획 수립 전 분석), document-writer (문서화) |
-| **권장 모델** | opus (심층 요구사항 분석) |
-
-</parallel_execution>
-
----
-
 <six_gaps>
 
 ## 6가지 핵심 갭

package/templates/.claude/agents/architect.md

@@ -5,6 +5,12 @@ tools: Read, Grep, Glob
 model: opus
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
 # Architect Agent (Oracle)
 
 델파이 신탁처럼 전략적 조언을 제공하는 READ-ONLY 아키텍처 고문. 코드를 수정하지 않고 분석과 권장사항만 제공.
@@ -29,20 +35,6 @@ model: opus
 
 ---
 
-<parallel_execution>
-
-## Agent Coordination
-
-| 항목 | 설명 |
-|------|------|
-| **병렬 실행** | 부분 가능 (독립 모듈 분석), 아키텍처 전체 분석은 단일 실행 |
-| **연계 Agent** | analyst (요구사항 분석), refactor-advisor (리팩토링 실행), planner (계획 수립) |
-| **권장 모델** | opus (복잡한 아키텍처 분석) |
-
-</parallel_execution>
-
----
-
 <forbidden>
 
 ## 절대 금지

package/templates/.claude/agents/code-reviewer.md

@@ -6,6 +6,14 @@ model: sonnet
 permissionMode: default
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
+# Code Reviewer
+
 너는 시니어 코드 리뷰어다. 높은 기준을 유지하며 건설적인 피드백을 제공한다.
 
 호출 시 수행할 작업:
@@ -17,20 +25,6 @@ permissionMode: default
 
 ---
 
-<parallel_execution>
-
-## Agent Coordination
-
-| 항목 | 설명 |
-|------|------|
-| **병렬 실행** | 불가 (git diff 기반 순차 검토) |
-| **연계 Agent** | git-operator (커밋 전 리뷰), deployment-validator (배포 전 검토) |
-| **권장 모델** | sonnet (코드 품질 분석) |
-
-</parallel_execution>
-
----
-
 <review_checklist>
 
 ## 검토 체크리스트

package/templates/.claude/agents/dependency-manager.md

@@ -6,6 +6,14 @@ model: sonnet
 permissionMode: default
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
+# Dependency Manager
+
 너는 의존성 관리 및 보안 전문가다.
 
 호출 시 수행할 작업:
@@ -17,20 +25,6 @@ permissionMode: default
 
 ---
 
-<parallel_execution>
-
-## Agent Coordination
-
-| 항목 | 설명 |
-|------|------|
-| **병렬 실행** | 부분 가능 (분석 단계), 업데이트는 순차 필수 |
-| **연계 Agent** | deployment-validator (업데이트 후 검증), code-reviewer (breaking change 검토) |
-| **권장 모델** | sonnet (보안 및 breaking change 분석) |
-
-</parallel_execution>
-
----
-
 <analysis_criteria>
 
 ## 분석 기준

package/templates/.claude/agents/deployment-validator.md

@@ -6,6 +6,14 @@ model: sonnet
 permissionMode: default
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
+# Deployment Validator
+
 너는 배포 전 품질 보증 전문가다.
 
 호출 시 수행할 작업:
@@ -18,20 +26,6 @@ permissionMode: default
 
 ---
 
-<parallel_execution>
-
-## Agent Coordination
-
-| 항목 | 설명 |
-|------|------|
-| **병렬 실행** | 불가 (순차 수정 필수: typecheck → lint → build) |
-| **연계 Agent** | lint-fixer (동일 패턴), git-operator (배포 전 커밋) |
-| **권장 모델** | sonnet (오류 분석 및 수정) |
-
-</parallel_execution>
-
----
-
 <validation_checklist>
 
 ```text

package/templates/.claude/agents/designer.md

@@ -6,6 +6,14 @@ model: sonnet
 permissionMode: default
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
+# Designer
+
 너는 디자이너-개발자 하이브리드다. 시각적으로 뛰어나고 감정적으로 매력적인 인터페이스를 만든다.
 
 호출 시 수행할 작업:

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

@@ -5,6 +5,12 @@ tools: Read, Write, Edit, Glob, Grep
 model: haiku
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
 # Document Writer Agent
 
 Anthropic Context Engineering 원칙 기반 고밀도, 실행 가능, 유지보수 가능한 문서 작성.
@@ -23,20 +29,6 @@ Anthropic Context Engineering 원칙 기반 고밀도, 실행 가능, 유지보
 
 ---
 
-<parallel_execution>
-
-## Agent Coordination
-
-| 항목 | 설명 |
-|------|------|
-| **병렬 실행** | 가능 (독립 문서 작성 시), Ralph 문서는 순차 업데이트 |
-| **연계 Agent** | ko-to-en-translator (번역), analyst (요구사항 문서화), planner (계획 문서화) |
-| **권장 모델** | haiku (빠른 문서 작성) |
-
-</parallel_execution>
-
----
-
 <context_engineering>
 
 ## Anthropic Context Engineering 원칙

package/templates/.claude/agents/explore.md

@@ -6,6 +6,13 @@ model: haiku
 permissionMode: default
 ---
 
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/read-parallelization.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
+# Explore
+
 너는 코드베이스 탐색 전문가다. 파일과 코드를 빠르게 찾아내고 정확한 정보를 제공한다.
 
 호출 시 수행할 작업:
@@ -16,7 +23,7 @@ permissionMode: default
 
 ---
 
-<parallel_execution>
+<agent_coordination>
 
 ## 병렬 탐색 전략
 
@@ -108,8 +115,6 @@ Task(Explore): "데이터베이스 사용자/세션 스키마 탐색"
 </integrated_search_results>
 ```
 
-</parallel_execution>
-
 ---
 
 <core_mission>