@kood/claude-code 0.1.2 → 0.1.3

package/templates/npx/docs/library/commander/index.md

@@ -0,0 +1,164 @@
+# Commander.js 가이드
+
+> Node.js CLI 프레임워크
+
+---
+
+## 기본 설정
+
+```typescript
+import { Command } from 'commander';
+
+const program = new Command();
+
+program
+  .name('my-cli')
+  .description('CLI description')
+  .version('1.0.0');
+
+program.parse();
+```
+
+---
+
+## Options
+
+### 기본 옵션
+```typescript
+program
+  .option('-t, --template <name>', 'template name')
+  .option('-f, --force', 'force overwrite')
+  .option('-v, --verbose', 'verbose output')
+  .action((options) => {
+    console.log(options.template); // string | undefined
+    console.log(options.force);    // boolean | undefined
+  });
+```
+
+### 필수 옵션
+```typescript
+program
+  .requiredOption('-c, --config <path>', 'config file path')
+  .action((options) => {
+    // options.config는 항상 존재
+  });
+```
+
+### 기본값
+```typescript
+program
+  .option('-p, --port <number>', 'port number', '3000')
+  .option('-e, --env <name>', 'environment', 'development')
+```
+
+### 여러 값 수집
+```typescript
+program
+  .option('-i, --include <path...>', 'include paths')
+  .action((options) => {
+    console.log(options.include); // string[]
+  });
+
+// 사용: --include src lib tests
+```
+
+---
+
+## Arguments
+
+```typescript
+program
+  .argument('<source>', 'source file')
+  .argument('[destination]', 'destination file')
+  .action((source, destination, options) => {
+    console.log(source);      // 필수
+    console.log(destination); // 선택
+  });
+```
+
+---
+
+## Subcommands
+
+```typescript
+program
+  .command('init')
+  .description('Initialize project')
+  .option('-t, --template <name>', 'template')
+  .action((options) => {
+    // init 명령어 처리
+  });
+
+program
+  .command('build')
+  .description('Build project')
+  .action(() => {
+    // build 명령어 처리
+  });
+
+// 사용: my-cli init --template react
+// 사용: my-cli build
+```
+
+---
+
+## Async Action
+
+```typescript
+program
+  .action(async (options) => {
+    try {
+      await doSomething();
+    } catch (error) {
+      console.error(error);
+      process.exit(1);
+    }
+  });
+
+// await 필요
+await program.parseAsync();
+```
+
+---
+
+## Help 커스터마이징
+
+```typescript
+program
+  .addHelpText('beforeAll', 'Custom header')
+  .addHelpText('afterAll', 'Custom footer');
+```
+
+---
+
+## 전체 예시
+
+```typescript
+#!/usr/bin/env node
+import { Command } from 'commander';
+
+const program = new Command();
+
+program
+  .name('my-cli')
+  .description('My awesome CLI tool')
+  .version('1.0.0');
+
+program
+  .option('-t, --template <name>', 'template name')
+  .option('-f, --force', 'overwrite existing files')
+  .option('--cwd <path>', 'working directory', process.cwd())
+  .action(async (options) => {
+    const { template, force, cwd } = options;
+
+    try {
+      // 실행 로직
+      await init({ template, force, cwd });
+    } catch (error) {
+      console.error('Error:', error.message);
+      process.exit(1);
+    }
+  });
+
+program.parse();
+```

package/templates/npx/docs/library/fs-extra/index.md

@@ -0,0 +1,171 @@
+# fs-extra 가이드
+
+> Node.js 파일 시스템 유틸리티 (fs 확장)
+
+---
+
+## 기본 Import
+
+```typescript
+import fs from 'fs-extra';
+import path from 'path';
+```
+
+---
+
+## 파일/디렉토리 존재 확인
+
+```typescript
+// 존재 확인
+const exists = await fs.pathExists('/path/to/file');
+
+if (await fs.pathExists(targetDir)) {
+  // 이미 존재
+}
+```
+
+---
+
+## 디렉토리 생성
+
+```typescript
+// 재귀적 생성 (mkdir -p)
+await fs.ensureDir('/path/to/nested/dir');
+
+// 단일 생성
+await fs.mkdir('/path/to/dir');
+```
+
+---
+
+## 파일/디렉토리 복사
+
+```typescript
+// 파일 복사
+await fs.copy('/src/file.txt', '/dest/file.txt');
+
+// 디렉토리 복사 (재귀)
+await fs.copy('/src/dir', '/dest/dir');
+
+// 옵션
+await fs.copy(src, dest, {
+  overwrite: true,      // 덮어쓰기 (기본: true)
+  errorOnExist: false,  // 존재 시 에러 (기본: false)
+  filter: (src) => {    // 필터링
+    return !src.includes('node_modules');
+  },
+});
+```
+
+---
+
+## 파일/디렉토리 삭제
+
+```typescript
+// 삭제 (rm -rf)
+await fs.remove('/path/to/dir');
+
+// 빈 디렉토리만 삭제
+await fs.rmdir('/path/to/empty-dir');
+```
+
+---
+
+## 디렉토리 읽기
+
+```typescript
+// 파일/폴더 목록
+const items = await fs.readdir('/path/to/dir');
+// ['file1.txt', 'folder1', 'file2.txt']
+
+// stat으로 타입 확인
+for (const item of items) {
+  const itemPath = path.join(dir, item);
+  const stat = await fs.stat(itemPath);
+
+  if (stat.isDirectory()) {
+    // 디렉토리
+  } else {
+    // 파일
+  }
+}
+```
+
+---
+
+## 파일 읽기/쓰기
+
+```typescript
+// 읽기
+const content = await fs.readFile('/path/to/file', 'utf-8');
+
+// 쓰기
+await fs.writeFile('/path/to/file', content, 'utf-8');
+
+// JSON 읽기
+const data = await fs.readJson('/path/to/file.json');
+
+// JSON 쓰기
+await fs.writeJson('/path/to/file.json', data, { spaces: 2 });
+```
+
+---
+
+## 파일 정보
+
+```typescript
+const stat = await fs.stat('/path/to/file');
+
+stat.isFile();      // 파일 여부
+stat.isDirectory(); // 디렉토리 여부
+stat.size;          // 파일 크기 (bytes)
+stat.mtime;         // 수정 시간
+```
+
+---
+
+## 재귀 복사 패턴
+
+```typescript
+const copyRecursive = async (
+  src: string,
+  dest: string,
+): Promise<{ files: number; directories: number }> => {
+  const counter = { files: 0, directories: 0 };
+
+  const copy = async (s: string, d: string): Promise<void> => {
+    const stat = await fs.stat(s);
+
+    if (stat.isDirectory()) {
+      await fs.ensureDir(d);
+      counter.directories++;
+
+      const items = await fs.readdir(s);
+      for (const item of items) {
+        await copy(path.join(s, item), path.join(d, item));
+      }
+    } else {
+      await fs.copy(s, d);
+      counter.files++;
+    }
+  };
+
+  await copy(src, dest);
+  return counter;
+};
+```
+
+---
+
+## ESM에서 __dirname 사용
+
+```typescript
+import { fileURLToPath } from 'url';
+import path from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 사용
+const templatesDir = path.resolve(__dirname, '../templates');
+```

package/templates/npx/docs/library/prompts/index.md

@@ -0,0 +1,253 @@
+# prompts 가이드
+
+> Interactive CLI prompts
+
+---
+
+## 기본 Import
+
+```typescript
+import prompts from 'prompts';
+```
+
+---
+
+## Text Input
+
+```typescript
+const response = await prompts({
+  type: 'text',
+  name: 'name',
+  message: 'What is your name?',
+  initial: 'Anonymous',
+});
+
+console.log(response.name);
+```
+
+---
+
+## Confirm (Yes/No)
+
+```typescript
+const response = await prompts({
+  type: 'confirm',
+  name: 'confirmed',
+  message: 'Continue?',
+  initial: true,
+});
+
+if (response.confirmed) {
+  // Yes
+}
+```
+
+---
+
+## Select (단일 선택)
+
+```typescript
+const response = await prompts({
+  type: 'select',
+  name: 'template',
+  message: 'Select a template:',
+  choices: [
+    { title: 'React', description: 'React framework', value: 'react' },
+    { title: 'Vue', description: 'Vue framework', value: 'vue' },
+    { title: 'Angular', description: 'Angular framework', value: 'angular' },
+  ],
+  initial: 0, // 첫 번째 선택
+});
+
+console.log(response.template); // 'react' | 'vue' | 'angular'
+```
+
+---
+
+## Multiselect (다중 선택)
+
+```typescript
+const response = await prompts({
+  type: 'multiselect',
+  name: 'features',
+  message: 'Select features:',
+  choices: [
+    { title: 'TypeScript', value: 'typescript', selected: true },
+    { title: 'ESLint', value: 'eslint' },
+    { title: 'Prettier', value: 'prettier' },
+  ],
+  min: 1,  // 최소 1개 선택
+  max: 5,  // 최대 5개 선택
+  hint: '- Space to select. Return to submit',
+});
+
+console.log(response.features); // ['typescript', 'eslint']
+```
+
+---
+
+## Number Input
+
+```typescript
+const response = await prompts({
+  type: 'number',
+  name: 'port',
+  message: 'Port number?',
+  initial: 3000,
+  min: 1,
+  max: 65535,
+});
+
+console.log(response.port); // number
+```
+
+---
+
+## Password Input
+
+```typescript
+const response = await prompts({
+  type: 'password',
+  name: 'secret',
+  message: 'Enter password:',
+});
+
+console.log(response.secret);
+```
+
+---
+
+## 취소 처리
+
+```typescript
+const response = await prompts({
+  type: 'select',
+  name: 'template',
+  message: 'Select:',
+  choices: [...],
+});
+
+// Ctrl+C 또는 ESC 시 undefined
+if (!response.template) {
+  console.log('Operation cancelled.');
+  process.exit(0);
+}
+```
+
+---
+
+## 연속 질문
+
+```typescript
+const response = await prompts([
+  {
+    type: 'text',
+    name: 'name',
+    message: 'Project name?',
+  },
+  {
+    type: 'select',
+    name: 'template',
+    message: 'Template?',
+    choices: [...],
+  },
+  {
+    type: 'confirm',
+    name: 'git',
+    message: 'Initialize git?',
+  },
+]);
+
+console.log(response.name);
+console.log(response.template);
+console.log(response.git);
+```
+
+---
+
+## 조건부 질문
+
+```typescript
+const response = await prompts([
+  {
+    type: 'confirm',
+    name: 'useTypescript',
+    message: 'Use TypeScript?',
+  },
+  {
+    type: (prev) => prev ? 'confirm' : null, // 이전 답변이 true일 때만
+    name: 'strict',
+    message: 'Enable strict mode?',
+  },
+]);
+```
+
+---
+
+## Autocomplete
+
+```typescript
+const response = await prompts({
+  type: 'autocomplete',
+  name: 'package',
+  message: 'Search package:',
+  choices: [
+    { title: 'react' },
+    { title: 'react-dom' },
+    { title: 'react-router' },
+    { title: 'vue' },
+    { title: 'angular' },
+  ],
+  suggest: (input, choices) => {
+    return choices.filter((c) =>
+      c.title.toLowerCase().includes(input.toLowerCase())
+    );
+  },
+});
+```
+
+---
+
+## 전체 예시
+
+```typescript
+import prompts from 'prompts';
+
+const run = async () => {
+  // 템플릿 선택
+  const { templates } = await prompts({
+    type: 'multiselect',
+    name: 'templates',
+    message: 'Select templates (space to select):',
+    choices: [
+      { title: 'Hono', value: 'hono' },
+      { title: 'TanStack Start', value: 'tanstack-start' },
+    ],
+    min: 1,
+    hint: '- Space to select. Return to submit',
+  });
+
+  if (!templates || templates.length === 0) {
+    console.log('Cancelled.');
+    process.exit(0);
+  }
+
+  // 덮어쓰기 확인
+  const { overwrite } = await prompts({
+    type: 'confirm',
+    name: 'overwrite',
+    message: 'Files exist. Overwrite?',
+    initial: false,
+  });
+
+  if (!overwrite) {
+    console.log('Cancelled.');
+    process.exit(0);
+  }
+
+  // 실행
+  console.log('Selected:', templates);
+};
+
+run();
+```

package/templates/npx/docs/mcp/index.md

@@ -0,0 +1,60 @@
+# MCP 도구 사용 가이드
+
+## ⛔ 프로젝트 시작 전 필수 확인
+
+### 1. Serena - 프로젝트 활성화 확인
+```
+mcp__serena__get_current_config 호출하여 현재 프로젝트 확인
+→ 프로젝트 미활성화 시: mcp__serena__activate_project 실행
+```
+
+### 2. Sequential Thinking - 복잡한 문제 분석용
+```
+복잡한 로직, 아키텍처 설계, 디버깅 시 활용
+```
+
+### 3. sgrep - 코드베이스 검색용
+```
+❌ grep, rg 사용 금지
+✅ sgrep 사용 필수
+```
+
+---
+
+## 필수 MCP 도구
+
+### sgrep (코드 검색)
+```
+❌ 금지: grep, rg, find
+✅ 필수: sgrep
+```
+
+**사용 상황**:
+- 함수/클래스 정의 찾기
+- 특정 패턴 검색
+- 코드베이스 탐색
+
+### Sequential Thinking (복잡한 분석)
+**사용 상황**:
+- 복잡한 로직 분석
+- 아키텍처 설계
+- 디버깅 및 문제 해결
+- 멀티스텝 작업 계획
+
+### Context7 (라이브러리 문서)
+**사용 상황**:
+- Commander 사용법 확인
+- fs-extra API 확인
+- prompts 옵션 확인
+- 라이브러리 버전별 차이 확인
+
+---
+
+## 상황별 MCP 사용
+
+| 상황 | 사용 MCP |
+|------|----------|
+| 코드 검색 | sgrep |
+| 복잡한 분석 | Sequential Thinking |
+| 라이브러리 문서 | Context7 |
+| 프로젝트 컨텍스트 | Serena |