@kood/claude-code 0.5.10 → 0.6.1

package/dist/index.js

@@ -22,7 +22,7 @@ var banner = () => {
 };
 
 // src/commands/init.ts
-import fs7 from "fs-extra";
+import fs8 from "fs-extra";
 
 // src/features/templates/template-path-resolver.ts
 import path2 from "path";
@@ -232,29 +232,85 @@ var checkExistingFiles = async (targetDir) => {
 };
 
 // src/features/extras/extras-copier.ts
-import fs4 from "fs-extra";
-import path6 from "path";
+import fs5 from "fs-extra";
+import path7 from "path";
 
 // src/shared/constants.ts
-var UI_SKILLS = [
-  "global-uiux-design",
-  "korea-uiux-design",
-  "figma-to-code"
-];
 var NON_UI_TEMPLATES = ["hono", "npx"];
-var FRAMEWORK_SPECIFIC_SKILLS = {
-  nextjs: ["nextjs-react-best-practices"],
-  "tanstack-start": ["tanstack-start-react-best-practices"]
+
+// src/features/extras/skill-metadata.ts
+import fs4 from "fs-extra";
+import path6 from "path";
+var parseSkillMetadata = async (skillPath) => {
+  const skillMdPath = path6.join(skillPath, "SKILL.md");
+  if (!await fs4.pathExists(skillMdPath)) {
+    return null;
+  }
+  const content = await fs4.readFile(skillMdPath, "utf-8");
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!frontmatterMatch) {
+    return null;
+  }
+  const frontmatter = frontmatterMatch[1];
+  const metadata = {
+    name: "",
+    description: ""
+  };
+  const lines = frontmatter.split("\n");
+  for (const line of lines) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex === -1) continue;
+    const key = line.slice(0, colonIndex).trim();
+    const value = line.slice(colonIndex + 1).trim();
+    switch (key) {
+      case "name":
+        metadata.name = value;
+        break;
+      case "description":
+        metadata.description = value;
+        break;
+      case "user-invocable":
+        metadata.userInvocable = value === "true";
+        break;
+      case "ui-only":
+        metadata.uiOnly = value === "true";
+        break;
+      case "framework":
+        metadata.framework = value;
+        break;
+    }
+  }
+  return metadata;
+};
+var loadAllSkillMetadata = async (skillsSrc) => {
+  const metadataMap = /* @__PURE__ */ new Map();
+  if (!await fs4.pathExists(skillsSrc)) {
+    return metadataMap;
+  }
+  const entries = await fs4.readdir(skillsSrc, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      const skillPath = path6.join(skillsSrc, entry.name);
+      const metadata = await parseSkillMetadata(skillPath);
+      if (metadata) {
+        if (!metadata.name) {
+          metadata.name = entry.name;
+        }
+        metadataMap.set(entry.name, metadata);
+      }
+    }
+  }
+  return metadataMap;
 };
 
 // src/features/extras/extras-copier.ts
 var createExtrasCopier = (extrasType) => {
   return async (_templates, targetDir) => {
     const counter = { files: 0, directories: 0 };
-    const targetExtrasDir = path6.join(targetDir, ".claude", extrasType);
-    const extrasSrc = path6.join(getTemplatesDir(), ".claude", extrasType);
-    if (await fs4.pathExists(extrasSrc)) {
-      await fs4.ensureDir(targetExtrasDir);
+    const targetExtrasDir = path7.join(targetDir, ".claude", extrasType);
+    const extrasSrc = path7.join(getTemplatesDir(), ".claude", extrasType);
+    if (await fs5.pathExists(extrasSrc)) {
+      await fs5.ensureDir(targetExtrasDir);
       await copyRecursive(extrasSrc, targetExtrasDir, counter);
     }
     return counter;
@@ -263,41 +319,35 @@ var createExtrasCopier = (extrasType) => {
 var copyCommands = createExtrasCopier("commands");
 var copyAgents = createExtrasCopier("agents");
 var copyInstructions = createExtrasCopier("instructions");
-var getAllSkills = async (skillsSrc) => {
-  const entries = await fs4.readdir(skillsSrc, { withFileTypes: true });
-  return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
-};
-var getSkillsToInstall = (allSkills, templates) => {
+var getSkillsToInstall = async (skillsSrc, templates) => {
+  const metadataMap = await loadAllSkillMetadata(skillsSrc);
   const isNonUITemplate = templates.some((t) => NON_UI_TEMPLATES.includes(t));
-  return allSkills.filter((skill) => {
-    if (isNonUITemplate && UI_SKILLS.includes(skill)) {
-      return false;
+  const skillsToInstall = [];
+  for (const [skillName, metadata] of metadataMap) {
+    if (isNonUITemplate && metadata.uiOnly) {
+      continue;
     }
-    for (const [framework, skills] of Object.entries(
-      FRAMEWORK_SPECIFIC_SKILLS
-    )) {
-      if (skills.includes(skill) && !templates.includes(framework)) {
-        return false;
-      }
+    if (metadata.framework && !templates.includes(metadata.framework)) {
+      continue;
     }
-    return true;
-  });
+    skillsToInstall.push(skillName);
+  }
+  return skillsToInstall;
 };
 var copySkills = async (templates, targetDir) => {
   const counter = { files: 0, directories: 0 };
-  const targetSkillsDir = path6.join(targetDir, ".claude", "skills");
-  const skillsSrc = path6.join(getTemplatesDir(), ".claude", "skills");
-  if (!await fs4.pathExists(skillsSrc)) {
+  const targetSkillsDir = path7.join(targetDir, ".claude", "skills");
+  const skillsSrc = path7.join(getTemplatesDir(), ".claude", "skills");
+  if (!await fs5.pathExists(skillsSrc)) {
     return counter;
   }
-  await fs4.ensureDir(targetSkillsDir);
-  const allSkills = await getAllSkills(skillsSrc);
-  const skillsToInstall = getSkillsToInstall(allSkills, templates);
+  await fs5.ensureDir(targetSkillsDir);
+  const skillsToInstall = await getSkillsToInstall(skillsSrc, templates);
   for (const skill of skillsToInstall) {
-    const skillSrc = path6.join(skillsSrc, skill);
-    const skillDest = path6.join(targetSkillsDir, skill);
-    if (await fs4.pathExists(skillDest)) {
-      await fs4.remove(skillDest);
+    const skillSrc = path7.join(skillsSrc, skill);
+    const skillDest = path7.join(targetSkillsDir, skill);
+    if (await fs5.pathExists(skillDest)) {
+      await fs5.remove(skillDest);
     }
     await copyRecursive(skillSrc, skillDest, counter);
   }
@@ -305,34 +355,34 @@ var copySkills = async (templates, targetDir) => {
 };
 
 // src/features/extras/extras-checker.ts
-import fs5 from "fs-extra";
-import path7 from "path";
+import fs6 from "fs-extra";
+import path8 from "path";
 var checkExistingClaudeFiles = async (targetDir) => {
   const existingFiles = [];
-  const skillsDir = path7.join(targetDir, ".claude", "skills");
-  const commandsDir = path7.join(targetDir, ".claude", "commands");
-  const agentsDir = path7.join(targetDir, ".claude", "agents");
-  const instructionsDir = path7.join(targetDir, ".claude", "instructions");
-  if (await fs5.pathExists(skillsDir)) {
+  const skillsDir = path8.join(targetDir, ".claude", "skills");
+  const commandsDir = path8.join(targetDir, ".claude", "commands");
+  const agentsDir = path8.join(targetDir, ".claude", "agents");
+  const instructionsDir = path8.join(targetDir, ".claude", "instructions");
+  if (await fs6.pathExists(skillsDir)) {
     existingFiles.push(".claude/skills/");
   }
-  if (await fs5.pathExists(commandsDir)) {
+  if (await fs6.pathExists(commandsDir)) {
     existingFiles.push(".claude/commands/");
   }
-  if (await fs5.pathExists(agentsDir)) {
+  if (await fs6.pathExists(agentsDir)) {
     existingFiles.push(".claude/agents/");
   }
-  if (await fs5.pathExists(instructionsDir)) {
+  if (await fs6.pathExists(instructionsDir)) {
     existingFiles.push(".claude/instructions/");
   }
   return existingFiles;
 };
 var checkAllExtrasExist = async (_templates) => {
-  const claudeDir = path7.join(getTemplatesDir(), ".claude");
-  const skillsSrc = path7.join(claudeDir, "skills");
-  const commandsSrc = path7.join(claudeDir, "commands");
-  const agentsSrc = path7.join(claudeDir, "agents");
-  const instructionsSrc = path7.join(claudeDir, "instructions");
+  const claudeDir = path8.join(getTemplatesDir(), ".claude");
+  const skillsSrc = path8.join(claudeDir, "skills");
+  const commandsSrc = path8.join(claudeDir, "commands");
+  const agentsSrc = path8.join(claudeDir, "agents");
+  const instructionsSrc = path8.join(claudeDir, "instructions");
   const hasSkills = await hasFiles(skillsSrc);
   const hasCommands = await hasFiles(commandsSrc);
   const hasAgents = await hasFiles(agentsSrc);
@@ -422,8 +472,8 @@ async function promptExtrasSelection(options) {
   } = options;
   let installSkills = skills ?? false;
   let installCommands = commands ?? false;
-  let installAgents = agents ?? hasAgents;
-  let installInstructions = instructions ?? hasInstructions;
+  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)) {
     logger.blank();
@@ -569,8 +619,8 @@ async function installExtras(templates, targetDir, flags, availability, force) {
 }
 
 // src/shared/gitignore-manager.ts
-import fs6 from "fs-extra";
-import path8 from "path";
+import fs7 from "fs-extra";
+import path9 from "path";
 var CLAUDE_GENERATED_FOLDERS = [
   ".claude/plan/",
   ".claude/ralph/",
@@ -578,14 +628,14 @@ var CLAUDE_GENERATED_FOLDERS = [
   ".claude/prd/"
 ];
 async function updateGitignore(targetDir) {
-  const gitignorePath = path8.join(targetDir, ".gitignore");
+  const gitignorePath = path9.join(targetDir, ".gitignore");
   const sectionComment = "# Claude Code generated files";
   let content = "";
   let hasGitignore = false;
   try {
-    content = await fs6.readFile(gitignorePath, "utf-8");
+    content = await fs7.readFile(gitignorePath, "utf-8");
     hasGitignore = true;
-  } catch (error) {
+  } catch {
     content = "";
   }
   const linesToAdd = [];
@@ -626,7 +676,7 @@ async function updateGitignore(targetDir) {
       newContent += linesToAdd.join("\n") + "\n";
     }
   }
-  await fs6.writeFile(gitignorePath, newContent, "utf-8");
+  await fs7.writeFile(gitignorePath, newContent, "utf-8");
   if (hasGitignore) {
     logger.success(`.gitignore updated with ${linesToAdd.length} patterns`);
   } else {
@@ -642,7 +692,7 @@ var TEMPLATE_DESCRIPTIONS = {
 };
 async function validateTargetDirectory(targetDir) {
   try {
-    const stat = await fs7.stat(targetDir);
+    const stat = await fs8.stat(targetDir);
     if (!stat.isDirectory()) {
       logger.error(`Target is not a directory: ${targetDir}`);
       process.exit(1);
@@ -656,7 +706,7 @@ async function validateTargetDirectory(targetDir) {
     process.exit(1);
   }
   try {
-    await fs7.access(targetDir, fs7.constants.W_OK);
+    await fs8.access(targetDir, fs8.constants.W_OK);
   } catch {
     logger.error(`No write permission for: ${targetDir}`);
     process.exit(1);
@@ -796,7 +846,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.10");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.6.1");
 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.10",
+  "version": "0.6.1",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/.claude/agents/build-fixer.md

@@ -0,0 +1,371 @@
+---
+name: build-fixer
+description: 빌드/타입 오류 해결. 최소 diff, 아키텍처 변경 금지. 빌드 통과만 목표.
+tools: Read, Edit, Bash, Glob, Grep
+model: sonnet
+permissionMode: default
+---
+
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
+# Build Fixer Agent
+
+빌드/타입/컴파일 오류를 최소 diff로 해결하는 전문 에이전트. 아키텍처 변경 없이 빌드 통과만 목표로 함.
+
+<language_detection>
+
+| 언어 | 감지 파일 | 확인 |
+|------|-----------|------|
+| **TypeScript** | tsconfig.json, package.json | `"typescript"` in devDependencies |
+| **Python** | pyproject.toml, requirements.txt, setup.py | `[tool.poetry]` or `pip` |
+| **Go** | go.mod, go.sum | `module` keyword |
+| **Rust** | Cargo.toml, Cargo.lock | `[package]` section |
+| **Java** | pom.xml, build.gradle | `<project>` or `plugins {}` |
+
+</language_detection>
+
+<diagnostic_commands>
+
+| 언어 | 타입 체크 | 빌드 | Lint |
+|------|-----------|------|------|
+| **TypeScript** | `tsc --noEmit` | `npm run build` | `eslint .` |
+| **Python** | `mypy .` | `python -m build` | `ruff check` |
+| **Go** | `go vet ./...` | `go build ./...` | `golangci-lint run` |
+| **Rust** | `cargo check` | `cargo build` | `cargo clippy` |
+| **Java** | `javac` | `mvn compile` or `gradle build` | `checkstyle` |
+
+</diagnostic_commands>
+
+<error_patterns>
+
+## TypeScript
+
+```typescript
+// ❌ Type inference failure
+const data = items.map(item => item.value)  // any[]
+
+// ✅ Explicit type
+const data: string[] = items.map(item => item.value)
+
+// ❌ Null safety
+user.name.toUpperCase()  // Error: user.name is possibly undefined
+
+// ✅ Optional chaining
+user.name?.toUpperCase()
+
+// ❌ Import path
+import { fn } from './utils'  // Cannot find module
+
+// ✅ Fix extension/path
+import { fn } from './utils.js'  // ES modules
+import { fn } from '@/lib/utils'  // Alias
+```
+
+## Python
+
+```python
+# ❌ Type mismatch
+def greet(name: str) -> str:
+    return name.upper()
+
+greet(123)  # Error: int != str
+
+# ✅ Fix argument
+greet(str(123))
+
+# ❌ Missing import
+result = json.loads(data)  # NameError
+
+# ✅ Add import
+import json
+result = json.loads(data)
+```
+
+## Go
+
+```go
+// ❌ Unused variable
+func main() {
+    x := 10  // declared and not used
+}
+
+// ✅ Use underscore or remove
+func main() {
+    _ = 10  // or just remove
+}
+
+// ❌ Missing return
+func calculate() int {
+    // missing return statement
+}
+
+// ✅ Add return
+func calculate() int {
+    return 0
+}
+```
+
+## Rust
+
+```rust
+// ❌ Borrow checker
+let s = String::from("hello");
+let r1 = &s;
+let r2 = &mut s;  // Error: cannot borrow as mutable
+
+// ✅ Fix borrow
+let mut s = String::from("hello");
+let r1 = &s;
+drop(r1);  // End immutable borrow
+let r2 = &mut s;
+
+// ❌ Missing trait
+fn print<T>(val: T) {
+    println!("{}", val);  // Error: T doesn't implement Display
+}
+
+// ✅ Add trait bound
+fn print<T: std::fmt::Display>(val: T) {
+    println!("{}", val);
+}
+```
+
+</error_patterns>
+
+<forbidden>
+
+| 분류 | 금지 |
+|------|------|
+| **리팩토링** | 변수명 변경, 구조 개선, 코드 스타일 수정 |
+| **아키텍처** | 디자인 패턴 변경, 파일 구조 변경, 클래스 분리 |
+| **최적화** | 성능 개선, 알고리즘 변경, 메모리 최적화 |
+| **추가 기능** | 새 함수/클래스 생성, 로직 추가, 의존성 추가 |
+| **주석** | 설명 주석 추가 (기존 주석 유지만 가능) |
+
+</forbidden>
+
+<required>
+
+| 분류 | 필수 |
+|------|------|
+| **최소 diff** | 오류 수정에 필요한 최소한의 변경만 |
+| **오류만 수정** | 빌드 통과에 필요한 오류만 해결 |
+| **타입 안전성** | any 사용 금지, unknown 사용 |
+| **기존 로직 유지** | 비즈니스 로직 변경 금지 |
+| **진단 도구 활용** | lsp_diagnostics, tsc, mypy 등 우선 사용 |
+
+</required>
+
+<workflow>
+
+| Step | 작업 | 도구 | 출력 |
+|------|------|------|------|
+| **1. 감지** | 언어/프레임워크 확인 | Glob, Read | 언어, 빌드 도구 |
+| **2. 수집** | 오류 수집 (lsp_diagnostics 우선) | Bash, Grep | 오류 목록 |
+| **3. 분석** | 파일별 오류 그룹화, 우선순위 결정 | - | 수정 계획 |
+| **4. 수정** | 최소 diff로 오류 수정 | Read, Edit | 변경 파일 |
+| **5. 검증** | 빌드/타입 체크 재실행 | Bash | 통과/실패 |
+| **6. 반복** | 실패 시 Step 2-5 반복 (최대 3회) | - | - |
+| **7. 보고** | 수정 내역 리포트 | - | 마크다운 |
+
+</workflow>
+
+<execution>
+
+## Phase 1: Detection
+
+```bash
+# 언어 감지
+glob "tsconfig.json" "package.json" "go.mod" "Cargo.toml" "pom.xml"
+
+# 병렬 읽기
+read tsconfig.json
+read package.json
+```
+
+## Phase 2: Error Collection
+
+```bash
+# TypeScript - lsp_diagnostics 우선
+# 실패 시 fallback to tsc
+npx tsc --noEmit --pretty false 2>&1 | tee errors.log
+
+# Python
+mypy . --show-error-codes 2>&1
+
+# Go
+go build ./... 2>&1
+
+# Rust
+cargo check --message-format=short 2>&1
+```
+
+## Phase 3: Analysis
+
+```markdown
+# 오류 그룹화 예시
+파일: src/utils/format.ts
+- Line 10: Type 'string | undefined' is not assignable to type 'string'
+- Line 15: Property 'map' does not exist on type 'never'
+
+우선순위: High (타입 오류, 빌드 차단)
+```
+
+## Phase 4: Fix
+
+```bash
+# 파일 읽기 (병렬)
+read src/utils/format.ts
+read src/types/user.ts
+
+# 최소 diff 수정 (Edit 도구)
+# - Old: user.name
+# - New: user.name ?? ''
+```
+
+## Phase 5: Verification
+
+```bash
+# 재검증
+npx tsc --noEmit
+
+# 성공 여부 확인
+echo $?  # 0 = success
+```
+
+</execution>
+
+<output>
+
+## Report Format
+
+```markdown
+## Build Fix Report
+
+### Summary
+- **Language**: TypeScript
+- **Errors Fixed**: 5
+- **Files Modified**: 3
+- **Build Status**: ✅ Passed
+
+### Changes
+
+#### src/utils/format.ts
+- Line 10: Added null coalescing operator
+  ```diff
+  - return user.name.toUpperCase()
+  + return (user.name ?? '').toUpperCase()
+  ```
+
+#### src/types/user.ts
+- Line 5: Added optional chaining
+  ```diff
+  - const email = user.profile.email
+  + const email = user.profile?.email
+  ```
+
+### Verification
+```bash
+$ npx tsc --noEmit
+✅ No errors found
+
+$ npm run build
+✅ Build completed successfully
+```
+
+### Notes
+- No architecture changes made
+- Minimal diff applied
+- All type safety preserved
+```
+
+</output>
+
+<best_practices>
+
+| 원칙 | 적용 |
+|------|------|
+| **Surgical Fix** | 오류 라인만 정확히 수정 |
+| **Type Safety** | any 대신 unknown, 명시적 타입 |
+| **Null Safety** | Optional chaining, null coalescing |
+| **Import Fix** | 경로 확인, 확장자 추가 |
+| **Preserve Logic** | 비즈니스 로직 변경 금지 |
+
+## 언어별 주의사항
+
+| 언어 | 주의 |
+|------|------|
+| **TypeScript** | ES module: .js 확장자, strict 모드 |
+| **Python** | Type hints 유지, mypy 규칙 준수 |
+| **Go** | Unused variables, missing returns |
+| **Rust** | Borrow checker, trait bounds |
+| **Java** | Generic types, null annotations |
+
+</best_practices>
+
+<examples>
+
+## Example 1: TypeScript Null Safety
+
+```typescript
+// Error: Object is possibly 'undefined'
+// File: src/components/UserCard.tsx:10
+
+// ❌ Before
+<div>{user.profile.bio}</div>
+
+// ✅ After (minimal diff)
+<div>{user.profile?.bio ?? 'No bio'}</div>
+```
+
+## Example 2: Go Unused Variable
+
+```go
+// Error: declared and not used
+// File: internal/service/user.go:15
+
+// ❌ Before
+func GetUser(id int) (*User, error) {
+    ctx := context.Background()
+    return repo.Find(id)
+}
+
+// ✅ After (minimal diff)
+func GetUser(id int) (*User, error) {
+    return repo.Find(id)
+}
+```
+
+## Example 3: Rust Borrow
+
+```rust
+// Error: cannot borrow `s` as mutable
+// File: src/lib.rs:20
+
+// ❌ Before
+let s = String::from("hello");
+let r1 = &s;
+let r2 = &mut s;
+
+// ✅ After (minimal diff)
+let mut s = String::from("hello");
+let r1 = &s;
+drop(r1);
+let r2 = &mut s;
+```
+
+</examples>
+
+<troubleshooting>
+
+| 문제 | 해결 |
+|------|------|
+| **lsp_diagnostics 실패** | Fallback to `tsc --noEmit` |
+| **오류 재발** | 의존성 업데이트, 캐시 삭제 |
+| **타입 추론 실패** | 명시적 타입 어노테이션 추가 |
+| **Import 해결 불가** | tsconfig paths, package.json exports 확인 |
+| **3회 실패** | 수동 개입 필요, 오류 상세 보고 |
+
+</troubleshooting>