@kood/claude-code 0.1.16 → 0.2.1

package/dist/index.js

@@ -159,26 +159,42 @@ var copyCommands = async (_templates, targetDir) => {
   }
   return counter;
 };
-var checkSkillsAndCommandsExist = async (_templates) => {
-  const claudeDir = path.join(getTemplatesDir(), ".claude");
-  const skillsSrc = path.join(claudeDir, "skills");
-  const commandsSrc = path.join(claudeDir, "commands");
-  const hasSkills = await fs.pathExists(skillsSrc);
-  const hasCommands = await fs.pathExists(commandsSrc);
-  return { hasSkills, hasCommands };
-};
 var checkExistingClaudeFiles = async (targetDir) => {
   const existingFiles = [];
   const skillsDir = path.join(targetDir, ".claude", "skills");
   const commandsDir = path.join(targetDir, ".claude", "commands");
+  const agentsDir = path.join(targetDir, ".claude", "agents");
   if (await fs.pathExists(skillsDir)) {
     existingFiles.push(".claude/skills/");
   }
   if (await fs.pathExists(commandsDir)) {
     existingFiles.push(".claude/commands/");
   }
+  if (await fs.pathExists(agentsDir)) {
+    existingFiles.push(".claude/agents/");
+  }
   return existingFiles;
 };
+var copyAgents = async (_templates, targetDir) => {
+  const counter = { files: 0, directories: 0 };
+  const targetAgentsDir = path.join(targetDir, ".claude", "agents");
+  const agentsSrc = path.join(getTemplatesDir(), ".claude", "agents");
+  if (await fs.pathExists(agentsSrc)) {
+    await fs.ensureDir(targetAgentsDir);
+    await copyRecursive(agentsSrc, targetAgentsDir, counter);
+  }
+  return counter;
+};
+var checkAllExtrasExist = async (_templates) => {
+  const claudeDir = path.join(getTemplatesDir(), ".claude");
+  const skillsSrc = path.join(claudeDir, "skills");
+  const commandsSrc = path.join(claudeDir, "commands");
+  const agentsSrc = path.join(claudeDir, "agents");
+  const hasSkills = await fs.pathExists(skillsSrc);
+  const hasCommands = await fs.pathExists(commandsSrc);
+  const hasAgents = await fs.pathExists(agentsSrc);
+  return { hasSkills, hasCommands, hasAgents };
+};
 
 // src/commands/init.ts
 var TEMPLATE_DESCRIPTIONS = {
@@ -270,17 +286,19 @@ var init = async (options) => {
   }
   logger.blank();
   logger.success(`Total: ${totalFiles} files, ${totalDirectories} directories`);
-  const { hasSkills, hasCommands } = await checkSkillsAndCommandsExist(templates);
+  const { hasSkills, hasCommands, hasAgents } = await checkAllExtrasExist(templates);
   let installSkills = options.skills ?? false;
   let installCommands = options.commands ?? false;
-  if (!options.skills && !options.commands && (hasSkills || hasCommands)) {
+  let installAgents = options.agents ?? false;
+  const noOptionsProvided = options.skills === void 0 && options.commands === void 0 && options.agents === void 0;
+  if (noOptionsProvided && (hasSkills || hasCommands || hasAgents)) {
     logger.blank();
     if (hasSkills) {
       const skillsResponse = await prompts({
         type: "confirm",
         name: "install",
         message: "Install skills to .claude/skills/?",
-        initial: true
+        initial: false
       });
       installSkills = skillsResponse.install ?? false;
     }
@@ -289,12 +307,21 @@ var init = async (options) => {
         type: "confirm",
         name: "install",
         message: "Install commands to .claude/commands/?",
-        initial: true
+        initial: false
       });
       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;
+    }
   }
-  if (installSkills || installCommands) {
+  if (installSkills || installCommands || installAgents) {
     const existingClaudeFiles = await checkExistingClaudeFiles(targetDir);
     if (existingClaudeFiles.length > 0 && !options.force) {
       logger.warn("The following .claude files/folders already exist:");
@@ -307,9 +334,10 @@ var init = async (options) => {
         initial: false
       });
       if (!response.overwrite) {
-        logger.info("Skipping skills/commands installation.");
+        logger.info("Skipping extras installation.");
         installSkills = false;
         installCommands = false;
+        installAgents = false;
       }
     }
     if (installSkills && hasSkills) {
@@ -336,13 +364,25 @@ var init = async (options) => {
     } else if (installCommands && !hasCommands) {
       logger.warn("No commands found in selected templates.");
     }
+    if (installAgents && hasAgents) {
+      logger.blank();
+      logger.info("Installing agents...");
+      const agentsResult = await copyAgents(templates, targetDir);
+      totalFiles += agentsResult.files;
+      totalDirectories += agentsResult.directories;
+      logger.success(
+        `Agents: ${agentsResult.files} files, ${agentsResult.directories} directories`
+      );
+    } else if (installAgents && !hasAgents) {
+      logger.warn("No agents found in selected templates.");
+    }
   }
   logger.blank();
   logger.success("Claude Code documentation installed!");
   logger.blank();
   logger.info("Installed templates:");
   templates.forEach((t) => logger.step(t));
-  if (installSkills || installCommands) {
+  if (installSkills || installCommands || installAgents) {
     logger.blank();
     logger.info("Installed extras:");
     if (installSkills) {
@@ -351,6 +391,9 @@ var init = async (options) => {
     if (installCommands) {
       logger.step("Commands \u2192 .claude/commands/");
     }
+    if (installAgents) {
+      logger.step("Agents \u2192 .claude/agents/");
+    }
   }
   logger.blank();
   logger.info("Next steps:");
@@ -361,11 +404,11 @@ var init = async (options) => {
 
 // src/index.ts
 var program = new Command();
-program.name("claude-code").description("Claude Code documentation installer for projects").version("0.1.16");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.2.1");
 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/").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/").action(async (options) => {
   banner();
   if (options.list) {
     const templates = await listAvailableTemplates();
@@ -379,7 +422,8 @@ program.option(
     force: options.force,
     cwd: options.cwd,
     skills: options.skills,
-    commands: options.commands
+    commands: options.commands,
+    agents: options.agents
   });
 });
 program.parse();

package/package.json

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

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

@@ -0,0 +1,31 @@
+---
+name: code-reviewer
+description: 코드 리뷰. git diff 분석, 버그/보안/품질 이슈 탐지. "리뷰해줘", "코드 봐줘" 요청 시 사용.
+model: inherit
+color: red
+tools: ["Read", "Grep", "Bash"]
+---
+
+You are an expert code reviewer.
+
+## Responsibilities
+
+1. 버그 탐지 - 로직 오류, null/undefined, 레이스 컨디션
+2. 보안 검토 - 인젝션, XSS, 민감 데이터 노출
+3. 품질 확인 - 중복, 에러 핸들링, CLAUDE.md 규칙 준수
+
+## Process
+
+1. `git diff` 또는 지정 파일 분석
+2. 이슈 심각도 분류 (Critical/Important)
+3. 구체적 수정안 제시
+
+## Confidence
+
+80점 이상만 보고:
+- 75+ : 확실한 이슈
+- 100 : 반드시 수정
+
+## Output
+
+Critical → Important 순으로 `[파일:라인]` + 이슈 + 수정안 제시.

package/templates/.claude/agents/debug-detective.md

@@ -0,0 +1,37 @@
+---
+name: debug-detective
+description: 디버깅 전문가. 버그 원인 분석 및 수정안 제시. "에러", "버그", "안돼" 요청 시 사용.
+model: inherit
+color: yellow
+tools: ["Read", "Grep", "Glob", "Bash"]
+---
+
+You are a debugging specialist.
+
+## Responsibilities
+
+1. 에러 분석 - 스택 트레이스, 로그, 재현 조건
+2. 원인 추적 - 코드 흐름 따라 근본 원인 탐지
+3. 수정안 제시 - 최소 변경으로 해결
+
+## Process
+
+1. 증상 파악 (에러 메시지, 재현 단계)
+2. 가설 수립 (가능한 원인 목록)
+3. 코드 분석으로 가설 검증
+4. 근본 원인 수정
+
+## Common Patterns
+
+| 패턴 | 증상 | 확인 |
+|------|------|------|
+| Null Reference | TypeError | 옵셔널 체이닝 |
+| Race Condition | 간헐적 실패 | async/await |
+| Off-by-One | 잘못된 인덱스 | 반복문 경계 |
+| State Mutation | 예상외 변경 | 불변성 |
+
+## Rules
+
+- 추측 금지, 코드 근거 필수
+- 최소 변경 원칙
+- Before/After 코드 제시

package/templates/.claude/agents/refactor-advisor.md

@@ -0,0 +1,44 @@
+---
+name: refactor-advisor
+description: 리팩토링 조언. 코드 개선점 분석 및 계획 수립. "리팩토링", "정리", "개선" 요청 시 사용.
+model: inherit
+color: cyan
+tools: ["Read", "Grep", "Glob"]
+---
+
+You are a refactoring specialist.
+
+## Responsibilities
+
+1. 코드 스멜 탐지 - 중복, 긴 함수, 복잡한 조건문
+2. 구조 개선 - 모듈화, 관심사 분리
+3. 안전한 계획 - 단계별 실행, 테스트 보장
+
+## Process
+
+1. 현재 코드 구조 파악
+2. 문제점/개선점 식별
+3. 우선순위 결정
+4. 단계별 계획 수립
+
+## Code Smells
+
+| 카테고리 | 예시 |
+|----------|------|
+| Bloaters | 긴 메서드, 큰 클래스 |
+| Couplers | 과도한 의존성 |
+| Dispensables | 중복, 죽은 코드 |
+
+## Techniques
+
+| 기법 | 상황 |
+|------|------|
+| Extract Function | 긴 함수, 중복 |
+| Extract Component | 복잡한 UI |
+| Replace Conditional | 복잡한 if/switch |
+
+## Rules
+
+- 한 번에 하나의 리팩토링
+- 각 단계 후 테스트
+- 기능 변경 없이 구조만 개선

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

@@ -0,0 +1,41 @@
+---
+name: test-writer
+description: 테스트 작성. 함수/컴포넌트 테스트 생성. "테스트 추가", "테스트 작성" 요청 시 사용.
+model: inherit
+color: green
+tools: ["Read", "Write", "Grep", "Glob"]
+---
+
+You are a testing specialist.
+
+## Responsibilities
+
+1. 유닛 테스트 - 함수, 클래스 단위
+2. 통합 테스트 - API, 서비스 상호작용
+3. 엣지 케이스 - 경계값, 에러, 빈 입력
+
+## Process
+
+1. 대상 코드 분석 (입력/출력, 의존성)
+2. 테스트 케이스 도출 (정상, 엣지, 에러)
+3. 프로젝트 테스트 패턴 확인
+4. 테스트 코드 작성
+
+## Coverage Priority
+
+| 우선순위 | 케이스 |
+|----------|--------|
+| 필수 | happy path |
+| 필수 | 에러 핸들링 |
+| 권장 | 경계값 |
+| 권장 | null/undefined |
+
+## Structure
+
+```typescript
+describe('[대상]', () => {
+  it('should [동작] when [조건]', () => {
+    // Arrange → Act → Assert
+  });
+});
+```

package/templates/.claude/commands/execute.md

@@ -0,0 +1,281 @@
+---
+description: 계획 실행 또는 간단한 작업 수행. ultrathink + sequential thinking 2-5 + TodoWrite 필수.
+allowed-tools: Read, Edit, Write, Glob, Grep, Bash, Task, TodoWrite, mcp__sequential-thinking__sequentialthinking
+argument-hint: <실행할 작업 또는 계획 파일명>
+---
+
+# Execute Command
+
+계획 문서를 기반으로 실행하거나, 간단한 작업을 바로 수행하는 커맨드.
+
+## CRITICAL: 필수 요구사항
+
+| 요구사항 | 설명 |
+|----------|------|
+| **ARGUMENT 필수** | 작업 내용 없이 실행 시 되물음 |
+| **Ultrathink** | 깊은 사고로 작업 분석 |
+| **Sequential Thinking 2-5** | 복잡도에 따라 조정 |
+| **TodoWrite** | 진행 상황 추적 필수 |
+
+## ARGUMENT 확인
+
+```
+$ARGUMENTS 없음 → 즉시 질문:
+"무엇을 실행할까요?
+- 계획 파일명 (예: session-auth)
+- 또는 구체적인 작업 설명"
+
+$ARGUMENTS 있음 → 실행 모드 판별
+```
+
+**실행 대상**: $ARGUMENTS
+
+## 실행 모드 판별
+
+```
+ARGUMENT 분석:
+├─ .claude/plans/*.md 존재? → 계획 기반 실행
+├─ 구체적 작업 설명? → 직접 실행
+└─ 모호함? → 되물음
+```
+
+**모드 판별 예시:**
+
+| ARGUMENT | 모드 |
+|----------|------|
+| `session-auth` | 계획 기반 (.claude/plans/session-auth.md) |
+| `버튼 색상을 파란색으로 변경` | 직접 실행 |
+| `인증 개선` | 되물음 (계획? 직접?) |
+
+## 계획 기반 실행
+
+### 실행 흐름
+
+```
+1. .claude/plans/$ARGUMENTS.md 읽기
+2. Sequential Thinking으로 단계 파악
+3. TodoWrite로 체크리스트 생성
+4. 단계별 실행:
+   a. 현재 단계 in_progress 표시
+   b. 코드 수정
+   c. 테스트 실행 (있다면)
+   d. 완료 표시
+5. 전체 완료 후 git commit
+```
+
+### 계획 문서 읽기
+
+```
+파일 위치: .claude/plans/[기능명].md
+
+읽을 내용:
+- 선택된 접근 방식
+- 구현 단계 및 체크리스트
+- 변경 파일 목록
+- 고려사항/리스크
+```
+
+### TodoWrite 연동
+
+```
+계획의 체크리스트 → TodoWrite로 변환:
+
+계획 문서:
+### 1단계: 컴포넌트 생성
+- [ ] Button 컴포넌트 생성
+- [ ] 스타일 적용
+
+→ TodoWrite:
+- "Button 컴포넌트 생성" (pending)
+- "스타일 적용" (pending)
+```
+
+## 직접 실행
+
+### 실행 흐름
+
+```
+1. ARGUMENT 확인 (작업 설명)
+2. Sequential Thinking으로 분석 (2-5단계)
+3. 필요시 Task로 코드 탐색
+4. TodoWrite로 작업 목록 생성
+5. 코드 수정
+6. 테스트 실행 (있다면)
+7. git commit
+```
+
+### 복잡도 판단
+
+| 복잡도 | 사고 횟수 | 예시 | 권장 |
+|--------|----------|------|------|
+| 간단 | 2 | 오타 수정, 색상 변경 | 직접 실행 |
+| 보통 | 3-4 | 함수 추가, 컴포넌트 수정 | 직접 실행 |
+| 복잡 | 5 | 다중 파일 변경 | 직접 실행 |
+| 매우 복잡 | - | 아키텍처 변경 | /plan 먼저 |
+
+**복잡도가 높으면:**
+
+```
+"이 작업은 복잡해 보입니다.
+/plan 커맨드로 먼저 계획을 세우시겠습니까? (Y/N)"
+
+Y → /plan 안내
+N → Sequential Thinking 5단계로 진행
+```
+
+## Sequential Thinking 가이드
+
+**간단 (2단계):**
+
+```
+thought 1: 작업 내용 파악 및 대상 파일 확인
+thought 2: 수정 방안 및 영향 확인
+```
+
+**보통 (3-4단계):**
+
+```
+thought 1: 작업 분석 및 범위 파악
+thought 2: 관련 코드 구조 이해
+thought 3: 수정 계획 수립
+thought 4: 테스트 방안 (필요시)
+```
+
+**복잡 (5단계):**
+
+```
+thought 1: 작업 분석 및 복잡도 판단
+thought 2: 코드베이스 탐색 전략
+thought 3: 의존성 및 영향 범위 파악
+thought 4: 단계별 수정 계획
+thought 5: 검증 및 롤백 계획
+```
+
+## Task Subagent 활용
+
+| subagent_type | 용도 |
+|---------------|------|
+| `Explore` | 관련 파일 탐색, 패턴 파악 |
+| `general-purpose` | 복잡한 로직 분석 |
+
+**Task 호출 시점:**
+
+```
+- 수정 대상 파일 불명확
+- 영향 범위 파악 필요
+- 기존 패턴 확인 필요
+```
+
+## 진행 상황 추적
+
+**TodoWrite 필수 사용:**
+
+```
+작업 시작 시:
+1. 전체 작업 목록 TodoWrite로 생성
+2. 현재 작업 in_progress
+3. 완료 시 즉시 completed 표시
+4. 다음 작업으로 이동
+```
+
+**예시:**
+
+```
+TodoWrite:
+- [completed] 파일 구조 분석
+- [in_progress] Button 컴포넌트 수정
+- [pending] 테스트 실행
+- [pending] git commit
+```
+
+## Git 커밋 규칙
+
+**수정 완료 후 커밋:**
+
+```bash
+# 수정한 파일만 add
+git add <수정된 파일>
+
+# 커밋 (한 줄, prefix 필수, 마침표 없음)
+git commit -m "<prefix>: <설명>"
+```
+
+**Prefix:**
+
+| Prefix | 용도 |
+|--------|------|
+| feat | 새 기능 |
+| fix | 버그 수정 |
+| refactor | 리팩토링 |
+| style | UI/스타일 변경 |
+| perf | 성능 개선 |
+| test | 테스트 추가 |
+| docs | 문서 수정 |
+| chore | 설정/빌드 |
+
+## 예시 워크플로우
+
+### 계획 기반 실행
+
+```
+1. 사용자: /execute session-auth
+
+2. .claude/plans/session-auth.md 읽기
+
+3. TodoWrite 생성:
+   - 세션 스토어 설정 (pending)
+   - 미들웨어 구현 (pending)
+   - API 엔드포인트 수정 (pending)
+   - 테스트 작성 (pending)
+
+4. 단계별 실행 및 완료 표시
+
+5. git commit -m "feat: 세션 기반 인증 구현"
+```
+
+### 직접 실행
+
+```
+1. 사용자: /execute 로그인 버튼 색상을 파란색으로 변경
+
+2. Sequential Thinking (2단계):
+   thought 1: "로그인 버튼 → LoginButton 컴포넌트 찾기"
+   thought 2: "색상 변경 위치 확인, CSS/Tailwind 스타일"
+
+3. TodoWrite:
+   - LoginButton 컴포넌트 수정 (in_progress)
+   - 변경 확인 (pending)
+
+4. Edit으로 수정
+
+5. git commit -m "style: 로그인 버튼 색상 파란색으로 변경"
+```
+
+## 테스트 실행
+
+**코드 수정 후 테스트:**
+
+```
+테스트 파일 존재 시:
+1. 관련 테스트 실행
+2. 실패 시 수정
+3. 전체 테스트 통과 확인
+
+테스트 파일 없을 시:
+- 수동 확인 안내
+- 또는 테스트 작성 제안
+```
+
+## CRITICAL: 절대 금지
+
+| 금지 항목 |
+|----------|
+| ARGUMENT 없이 실행 시작 |
+| TodoWrite 없이 작업 진행 |
+| Sequential Thinking 없이 수정 |
+| 테스트 실패 상태로 커밋 |
+| "Generated with Claude Code" 포함 |
+| "Co-Authored-By:" 헤더 |
+| 여러 줄 커밋 메시지 |
+| 커밋 메시지에 마침표(.) |
+| 매우 복잡한 작업을 /plan 없이 진행 |