@kood/claude-code 0.1.15 → 0.2.0

package/dist/index.js

@@ -361,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.15");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.2.0");
 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.15",
+  "version": "0.2.0",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

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 없이 진행 |

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

@@ -1,5 +1,5 @@
 ---
-description: 피드백 기반 코드 위치 탐색 및 수정. ultrathink + sequential thinking 10+ + subagent 필수.
+description: 피드백 기반 코드 위치 탐색 및 수정. ultrathink + sequential thinking 5+ + subagent 필수.
 allowed-tools: Read, Edit, Glob, Grep, Bash(git:*, ast-grep:*), Task, mcp__sequential-thinking__sequentialthinking
 argument-hint: <피드백 내용>
 ---
@@ -14,7 +14,7 @@ argument-hint: <피드백 내용>
 |----------|------|
 | **ARGUMENT 필수** | 피드백 내용 없이 실행 시 되물음 |
 | **Ultrathink** | 깊은 사고로 피드백 분석 |
-| **Sequential Thinking 10+** | 최소 10단계 사고 과정 필수 |
+| **Sequential Thinking 5+** | 최소 5단계, 복잡도에 따라 충분히 |
 | **Subagent (Task)** | 코드 탐색에 Task 도구 활용 |
 
 ## ARGUMENT 확인
@@ -32,7 +32,7 @@ $ARGUMENTS 있음 → 다음 단계 진행
 
 ```
 1. ARGUMENT 확인 (없으면 되물음)
-2. Sequential Thinking 10+로 피드백 분석
+2. Sequential Thinking 5+로 피드백 분석 (복잡도에 따라 조정)
    - 피드백 의도 파악
    - 키워드 추출
    - 수정 대상 추론
@@ -48,18 +48,28 @@ $ARGUMENTS 있음 → 다음 단계 진행
 
 ## Sequential Thinking 가이드
 
-**피드백 분석 시 최소 10단계:**
+**복잡도별 사고 횟수:**
+
+| 복잡도 | 횟수 | 예시 |
+|--------|------|------|
+| 간단 | 5 | 오타 수정, 단순 UI 조정, 명확한 버그 |
+| 보통 | 7-8 | 로직 수정, 컴포넌트 변경 |
+| 복잡 | 10+ | 다중 파일 영향, 아키텍처 관련 |
+
+**기본 사고 흐름 (최소 5단계):**
 
 ```
 thought 1: 피드백 원문 분석 - 무엇을 수정하라는 것인가?
 thought 2: 핵심 키워드 추출 (기능명, 변수명, 컴포넌트명 등)
 thought 3: 피드백 유형 분류 (버그, UI, 로직, 성능 등)
-thought 4: 예상 파일 위치 추론 (디렉토리, 파일 패턴)
-thought 5: 검색 전략 수립 (ast-grep vs grep vs glob)
+thought 4: 예상 파일 위치 추론 및 검색 전략 수립
+thought 5: 후보 위치 정리 및 수정 방안
+
+(복잡한 경우 추가)
 thought 6: 첫 번째 탐색 결과 분석
 thought 7: 추가 탐색 필요 여부 판단
-thought 8: 후보 위치 정리 및 우선순위
-thought 9: 수정 방안 초안 작성
+thought 8: 후보 위치 우선순위 재정리
+thought 9: 수정 방안 상세화
 thought 10: 수정 영향 범위 분석
 thought 11+: 필요시 추가 분석
 ```
@@ -179,7 +189,7 @@ git commit -m "fix: 여러 파일 수정"       # 구체적이지 않음
 | 금지 항목 |
 |----------|
 | ARGUMENT 없이 수정 시작 |
-| Sequential Thinking 10단계 미만 |
+| Sequential Thinking 5단계 미만 |
 | 코드 탐색 없이 추측으로 수정 |
 | 사용자 컨펌 없이 수정 |
 | "Generated with Claude Code" 포함 |

package/templates/.claude/commands/plan.md

@@ -0,0 +1,299 @@
+---
+description: 개발 진행 방법 검토 및 옵션 제시. ultrathink + sequential thinking 3-7 필수. 코드 수정 없이 계획만.
+allowed-tools: Read, Glob, Grep, Bash(git:*, ast-grep:*), Task, Write, mcp__sequential-thinking__sequentialthinking
+argument-hint: <개발할 기능 또는 해결할 문제>
+---
+
+# Plan Command
+
+개발 진행 방법을 검토하고 2-3개 옵션과 장단점을 제시하는 커맨드.
+
+## CRITICAL: 필수 요구사항
+
+| 요구사항 | 설명 |
+|----------|------|
+| **ARGUMENT 필수** | 계획 대상 없이 실행 시 되물음 |
+| **Ultrathink** | 깊은 사고로 옵션 분석 |
+| **Sequential Thinking 3-7** | 복잡도에 따라 조정 |
+| **코드 수정 금지** | 분석과 계획만. Edit 사용 불가 |
+| **옵션 2-3개** | 최소 2개, 권장 3개 |
+
+## ARGUMENT 확인
+
+```
+$ARGUMENTS 없음 → 즉시 질문:
+"무엇을 계획해야 하나요? 구체적으로 알려주세요.
+- 새 기능 추가
+- 버그 수정
+- 리팩토링
+- 아키텍처 변경"
+
+$ARGUMENTS 있음 → 다음 단계 진행
+```
+
+**계획 대상**: $ARGUMENTS
+
+## 실행 흐름
+
+```
+1. ARGUMENT 확인 (없으면 되물음)
+2. Sequential Thinking으로 복잡도 판단 (1단계)
+3. 복잡도에 따른 분석 (2-6단계)
+   - 현재 상태 파악
+   - 가능한 접근 방식 탐색
+   - 옵션별 장단점 분석
+4. Task subagent로 코드베이스 탐색
+5. 옵션 2-3개 정리 및 제시
+6. 사용자 선택 대기
+7. 문서 작성 필요 여부 질문
+   - Y → 계획 문서 작성
+   - N → 종료
+```
+
+## 복잡도 판단
+
+| 복잡도 | 사고 횟수 | 예시 |
+|--------|----------|------|
+| 간단 | 3 | 단일 파일 수정, 명확한 변경 |
+| 보통 | 5 | 다중 파일, 로직 변경 |
+| 복잡 | 7+ | 아키텍처 변경, 새 시스템 설계 |
+
+**복잡도 판단 기준:**
+
+```
+thought 1: 복잡도 판단
+- 영향 범위: 파일 수, 모듈 수
+- 의존성: 외부 라이브러리, 다른 시스템
+- 리스크: 기존 기능 영향, 롤백 가능성
+- 기술적 난이도: 새로운 패턴, 미지의 영역
+```
+
+## Sequential Thinking 가이드
+
+**기본 흐름 (5단계):**
+
+```
+thought 1: 복잡도 판단 및 분석 범위 결정
+thought 2: 현재 상태 분석 (코드, 아키텍처, 제약)
+thought 3: 가능한 접근 방식 열거 (4-5개)
+thought 4: 주요 옵션 3개 선정 및 장단점 분석
+thought 5: 최종 옵션 정리 및 추천안 도출
+```
+
+**복잡한 경우 (7단계):**
+
+```
+thought 1: 복잡도 판단
+thought 2: 현재 상태 심층 분석
+thought 3: 기술적 제약 및 요구사항 정리
+thought 4: 가능한 접근 방식 탐색
+thought 5: 각 접근 방식 비교 분석
+thought 6: 옵션 3개 선정 및 상세 장단점
+thought 7: 추천안 및 근거
+```
+
+## Task Subagent 활용
+
+| subagent_type | 용도 |
+|---------------|------|
+| `Explore` | 코드베이스 구조 파악, 관련 파일 탐색 |
+| `Plan` | 구현 전략 수립, 단계별 계획 |
+| `general-purpose` | 복잡한 분석, 다중 시스템 연관 |
+
+**Task 호출 예시:**
+
+```
+Task: "새 인증 시스템 구현을 위한 코드베이스 분석"
+subagent_type: Explore
+prompt: "현재 인증 관련 코드 구조 파악.
+        사용 중인 라이브러리, 세션 관리 방식,
+        수정이 필요한 파일 목록 제시."
+```
+
+**병렬 탐색:**
+
+```
+여러 측면 분석 필요 시:
+Task 1: "프론트엔드 구조 분석" (Explore)
+Task 2: "백엔드 API 분석" (Explore)
+Task 3: "데이터베이스 스키마 분석" (Explore)
+
+→ 단일 메시지에 다중 Task 호출
+→ 결과 취합 후 옵션 정리
+```
+
+## 옵션 제시 형식
+
+**옵션 3개 제시:**
+
+```
+## 분석 결과
+
+### 옵션 1: [옵션 이름] (추천)
+
+**접근 방식:**
+- 설명 1
+- 설명 2
+
+| 장점 | 단점 |
+|------|------|
+| 장점 1 | 단점 1 |
+| 장점 2 | 단점 2 |
+
+**영향 범위:**
+- 파일: `src/auth/`, `src/api/`
+- 예상 변경 규모: 중간
+
+---
+
+### 옵션 2: [옵션 이름]
+
+**접근 방식:**
+...
+
+---
+
+### 옵션 3: [옵션 이름]
+
+**접근 방식:**
+...
+
+---
+
+## 추천 및 근거
+
+옵션 1을 추천합니다.
+- 근거 1
+- 근거 2
+
+어떤 옵션을 선택하시겠습니까? (1/2/3)
+```
+
+**옵션 2개 제시 (선택지가 명확한 경우):**
+
+```
+## 분석 결과
+
+두 가지 접근 방식이 있습니다:
+
+### 옵션 A: [옵션 이름]
+...
+
+### 옵션 B: [옵션 이름]
+...
+
+어떤 옵션을 선택하시겠습니까? (A/B)
+```
+
+## 문서 작성 질문
+
+**옵션 선택 후 질문:**
+
+```
+옵션 [N]을 선택하셨습니다.
+
+계획 문서를 작성할까요?
+- Y: .claude/plans/[기능명].md 생성
+- N: 바로 구현 시작
+
+선택해주세요. (Y/N)
+```
+
+## 계획 문서 템플릿
+
+**파일 위치:** `.claude/plans/[기능명].md`
+
+```markdown
+# [기능명] 구현 계획
+
+## 개요
+
+**목표:** [무엇을 달성할 것인가]
+**선택된 접근 방식:** [옵션 N]
+**예상 영향 범위:** [파일/모듈 목록]
+
+## 현재 상태
+
+- 현재 구조 설명
+- 관련 코드 위치
+- 기존 제약사항
+
+## 구현 단계
+
+### 1단계: [단계 이름]
+
+**작업:**
+- [ ] 작업 1
+- [ ] 작업 2
+
+**변경 파일:**
+- `src/file1.ts`
+- `src/file2.ts`
+
+### 2단계: [단계 이름]
+...
+
+## 고려사항
+
+### 리스크
+
+| 리스크 | 완화 방안 |
+|--------|----------|
+| 리스크 1 | 방안 1 |
+
+### 의존성
+
+- 외부 라이브러리: [목록]
+- 다른 시스템: [목록]
+
+### 롤백 계획
+
+문제 발생 시 롤백 방법.
+
+## 검증 방법
+
+- 테스트 항목 1
+- 테스트 항목 2
+
+## 참조
+
+- 관련 문서 링크
+- 참고 자료
+```
+
+## 예시 워크플로우
+
+```
+1. 사용자: /plan 사용자 인증을 JWT에서 세션 기반으로 변경
+
+2. Sequential Thinking:
+   thought 1: "인증 시스템 변경 - 복잡도 높음, 7단계 분석"
+   thought 2: "현재 JWT 구현 분석 필요..."
+   ...
+
+3. Task 탐색:
+   Task: "현재 인증 구현 분석" (Explore)
+
+4. 옵션 제시:
+   옵션 1: 점진적 마이그레이션 (추천)
+   옵션 2: 완전 대체
+   옵션 3: 하이브리드 방식
+
+5. 사용자 선택: 1
+
+6. 문서 작성 질문: Y
+
+7. .claude/plans/session-auth.md 생성
+```
+
+## CRITICAL: 절대 금지
+
+| 금지 항목 |
+|----------|
+| ARGUMENT 없이 분석 시작 |
+| Edit 도구 사용 (코드 수정) |
+| Sequential Thinking 3단계 미만 |
+| 옵션 1개만 제시 |
+| 코드 탐색 없이 추측으로 옵션 제시 |
+| 사용자 선택 없이 구현 시작 |
+| 장단점 없이 옵션만 나열 |