@kood/claude-code 0.1.12 → 0.1.14

package/dist/index.js

@@ -128,6 +128,9 @@ var listAvailableTemplates = async () => {
   const items = await fs.readdir(templatesDir);
   const templates = [];
   for (const item of items) {
+    if (item.startsWith(".")) {
+      continue;
+    }
     const itemPath = path.join(templatesDir, item);
     const stat = await fs.stat(itemPath);
     if (stat.isDirectory()) {
@@ -136,46 +139,32 @@ var listAvailableTemplates = async () => {
   }
   return templates;
 };
-var copySkills = async (templates, targetDir) => {
+var copySkills = async (_templates, targetDir) => {
   const counter = { files: 0, directories: 0 };
   const targetSkillsDir = path.join(targetDir, ".claude", "skills");
-  for (const template of templates) {
-    const templatePath = getTemplatePath(template);
-    const skillsSrc = path.join(templatePath, "docs", "skills");
-    if (await fs.pathExists(skillsSrc)) {
-      await fs.ensureDir(targetSkillsDir);
-      await copyRecursive(skillsSrc, targetSkillsDir, counter);
-    }
+  const skillsSrc = path.join(getTemplatesDir(), ".claude", "skills");
+  if (await fs.pathExists(skillsSrc)) {
+    await fs.ensureDir(targetSkillsDir);
+    await copyRecursive(skillsSrc, targetSkillsDir, counter);
   }
   return counter;
 };
-var copyCommands = async (templates, targetDir) => {
+var copyCommands = async (_templates, targetDir) => {
   const counter = { files: 0, directories: 0 };
   const targetCommandsDir = path.join(targetDir, ".claude", "commands");
-  for (const template of templates) {
-    const templatePath = getTemplatePath(template);
-    const commandsSrc = path.join(templatePath, "docs", "commands");
-    if (await fs.pathExists(commandsSrc)) {
-      await fs.ensureDir(targetCommandsDir);
-      await copyRecursive(commandsSrc, targetCommandsDir, counter);
-    }
+  const commandsSrc = path.join(getTemplatesDir(), ".claude", "commands");
+  if (await fs.pathExists(commandsSrc)) {
+    await fs.ensureDir(targetCommandsDir);
+    await copyRecursive(commandsSrc, targetCommandsDir, counter);
   }
   return counter;
 };
-var checkSkillsAndCommandsExist = async (templates) => {
-  let hasSkills = false;
-  let hasCommands = false;
-  for (const template of templates) {
-    const templatePath = getTemplatePath(template);
-    const skillsSrc = path.join(templatePath, "docs", "skills");
-    const commandsSrc = path.join(templatePath, "docs", "commands");
-    if (await fs.pathExists(skillsSrc)) {
-      hasSkills = true;
-    }
-    if (await fs.pathExists(commandsSrc)) {
-      hasCommands = true;
-    }
-  }
+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) => {
@@ -372,7 +361,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.1.12");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.1.14");
 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.1.12",
+  "version": "0.1.14",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/.claude/commands/feedback.md

@@ -0,0 +1,189 @@
+---
+description: 피드백 기반 코드 위치 탐색 및 수정. ultrathink + sequential thinking 10+ + subagent 필수.
+allowed-tools: Read, Edit, Glob, Grep, Bash(git:*, ast-grep:*), Task, mcp__sequential-thinking__sequentialthinking
+argument-hint: <피드백 내용>
+---
+
+# Feedback Command
+
+피드백을 분석하여 관련 코드를 찾고 수정하는 커맨드.
+
+## CRITICAL: 필수 요구사항
+
+| 요구사항 | 설명 |
+|----------|------|
+| **ARGUMENT 필수** | 피드백 내용 없이 실행 시 되물음 |
+| **Ultrathink** | 깊은 사고로 피드백 분석 |
+| **Sequential Thinking 10+** | 최소 10단계 사고 과정 필수 |
+| **Subagent (Task)** | 코드 탐색에 Task 도구 활용 |
+
+## ARGUMENT 확인
+
+```
+$ARGUMENTS 없음 → 즉시 질문:
+"어떤 피드백을 수정해야 하나요? 구체적으로 알려주세요."
+
+$ARGUMENTS 있음 → 다음 단계 진행
+```
+
+**피드백 내용**: $ARGUMENTS
+
+## 실행 흐름
+
+```
+1. ARGUMENT 확인 (없으면 되물음)
+2. Sequential Thinking 10+로 피드백 분석
+   - 피드백 의도 파악
+   - 키워드 추출
+   - 수정 대상 추론
+3. Task subagent로 코드 위치 탐색
+4. 후보 위치 정리
+   - 확실 → 수정 계획 제시
+   - 불확실 → 2~3개 후보 제시 → 컨펌 요청
+5. 사용자 컨펌
+   - Y → 수정 진행
+   - N → 더 찾기 반복
+6. 수정 완료 → git add <파일> && git commit
+```
+
+## Sequential Thinking 가이드
+
+**피드백 분석 시 최소 10단계:**
+
+```
+thought 1: 피드백 원문 분석 - 무엇을 수정하라는 것인가?
+thought 2: 핵심 키워드 추출 (기능명, 변수명, 컴포넌트명 등)
+thought 3: 피드백 유형 분류 (버그, UI, 로직, 성능 등)
+thought 4: 예상 파일 위치 추론 (디렉토리, 파일 패턴)
+thought 5: 검색 전략 수립 (ast-grep vs grep vs glob)
+thought 6: 첫 번째 탐색 결과 분석
+thought 7: 추가 탐색 필요 여부 판단
+thought 8: 후보 위치 정리 및 우선순위
+thought 9: 수정 방안 초안 작성
+thought 10: 수정 영향 범위 분석
+thought 11+: 필요시 추가 분석
+```
+
+## Task Subagent 활용
+
+**코드 탐색 시 Task 도구 사용:**
+
+| subagent_type | 용도 |
+|---------------|------|
+| `Explore` | 코드베이스 전반 탐색, 파일 구조 파악 |
+| `general-purpose` | 복잡한 로직 분석, 다중 파일 연관 관계 파악 |
+
+**Task 호출 예시:**
+
+```
+Task: "피드백 '[버튼 클릭 시 에러 발생]' 관련 코드 위치 탐색"
+subagent_type: Explore
+prompt: "버튼 클릭 핸들러, onClick 이벤트, 관련 컴포넌트 탐색.
+        에러 발생 가능 위치와 수정 대상 파일 목록 제시."
+```
+
+**병렬 탐색:**
+
+```
+여러 가능성 있을 때:
+Task 1: "컴포넌트 레벨 탐색" (Explore)
+Task 2: "API 호출 레벨 탐색" (Explore)
+Task 3: "상태 관리 레벨 탐색" (Explore)
+
+→ 단일 메시지에 다중 Task 호출
+→ 결과 취합 후 후보 정리
+```
+
+## 후보 제시 및 컨펌
+
+**확실한 경우 (1개):**
+
+```
+수정 대상: src/components/Button.tsx:42
+
+수정 계획:
+- onClick 핸들러에서 null 체크 추가
+- 에러 바운더리 적용
+
+이대로 수정할까요? (Y/N)
+```
+
+**불확실한 경우 (2~3개):**
+
+```
+후보 위치를 찾았습니다:
+
+1. src/components/Button.tsx:42
+   - onClick 핸들러 내 API 호출 부분
+
+2. src/hooks/useSubmit.ts:28
+   - submit 함수의 에러 처리 부분
+
+3. src/api/client.ts:15
+   - API 클라이언트 에러 핸들링
+
+어느 위치를 수정할까요? (1/2/3/N)
+- 숫자: 해당 위치 수정
+- N: 다른 위치 더 탐색
+```
+
+**N 선택 시:**
+
+```
+→ 추가 탐색 시작
+→ 다른 키워드/패턴으로 재검색
+→ 새로운 후보 제시
+→ 반복
+```
+
+## Git 커밋 규칙
+
+**수정 완료 후 커밋:**
+
+```bash
+# 수정한 파일만 add
+git add <수정된 파일>
+
+# 커밋 (한 줄, prefix 필수, 마침표 없음)
+git commit -m "fix: <피드백 요약>"
+```
+
+**커밋 메시지 예시:**
+
+```bash
+# ✅ 올바른
+git add src/components/Button.tsx
+git commit -m "fix: 버튼 클릭 시 null 체크 추가"
+
+git add src/hooks/useSubmit.ts
+git commit -m "fix: submit 에러 핸들링 개선"
+
+# ❌ 잘못된
+git commit -m "fix: 버튼 수정."           # 마침표
+git commit -m "피드백 반영"                # prefix 없음
+git commit -m "fix: 여러 파일 수정"       # 구체적이지 않음
+```
+
+**prefix 선택 기준:**
+
+| 피드백 유형 | prefix |
+|-------------|--------|
+| 버그 수정 | fix |
+| 기능 개선 | feat |
+| UI 수정 | style |
+| 성능 개선 | perf |
+| 코드 정리 | refactor |
+
+## CRITICAL: 절대 금지
+
+| 금지 항목 |
+|----------|
+| ARGUMENT 없이 수정 시작 |
+| Sequential Thinking 10단계 미만 |
+| 코드 탐색 없이 추측으로 수정 |
+| 사용자 컨펌 없이 수정 |
+| "Generated with Claude Code" 포함 |
+| "🤖" 또는 AI 관련 이모지 |
+| "Co-Authored-By:" 헤더 |
+| 여러 줄 커밋 메시지 |
+| 커밋 메시지에 마침표(.) |

package/templates/.claude/commands/version-update.md

@@ -0,0 +1,88 @@
+---
+description: 프로젝트 버전 업데이트 및 커밋
+allowed-tools: Bash(git:*), Read, Edit
+argument-hint: <new-version | +1>
+---
+
+프로젝트 전체 버전을 업데이트하고 커밋.
+
+**인수**: `$ARGUMENTS`
+
+## 인수 처리
+
+| 인수 | 동작 | 예시 |
+|------|------|------|
+| `+1` | patch 버전 +1 | 0.1.13 → 0.1.14 |
+| `+minor` | minor 버전 +1 | 0.1.13 → 0.2.0 |
+| `+major` | major 버전 +1 | 0.1.13 → 1.0.0 |
+| `x.x.x` | 해당 버전으로 설정 | 0.1.13 → 2.0.0 |
+
+## 실행 흐름
+
+```
+1. 현재 버전 확인 (병렬로 버전 파일들 읽기)
+2. 인수에 따라 새 버전 계산
+3. 모든 버전 파일 업데이트
+4. git add + git commit
+```
+
+## 버전 파일 목록
+
+| 파일 | 필드 |
+|------|------|
+| `packages/claude-code/package.json` | `"version": "x.x.x"` |
+| `packages/claude-code/src/index.ts` | `.version('x.x.x')` |
+
+## 병렬 실행
+
+**초기 확인 단계에서 병렬 실행 필수:**
+
+```
+Read: packages/claude-code/package.json
+Read: packages/claude-code/src/index.ts
+```
+
+## 업데이트 절차
+
+1. **버전 검증**: semver 형식 확인 (예: 0.1.14, 1.0.0)
+2. **Edit 도구로 각 파일 수정**:
+   - `package.json`: `"version": "이전버전"` → `"version": "새버전"`
+   - `index.ts`: `.version('이전버전')` → `.version('새버전')`
+3. **git add + git commit**
+
+## 커밋 규칙
+
+**형식**: `chore: 버전 X.X.X로 업데이트`
+
+## CRITICAL: 절대 금지
+
+| 금지 항목 |
+|----------|
+| "Generated with Claude Code" 포함 |
+| "🤖" 또는 AI 관련 이모지 |
+| "Co-Authored-By:" 헤더 |
+| AI/봇 작성 표시 일체 |
+| 여러 줄 커밋 메시지 |
+| 커밋 메시지에 마침표(.) |
+
+## 예시
+
+```bash
+# patch 버전 증가 (가장 일반적)
+/version-update +1
+# 0.1.13 → 0.1.14
+
+# minor 버전 증가
+/version-update +minor
+# 0.1.13 → 0.2.0
+
+# major 버전 증가
+/version-update +major
+# 0.1.13 → 1.0.0
+
+# 직접 버전 지정
+/version-update 2.0.0
+
+# 커밋 결과
+chore: 버전 0.1.14로 업데이트
+```

package/templates/npx/docs/commands/docs-creator.md

@@ -1,239 +0,0 @@
----
-description: Claude Code 문서 작성 가이드. CLAUDE.md, SKILL.md 등 효과적인 문서 작성 시 사용.
----
-
-# Docs Creator
-
-Claude Code 문서 작성 베스트 프랙티스 가이드.
-
-## 핵심 원칙
-
-| 원칙 | 설명 |
-|------|------|
-| **간결함** | 컨텍스트 윈도우는 공공재. 모든 토큰이 비용 |
-| **점진적 공개** | 핵심만 메인 파일에, 상세는 참조 파일로 분리 |
-| **보편적 적용** | 모든 세션에 필요한 정보만 포함 |
-
-## 문서 유형별 가이드
-
-| 문서 | 권장 길이 | 용도 |
-|------|----------|------|
-| CLAUDE.md | 60-200줄 | 프로젝트 전역 설정, 컨벤션 |
-| SKILL.md | 500줄 이하 | 특화 워크플로우, 도구 사용법 |
-| references/ | 무제한 | 상세 API 문서, 스키마 등 |
-
-**지침 개수 한계**: 150-200개 (Claude Code 자체 ~50개 사용)
-
-## 구조 템플릿
-
-### CLAUDE.md
-
-```markdown
-# 프로젝트명
-
-## 개요
-프로젝트 목적 (1-2문장)
-
-## 기술 스택
-- 프레임워크: X
-- 언어: Y
-- DB: Z
-
-## 명령어
-| 명령 | 설명 |
-|------|------|
-| `yarn dev` | 개발 서버 |
-| `yarn test` | 테스트 실행 |
-
-## 컨벤션
-- 파일명: kebab-case
-- 함수: const 화살표 함수
-- 타입: interface (객체), type (유니온)
-
-## 워크플로우
-기능 추가 → 테스트 → 린트 → 커밋
-```
-
-### SKILL.md
-
-```markdown
----
-name: skill-name
-description: 무엇을 하는지 + 언제 사용하는지. (scope)
----
-
-# Skill Name
-
-스킬 목적 (2-3문장)
-
-## 사용 시점
-- 조건 1
-- 조건 2
-
-## 사용 방법
-
-### 기본 워크플로우
-1. 단계 1
-2. 단계 2
-
-### 참조
-- 상세 API: [references/api.md](references/api.md)
-- 스키마: [references/schema.md](references/schema.md)
-```
-
-## Progressive Disclosure
-
-```
-project/
-├── CLAUDE.md           # 핵심만 (60-200줄)
-├── docs/
-│   ├── api.md          # API 상세
-│   └── architecture.md # 아키텍처
-└── .claude/skills/
-    └── my-skill/
-        ├── SKILL.md        # 개요 (<500줄)
-        └── references/     # 상세 정보
-```
-
-**토큰 로드 단계:**
-
-| 단계 | 내용 | 크기 |
-|------|------|------|
-| 1. 메타데이터 | name + description | 30-50 토큰 |
-| 2. 활성화 | SKILL.md 본문 | <5k 단어 |
-| 3. 참조 | 번들 리소스 | 필요 시만 |
-
-## 작성 규칙
-
-### DO
-
-- 불릿 포인트 + 짧은 문장
-- 코드 예시 중심
-- 표로 정보 구조화
-- 강조: `IMPORTANT:`, `YOU MUST:`
-- 1단계 깊이 참조 (A→B ✅, A→B→C ❌)
-
-### DON'T
-
-- 긴 서술형 문단
-- Claude가 아는 것 설명
-- 린터 역할 강요 (도구 사용)
-- 시간 의존적 정보
-- /init 자동 생성 의존
-
-## Description 작성
-
-SKILL.md의 description은 스킬 발견에 핵심.
-
-```yaml
-# Good - 구체적 + 트리거 포함
-description: PDF에서 텍스트/표 추출, 폼 작성. PDF 작업 시 사용.
-
-# Bad - 모호함
-description: 문서 처리
-```
-
-**규칙:**
-- 3인칭 작성 (시스템 프롬프트에 주입됨)
-- 무엇을 하는지 + 언제 사용하는지
-- 구체적 키워드 포함
-
-## Context 관리
-
-| 명령어 | 용도 | 시점 |
-|--------|------|------|
-| `/compact` | 컨텍스트 요약 | 70% 도달 |
-| `/clear` | 세션 초기화 | 새 기능 시작 |
-| `/resume` | 세션 복원 | 작업 재개 |
-
-**주의:** 마지막 20%는 복잡한 작업 피할 것
-
-## Subagent 활용
-
-문서 작성 시 subagent를 적극 활용하여 메인 컨텍스트 보호.
-
-### Subagent 종류
-
-| 타입 | 용도 | 문서 작성 활용 |
-|------|------|---------------|
-| `Explore` | 코드베이스 탐색 | 프로젝트 구조 파악, 패턴 분석 |
-| `Plan` | 구현 계획 수립 | 문서 구조 설계, 섹션 계획 |
-| `general-purpose` | 범용 조사 | 베스트 프랙티스 조사, 예시 수집 |
-
-### 활용 시점
-
-**CLAUDE.md 작성 시:**
-```
-1. Explore agent → 프로젝트 구조/기술 스택 파악
-2. Explore agent → 기존 컨벤션/패턴 분석
-3. 메인 에이전트 → 요약 기반 문서 작성
-```
-
-**SKILL.md 작성 시:**
-```
-1. Explore agent → 관련 코드/워크플로우 분석
-2. Plan agent → 스킬 구조 설계
-3. 메인 에이전트 → 설계 기반 작성
-```
-
-### 효과
-
-| 방식 | 컨텍스트 사용 |
-|------|--------------|
-| 직접 탐색 | 전체 파일 내용 로드 |
-| Subagent | 요약만 반환 → 90%+ 절약 |
-
-### 프롬프트 예시
-
-```
-Explore agent에게:
-"프로젝트 구조와 기술 스택을 분석하고,
-CLAUDE.md에 포함할 핵심 정보만 요약해줘.
-- 디렉토리 구조
-- 주요 의존성
-- 빌드/테스트 명령어
-- 코드 컨벤션"
-```
-
-```
-Plan agent에게:
-"이 스킬의 SKILL.md 구조를 설계해줘.
-- 스킬 목적
-- 주요 섹션
-- 참조 파일 분리 계획
-- 워크플로우 단계"
-```
-
-## 체크리스트
-
-### CLAUDE.md
-
-- [ ] 60-200줄 이내
-- [ ] 기술 스택 명시
-- [ ] 주요 명령어 포함
-- [ ] 컨벤션 정리
-- [ ] 민감 정보 제외
-
-### SKILL.md
-
-- [ ] 500줄 이하
-- [ ] description 구체적 (무엇 + 언제)
-- [ ] 3인칭 작성
-- [ ] 참조 1단계 깊이
-- [ ] 100줄+ 파일은 목차 포함
-- [ ] 워크플로우에 체크리스트
-
-### 공통
-
-- [ ] 간결한 작성
-- [ ] 코드 예시 포함
-- [ ] 표로 구조화
-- [ ] 시간 의존 정보 없음
-- [ ] Subagent로 사전 조사 완료
-- [ ] 테스트 완료
-
-## 참조
-
-- [Claude Code Best Practices](https://www.anthropic.com/engineering/claude-code-best-practices)
-- [Using CLAUDE.MD files](https://claude.com/blog/using-claude-md-files)
-- [Skill Best Practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)