@kood/claude-code 0.1.12 → 0.1.13

package/dist/index.js

@@ -136,46 +136,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 +358,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.13");
 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.13",
   "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/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)

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

@@ -1,168 +0,0 @@
----
-description: Claude Code 문서 리팩토링 가이드. 기존 CLAUDE.md, SKILL.md 개선 시 사용.
----
-
-# Docs Refactor
-
-기존 Claude Code 문서를 베스트 프랙티스에 맞게 개선하는 가이드.
-
-## 리팩토링 필요 신호
-
-| 신호 | 문제 | 우선순위 |
-|------|------|---------|
-| 200줄+ CLAUDE.md | 컨텍스트 과부하 | 높음 |
-| 500줄+ SKILL.md | 로딩 지연, 품질 저하 | 높음 |
-| Claude가 지침 무시 | 과도한 지침 (150+개) | 높음 |
-| 중첩 참조 (A→B→C) | 불완전한 파일 읽기 | 중간 |
-| 코드 스타일 지침 | 린터 역할 강요 | 중간 |
-| 시간 의존 정보 | 오래된 지침 | 낮음 |
-
-## 분석 워크플로우
-
-### 1단계: Subagent로 현황 분석
-
-```
-Explore agent에게:
-"현재 CLAUDE.md/SKILL.md를 분석하고 보고해줘:
-- 총 줄 수
-- 섹션별 줄 수
-- 지침 개수 (명령형 문장)
-- 중첩 참조 깊이
-- 린터 역할 지침 여부
-- 시간 의존 정보 여부"
-```
-
-### 2단계: 개선 계획 수립
-
-```
-Plan agent에게:
-"분석 결과를 바탕으로 리팩토링 계획 수립:
-- 삭제할 내용
-- 분리할 내용 (references/)
-- 병합할 섹션
-- 추가할 내용"
-```
-
-### 3단계: 리팩토링 실행
-
-메인 에이전트가 계획 기반으로 문서 수정.
-
-## 안티패턴 → 개선 패턴
-
-### 길이 문제
-
-| Before | After |
-|--------|-------|
-| 300줄 CLAUDE.md | 60-200줄 + docs/ 분리 |
-| 800줄 SKILL.md | 500줄 이하 + references/ 분리 |
-
-**분리 기준:**
-- 모든 세션에 필요 → 메인 파일
-- 특정 작업에만 필요 → 참조 파일
-
-### 구조 문제
-
-| Before | After |
-|--------|-------|
-| 긴 서술형 문단 | 불릿 포인트 + 짧은 문장 |
-| 중첩 참조 (A→B→C) | 1단계 깊이 (A→B) |
-| 목차 없는 100줄+ 파일 | 상단에 목차 추가 |
-
-### 내용 문제
-
-| Before | After |
-|--------|-------|
-| 코드 스타일 가이드 | 삭제 (Biome/ESLint 사용) |
-| Claude가 아는 설명 | 삭제 |
-| 시간 의존 정보 | "old patterns" 섹션으로 이동 |
-| 너무 많은 옵션 | 기본값 + 대안 1개 |
-
-**삭제 예시:**
-```markdown
-# Before - 불필요한 설명
-PDF (Portable Document Format)는 Adobe에서 개발한
-문서 형식으로, 텍스트와 이미지를 포함할 수 있습니다...
-
-# After - 핵심만
-PDF 텍스트 추출: `pdfplumber.open("file.pdf")`
-```
-
-### Description 문제
-
-| Before | After |
-|--------|-------|
-| `description: 문서 처리` | `description: PDF 텍스트/표 추출. PDF 작업 시 사용.` |
-| 1인칭/2인칭 | 3인칭 작성 |
-| 트리거 없음 | 구체적 트리거 포함 |
-
-## 분리 전략
-
-### 참조 파일로 분리할 내용
-
-| 내용 | 분리 위치 |
-|------|----------|
-| API 상세 문서 | `references/api.md` |
-| 스키마 정의 | `references/schema.md` |
-| 예시 모음 | `references/examples.md` |
-| 도메인별 가이드 | `references/{domain}.md` |
-
-### 분리 후 메인 파일 참조
-
-```markdown
-## API 사용
-
-기본 호출: `api.call(params)`
-
-**상세 API 문서**: [references/api.md](references/api.md)
-```
-
-## Subagent 활용
-
-| 단계 | Agent | 작업 |
-|------|-------|------|
-| 분석 | Explore | 현황 파악, 문제점 식별 |
-| 계획 | Plan | 리팩토링 전략 수립 |
-| 검증 | Explore | 개선 결과 확인 |
-
-### 검증 프롬프트
-
-```
-Explore agent에게:
-"리팩토링된 문서 검증:
-- 줄 수 목표 달성?
-- 지침 개수 150개 이하?
-- 중첩 참조 1단계?
-- 필수 정보 누락 없음?"
-```
-
-## 체크리스트
-
-### 분석 단계
-
-- [ ] Subagent로 현황 분석 완료
-- [ ] 문제점 목록 작성
-- [ ] 개선 우선순위 결정
-
-### 리팩토링 단계
-
-- [ ] 불필요한 설명 삭제
-- [ ] 코드 스타일 지침 삭제
-- [ ] 긴 내용 참조 파일로 분리
-- [ ] 중첩 참조 1단계로 평탄화
-- [ ] 100줄+ 파일에 목차 추가
-- [ ] Description 개선 (3인칭, 트리거)
-
-### 검증 단계
-
-- [ ] CLAUDE.md 60-200줄
-- [ ] SKILL.md 500줄 이하
-- [ ] 지침 개수 150개 이하
-- [ ] 참조 1단계 깊이
-- [ ] 필수 정보 유지 확인
-- [ ] 테스트 완료
-
-## 참조
-
-- [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)