@kood/claude-code 0.1.5 → 0.1.7

package/templates/npx/docs/skills/gemini-review/references/prompt-templates.md

@@ -1,301 +0,0 @@
-# Gemini 리뷰 프롬프트 템플릿
-
-## 명령어 패턴
-
-모든 명령어는 고정 모델 `gemini-2.5-pro`와 JSON 출력 사용.
-
-### 기본 패턴
-```bash
-gemini -m gemini-2.5-pro -p "{prompt}" --output-format json
-```
-
-### 파일 파이핑 패턴
-```bash
-cat {file_path} | gemini -m gemini-2.5-pro -p "{instructions}" --output-format json
-```
-
-### 멀티라인 Heredoc 패턴
-```bash
-gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
-{multi_line_prompt}
-EOF
-)"
-```
-
-### 응답 파싱
-```bash
-result=$(gemini -m gemini-2.5-pro -p "..." --output-format json)
-review_content=$(echo "$result" | jq -r '.response')
-echo "$review_content"
-```
-
----
-
-## 계획 리뷰 템플릿
-
-```bash
-gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
-[계획 리뷰 요청]
-
-## 컨텍스트
-프로젝트: {project_name}
-기술 스택: {tech_stack}
-현재 상태: {current_state_description}
-
-## 구현 계획
-{plan_content}
-
-## 리뷰 체크리스트
-{checklist_items}
-
-## 리뷰 지침
-이 구현 계획을 분석하여 다음에 대한 피드백을 제공해주세요:
-
-1. **완전성**
-   - 모든 요구사항이 다뤄졌는가?
-   - 누락된 단계나 고려사항이 있는가?
-
-2. **로직 및 실현 가능성**
-   - 이 접근방식이 의도대로 작동할 것인가?
-   - 논리적 결함이나 모순이 있는가?
-
-3. **엣지 케이스**
-   - 놓칠 수 있는 엣지 케이스는?
-   - 어떻게 처리해야 하는가?
-
-4. **위험 및 이슈**
-   - 구현 중 발생할 수 있는 문제는?
-   - 의존성이나 블로커가 있는가?
-
-5. **대안**
-   - 더 나은 접근방식이 있는가?
-   - 고려해야 할 트레이드오프는?
-
-응답 형식:
-- ✅ 계획의 강점
-- ⚠️ 발견된 우려사항 또는 이슈
-- 💡 개선 제안
-- 🔄 대안적 접근방식 (있다면)
-EOF
-)"
-```
-
----
-
-## 코드 리뷰 템플릿
-
-### 옵션 A: 인라인 코드
-```bash
-gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
-[코드 리뷰 요청]
-
-## 컨텍스트
-파일: {file_path}
-언어: {language}
-기술 스택: {tech_stack}
-목적: {purpose_description}
-
-## 리뷰할 코드
-```{language}
-{code_content}
-```
-
-## 리뷰 체크리스트
-{checklist_items}
-
-## 리뷰 지침
-다음에 초점을 맞춰 철저한 코드 리뷰를 수행해주세요:
-
-1. **버그 및 로직 오류**
-   - 잘못된 로직 또는 알고리즘
-   - Off-by-one 에러
-   - Null/undefined 처리
-   - 타입 불일치
-
-2. **보안 취약점**
-   - 명령어 인젝션 위험
-   - 경로 순회 공격
-   - 데이터 노출 위험
-   - 입력 유효성 검사 이슈
-
-3. **성능 이슈**
-   - 비효율적인 알고리즘 (문제 시 Big-O 명시)
-   - 메모리 누수
-   - 불필요한 연산
-   - 블로킹 작업
-
-4. **베스트 프랙티스**
-   - 코드 구성
-   - 명명 규칙
-   - 에러 처리 패턴
-   - 테스트 고려사항
-
-5. **유지보수성**
-   - 코드 명확성
-   - 문서화 필요성
-   - 결합도와 응집도
-   - 향후 확장성
-
-발견된 각 이슈에 대해 다음을 제공:
-- 🔴 심각 / 🟡 중요 / 🟢 경미
-- 위치 (라인 번호 또는 함수명)
-- 이슈 설명
-- 코드 예시와 함께 수정 제안
-EOF
-)"
-```
-
-### 옵션 B: 파일 내용 파이핑
-```bash
-cat {file_path} | gemini -m gemini-2.5-pro --output-format json -p "이 {language} 코드 ({tech_stack} 프로젝트)를 다음 관점에서 리뷰해주세요:
-1. 버그 및 로직 오류
-2. 보안 취약점
-3. 성능 이슈
-4. 베스트 프랙티스 위반
-5. 유지보수성 우려
-
-각 이슈에 대해: 심각도 (🔴 심각/🟡 중요/🟢 경미), 위치, 설명, 코드와 함께 수정 제안을 명시해주세요."
-```
-
----
-
-## 아키텍처 리뷰 템플릿
-
-```bash
-gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
-[아키텍처 리뷰 요청]
-
-## 시스템 개요
-이름: {system_name}
-목적: {system_purpose}
-기술 스택: {tech_stack}
-규모: {expected_scale}
-
-## 현재/제안 아키텍처
-{architecture_description}
-
-## 컴포넌트
-{components_list}
-
-## 데이터 흐름
-{data_flow_description}
-
-## 구체적인 질문
-{specific_questions}
-
-## 리뷰 지침
-다음을 고려하여 이 아키텍처를 평가해주세요:
-
-1. **확장성**
-   - 예상 로드를 처리할 수 있는가?
-   - 모듈화와 플러그인 시스템 고려?
-   - 확인된 병목 지점은?
-
-2. **신뢰성**
-   - 단일 장애 지점이 있는가?
-   - 에러 복구 메커니즘은?
-   - 그레이스풀 종료 처리는?
-
-3. **유지보수성**
-   - 컴포넌트 결합도는?
-   - 코드 구조가 명확한가?
-   - 테스트 용이성은?
-
-4. **보안**
-   - 공격 표면은?
-   - 입력 검증 전략은?
-   - 권한 관리는?
-
-5. **사용자 경험**
-   - CLI 인터페이스가 직관적인가?
-   - 에러 메시지가 도움이 되는가?
-   - 문서화가 충분한가?
-
-6. **트레이드오프**
-   - 무엇을 희생하고 있는가?
-   - 대안적 아키텍처는?
-   - 마이그레이션 경로 고려사항은?
-
-응답 형식:
-- 📊 전체 평가
-- ✅ 아키텍처 강점
-- ⚠️ 우려사항 및 위험
-- 💡 권장사항
-- 🔄 고려할 가치가 있는 대안적 접근방식
-EOF
-)"
-```
-
----
-
-## NPX CLI 특화 추가사항
-
-tech_stack이 `npx-cli`일 때 관련 템플릿에 추가:
-
-```
-## NPX CLI 특화 리뷰 포인트
-- Commander.js 명령어/옵션 설계
-- 인터랙티브 프롬프트 UX
-- fs-extra 파일 작업 패턴
-- 에러 메시지와 exit 코드
-- 콘솔 출력 포맷팅
-- 진행 상황 표시
-- package.json bin 필드 설정
-```
-
----
-
-## Node.js 특화 추가사항
-
-tech_stack이 `nodejs`일 때 관련 템플릿에 추가:
-
-```
-## Node.js 특화 리뷰 포인트
-- async/await 패턴 정확성
-- 스트림 처리
-- 프로세스 시그널 처리
-- 환경 변수 관리
-- 의존성 관리 및 버전 명시
-- 크로스 플랫폼 호환성
-```
-
----
-
-## 빠른 리뷰 템플릿
-
-### 보안 빠른 체크
-```bash
-cat {file_path} | gemini -m gemini-2.5-pro -p "이 CLI 코드를 보안 감사해주세요. 찾을 것: 명령어 인젝션, 경로 순회, 입력 유효성 검사 갭, 민감 정보 노출. 각각 심각도와 수정안과 함께 나열해주세요." --output-format json
-```
-
-### 성능 빠른 체크
-```bash
-cat {file_path} | gemini -m gemini-2.5-pro -p "이 Node.js 코드를 성능 리뷰해주세요. 찾을 것: 비효율적인 알고리즘 (Big-O 명시), 블로킹 작업, 메모리 이슈, 불필요한 연산. 최적화를 제안해주세요." --output-format json
-```
-
-### 버그 헌팅
-```bash
-cat {file_path} | gemini -m gemini-2.5-pro -p "이 코드에서 버그를 찾아주세요: 로직 오류, 엣지 케이스, null 처리, 레이스 컨디션, 타입 이슈. 각 버그에 대해 수정안을 보여주세요." --output-format json
-```
-
-### CLI UX 리뷰
-```bash
-cat {file_path} | gemini -m gemini-2.5-pro -p "이 CLI 코드의 사용자 경험을 리뷰해주세요: 도움말 텍스트, 에러 메시지, 진행 상황 표시, 입력 유효성 검사. 개선안을 제안해주세요." --output-format json
-```
-
-### 파일 작업 리뷰
-```bash
-cat {file_path} | gemini -m gemini-2.5-pro -p "이 파일 시스템 작업 코드를 리뷰해주세요: 에러 처리, 경로 검증, 임시 파일 정리, 권한 처리. 개선안을 제안해주세요." --output-format json
-```
-
----
-
-## 템플릿 사용 가이드
-
-1. 적절한 기본 템플릿 선택 (plan/code/architecture)
-2. 모든 `{placeholder}` 필드를 실제 내용으로 채움
-3. 기술 스택에 따라 `checklists.md`에서 관련 체크리스트 로드
-4. 해당 시 기술 스택 특화 추가사항 첨부
-5. Gemini CLI로 실행
-6. JSON 응답을 파싱하여 `.response` 필드 추출
-7. Gemini 원본 응답과 Claude 분석 모두 제시

package/templates/tanstack-start/docs/commands/git.md

@@ -1,145 +0,0 @@
-현재 git 상태를 확인하고, 아래 규칙에 따라 작업을 진행해주세요.
-
-**추가 지시사항**: $ARGUMENTS
-
----
-
-## 실행 절차
-
-### 추가 지시사항이 없는 경우 (기본 동작)
-1. `git status`로 현재 상태 확인
-2. `git diff`로 변경 내용 분석
-3. 스테이징 안 된 변경사항 → `git add`
-4. 커밋 안 된 변경사항 → 논리적 단위로 분리하여 `git commit`
-5. 최종 `git status`로 완료 확인
-
-### 추가 지시사항이 있는 경우
-- 사용자의 지시사항을 우선적으로 따름
-- 예: `/git push` → push 진행, `/git 특정파일만 커밋` → 해당 파일만 처리
-
----
-
-## ⛔ NEVER (절대 금지)
-
-```
-❌ 커밋에 "Generated with Claude Code" 포함
-❌ 커밋에 "🤖" 또는 AI 관련 이모지 포함
-❌ 커밋에 "Co-Authored-By:" 헤더 포함
-❌ 커밋에 AI/봇이 작성했다는 어떤 표시도 포함
-❌ 커밋 메시지 여러 줄 작성
-❌ 커밋 메시지에 이모지 사용
-❌ 커밋 메시지에 마침표(.) 사용
-❌ 여러 작업을 하나의 커밋으로 퉁치기
-```
-
----
-
-## ✅ ALWAYS (필수)
-
-### 커밋 형식
-
-```
-<prefix>: <설명>
-```
-
-**한 줄로 간결하게** 작성합니다. 본문이나 푸터는 작성하지 않습니다.
-
-### ⭐ 커밋 분리 원칙
-
-**하나의 커밋 = 하나의 논리적 변경 단위**
-
-```bash
-# ❌ 잘못된 방식: 모든 작업을 하나로 퉁침
-git add .
-git commit -m "feat: 여러 기능 추가"
-
-# ✅ 올바른 방식: 논리적 단위로 분리
-git add src/auth/
-git commit -m "feat: 사용자 인증 기능 추가"
-
-git add src/users/
-git commit -m "feat: 사용자 관리 기능 추가"
-
-git add docs/
-git commit -m "docs: API 문서 업데이트"
-```
-
----
-
-## 🏷 Prefix 목록
-
-| Prefix | 용도 | 예시 |
-|--------|------|------|
-| `feat` | 새로운 기능 | `feat: 사용자 인증 기능 추가` |
-| `fix` | 버그 수정 | `fix: 토큰 검증 오류 수정` |
-| `refactor` | 리팩토링 | `refactor: 인증 로직 분리` |
-| `style` | 코드 스타일 | `style: prettier 적용` |
-| `docs` | 문서 수정 | `docs: API 문서 업데이트` |
-| `test` | 테스트 | `test: 인증 테스트 추가` |
-| `chore` | 빌드/설정 | `chore: 의존성 업데이트` |
-| `perf` | 성능 개선 | `perf: 쿼리 최적화` |
-| `ci` | CI/CD | `ci: GitHub Actions 추가` |
-
----
-
-## ✅ 올바른 예시
-
-```bash
-feat: 사용자 로그인 기능 추가
-fix: 세션 만료 오류 수정
-refactor: 서비스 클래스 구조 개선
-docs: README 설치 가이드 추가
-chore: 의존성 버전 업그레이드
-```
-
----
-
-## ❌ 잘못된 예시
-
-```bash
-# prefix 없음
-사용자 인증 기능 추가함
-
-# 마침표 불필요
-feat: 사용자 인증 추가.
-
-# 대문자 사용
-FEAT: 사용자 인증 추가
-
-# scope 불필요
-feat(auth): 인증 추가
-
-# AI 작성 표시 (절대 금지!)
-feat: 로그인 기능 추가
-
-🤖 Generated with Claude Code
-
-# Co-Author 표시 (절대 금지!)
-feat: 로그인 기능 추가
-
-Co-Authored-By: Claude <noreply@anthropic.com>
-
-# 여러 줄 본문 (금지)
-feat: 로그인 기능 추가
-
-- 이메일 인증 추가
-- 세션 관리 구현
-
-# 여러 작업을 하나로 퉁침 (금지)
-feat: 로그인, 회원가입, 프로필 기능 추가
-```
-
----
-
-## 📦 커밋 분리 가이드
-
-### 언제 커밋을 분리해야 하나요?
-
-| 상황 | 커밋 분리 |
-|------|----------|
-| 서로 다른 기능 구현 | ✅ 분리 |
-| 버그 수정 + 새 기능 | ✅ 분리 |
-| 코드 변경 + 문서 변경 | ✅ 분리 |
-| 리팩토링 + 기능 추가 | ✅ 분리 |
-| 동일 기능의 관련 파일들 | 🔄 묶어도 됨 |
-| 동일 기능의 타입 + 구현 | 🔄 묶어도 됨 |

package/templates/tanstack-start/docs/mcp/context7.md

@@ -1,204 +0,0 @@
-# Context7 MCP
-
-> 라이브러리 공식 문서를 실시간으로 조회하는 도구
-
----
-
-## 🚀 Quick Reference
-
-```
-✅ 사용 필수 상황:
-- 라이브러리 API 사용법 확인
-- 최신 버전 문법 확인
-- 공식 문서 기반 구현
-- 버전 마이그레이션
-
-❌ 불필요한 상황:
-- 이미 알고 있는 기본 문법
-- 프로젝트 내부 코드 분석
-- 비즈니스 로직 구현
-```
-
----
-
-## 사용 방법
-
-### Step 1: 라이브러리 ID 조회
-
-```
-resolve-library-id 사용
-→ 라이브러리 이름으로 Context7 ID 획득
-```
-
-### Step 2: 문서 조회
-
-```
-get-library-docs 사용
-→ 특정 토픽의 문서 가져오기
-
-파라미터:
-- context7CompatibleLibraryID: 라이브러리 ID
-- topic: 조회할 주제 (예: "hooks", "routing")
-```
-
----
-
-## 프로젝트 라이브러리별 사용 예시
-
-### TanStack Start
-
-```
-토픽 예시:
-- "server functions" - createServerFn 사용법
-- "routing" - 파일 기반 라우팅
-- "loader" - 데이터 로딩
-- "middleware" - 미들웨어 설정
-```
-
-### TanStack Query
-
-```
-토픽 예시:
-- "useQuery" - 쿼리 훅
-- "useMutation" - 뮤테이션 훅
-- "invalidation" - 캐시 무효화
-- "optimistic updates" - 낙관적 업데이트
-```
-
-### Prisma
-
-```
-토픽 예시:
-- "findMany" - 다중 조회
-- "create" - 생성
-- "relations" - 관계 쿼리
-- "transactions" - 트랜잭션
-```
-
-### Zod
-
-```
-토픽 예시:
-- "object" - 객체 스키마
-- "email" - 이메일 검증 (v4)
-- "transform" - 변환
-- "refinement" - 커스텀 검증
-```
-
-### Tailwind CSS
-
-```
-토픽 예시:
-- "configuration" - 설정
-- "theme" - 테마 커스터마이징
-- "responsive" - 반응형
-- "dark mode" - 다크 모드
-```
-
-### Better Auth
-
-```
-토픽 예시:
-- "setup" - 초기 설정
-- "session" - 세션 관리
-- "providers" - OAuth 설정
-- "2fa" - 이중 인증
-```
-
----
-
-## 사용 시점
-
-### ✅ 반드시 사용
-
-| 상황 | 이유 |
-|------|------|
-| 새 API 사용 | 정확한 시그니처 확인 |
-| 버전 업그레이드 | 변경사항 확인 |
-| 에러 해결 | 올바른 사용법 확인 |
-| 고급 기능 | 옵션/설정 확인 |
-
-### ❌ 사용 불필요
-
-| 상황 | 이유 |
-|------|------|
-| 기본 문법 | 이미 문서화됨 |
-| 내부 코드 | Context7 범위 외 |
-| 비즈니스 로직 | 라이브러리 무관 |
-
----
-
-## 실전 예시
-
-### 예시 1: TanStack Query 캐시 무효화
-
-```
-상황: mutation 후 목록 갱신이 안됨
-
-1. Context7로 "invalidation" 토픽 조회
-2. queryClient.invalidateQueries 사용법 확인
-3. 올바른 queryKey 패턴 적용
-
-결과:
-queryClient.invalidateQueries({ queryKey: ['users'] })
-```
-
-### 예시 2: Prisma 관계 쿼리
-
-```
-상황: User와 Post를 함께 조회하고 싶음
-
-1. Context7로 "relations" 토픽 조회
-2. include 옵션 사용법 확인
-
-결과:
-prisma.user.findUnique({
-  where: { id },
-  include: { posts: true }
-})
-```
-
-### 예시 3: Zod v4 마이그레이션
-
-```
-상황: Zod v3 → v4 업그레이드
-
-1. Context7로 "migration" 또는 "email" 토픽 조회
-2. v4 새 API 확인
-
-결과:
-// v3: z.string().email()
-// v4: z.email()
-```
-
----
-
-## Sequential Thinking과 함께 사용
-
-```
-복잡한 구현 시:
-
-1. Sequential Thinking으로 구현 계획
-   ↓
-2. 필요한 라이브러리 기능 파악
-   ↓
-3. Context7로 각 기능 문서 조회
-   ↓
-4. 문서 기반 구현
-```
-
----
-
-## 주의사항
-
-- **최신 문서**: Context7은 최신 공식 문서 제공
-- **버전 확인**: 프로젝트 버전과 문서 버전 일치 확인
-- **토픽 선택**: 구체적인 토픽으로 조회 시 더 정확한 결과
-
----
-
-## 참고
-
-- 문서가 충분하지 않으면 다른 토픽으로 재조회
-- 여러 라이브러리 문서를 연속으로 조회 가능
-- Sequential Thinking과 조합하여 체계적 구현