@kood/claude-code 0.1.2 → 0.1.3

package/templates/tanstack-start/docs/skills/gemini-review/SKILL.md

@@ -1,76 +1,76 @@
 ---
 name: gemini-review
-description: This skill orchestrates code review and plan validation using Google Gemini CLI. It should be used when users want to validate implementation plans, review completed code, or discuss architecture decisions with Gemini as a second opinion. Supports FastAPI, Next.js, and general tech stacks with specialized checklists. Uses gemini-3-pro-preview model with free tier (60 req/min, 1000 req/day).
+description: Google Gemini CLI를 활용한 코드 리뷰 및 계획 검증 스킬. 구현 계획 검토, 코드 리뷰, 아키텍처 논의 시 Gemini를 세컨드 오피니언으로 활용. TanStack Start, FastAPI 등 특화 체크리스트 지원. gemini-2.5-pro 모델 사용 (무료: 60req/min, 1000req/day).
 ---
 
-# Gemini Review Skill
+# Gemini 리뷰 스킬
 
-## Overview
+## 개요
 
-This skill enables a dual-AI review workflow where Claude prepares context and Gemini provides independent validation. The output always includes both Gemini's raw feedback and Claude's synthesized action plan.
+Claude가 컨텍스트를 준비하고 Gemini가 독립적인 검증을 제공하는 듀얼 AI 리뷰 워크플로우. 결과는 항상 Gemini 원본 응답과 Claude의 종합 액션 플랜 두 섹션으로 제공.
 
-**Model**: `gemini-3-pro-preview` (fixed)
-**Cost**: Free tier (60 requests/min, 1000 requests/day)
+**모델**: `gemini-2.5-pro` (고정)
+**비용**: 무료 티어 (60 req/min, 1000 req/day)
 
-## When to Use
+## 사용 시점
 
-- Validating implementation plans before coding
-- Reviewing completed code for bugs, security, and best practices
-- Discussing architecture decisions with a second AI perspective
-- Getting specialized feedback for FastAPI or Next.js projects
+- 코딩 전 구현 계획 검증
+- 완성된 코드의 버그, 보안, 베스트 프랙티스 리뷰
+- 아키텍처 결정에 대한 세컨드 AI 의견
+- TanStack Start, FastAPI 프로젝트 특화 피드백
 
-## Workflow Types
+## 워크플로우 타입
 
-| Type | Purpose | When to Use |
-|------|---------|-------------|
-| **plan** | Validate implementation plan | Before starting development |
-| **code** | Review completed code | After implementing features |
-| **architecture** | Discuss system design | During design phase or refactoring |
+| 타입 | 목적 | 사용 시점 |
+|------|------|-----------|
+| **plan** | 구현 계획 검증 | 개발 시작 전 |
+| **code** | 완성 코드 리뷰 | 기능 구현 후 |
+| **architecture** | 시스템 설계 논의 | 설계 단계 또는 리팩토링 시 |
 
-## Execution Process
+## 실행 프로세스
 
-### Step 1: Gather Context from User
+### Step 1: 사용자 컨텍스트 수집
 
-Before executing, collect:
-1. **Review type**: `plan`, `code`, or `architecture`
-2. **Tech stack** (optional): `fastapi`, `nextjs`, or `general`
-3. **Content to review**: The actual plan, code, or architecture description
+실행 전 수집할 정보:
+1. **리뷰 타입**: `plan`, `code`, `architecture`
+2. **기술 스택** (선택): `tanstack-start`, `fastapi`, `general`
+3. **리뷰 대상**: 실제 계획, 코드, 아키텍처 설명
 
-### Step 2: Load Appropriate Checklist
+### Step 2: 체크리스트 로드
 
-Based on tech stack, load the corresponding checklist from `references/checklists.md`:
-- FastAPI: API design, Pydantic models, async patterns, security
-- Next.js: SSR/SSG, routing, state management, performance
-- General: Universal best practices
+기술 스택에 따라 `references/checklists.md`에서 해당 체크리스트 로드:
+- **TanStack Start**: 라우팅, 서버 함수, 데이터 페칭, SSR/CSR
+- **FastAPI**: API 설계, Pydantic 모델, 비동기 패턴, 보안
+- **General**: 범용 베스트 프랙티스
 
-### Step 3: Build and Execute Gemini Command
+### Step 3: Gemini 명령어 구성 및 실행
 
-Load the appropriate prompt template from `references/prompt-templates.md` and execute:
+`references/prompt-templates.md`에서 적절한 프롬프트 템플릿 로드 후 실행:
 
-**For inline prompts:**
+**인라인 프롬프트:**
 ```bash
-gemini -m gemini-3-pro-preview -p "{constructed_prompt}" --output-format json
+gemini -m gemini-2.5-pro -p "{constructed_prompt}" --output-format json
 ```
 
-**For file content review:**
+**파일 내용 리뷰:**
 ```bash
-cat {file_path} | gemini -m gemini-3-pro-preview -p "{review_instructions}" --output-format json
+cat {file_path} | gemini -m gemini-2.5-pro -p "{review_instructions}" --output-format json
 ```
 
-**For multi-line prompts (heredoc):**
+**멀티라인 프롬프트 (heredoc):**
 ```bash
-gemini -m gemini-3-pro-preview --output-format json -p "$(cat << 'EOF'
+gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
 {constructed_prompt}
 EOF
 )"
 ```
 
-### Step 4: Parse JSON Response
+### Step 4: JSON 응답 파싱
 
-Gemini returns JSON with this structure:
+Gemini 응답 구조:
 ```json
 {
-  "response": "The actual review content",
+  "response": "실제 리뷰 내용",
   "stats": {
     "models": { ... },
     "tools": { ... }
@@ -78,69 +78,69 @@ Gemini returns JSON with this structure:
 }
 ```
 
-Extract the review content from the `response` field. Use `jq` for parsing:
+`response` 필드에서 리뷰 내용 추출. `jq` 사용:
 ```bash
-result=$(gemini -m gemini-3-pro-preview -p "..." --output-format json)
+result=$(gemini -m gemini-2.5-pro -p "..." --output-format json)
 echo "$result" | jq -r '.response'
 ```
 
-### Step 5: Present Results in Two Sections
+### Step 5: 결과를 두 섹션으로 제시
 
-**CRITICAL**: Always present results in two clearly separated sections:
+**중요**: 항상 두 개의 명확히 구분된 섹션으로 결과 제시:
 
-#### Section A: Gemini Raw Response
-Present Gemini's complete response without modification. This shows the user exactly what Gemini found.
+#### 섹션 A: Gemini 원본 응답
+Gemini의 완전한 응답을 수정 없이 제시. 사용자에게 Gemini가 발견한 내용을 그대로 보여줌.
 
-#### Section B: Claude's Analysis & Action Plan
-Based on Gemini's feedback, Claude provides:
+#### 섹션 B: Claude 분석 및 액션 플랜
+Gemini 피드백을 기반으로 Claude가 제공:
 
-1. **Summary** (2-3 sentences)
-   - Key findings
-   - Overall assessment
+1. **요약** (2-3문장)
+   - 핵심 발견 사항
+   - 전체 평가
 
-2. **Action Items** (prioritized list)
-   - 🔴 Critical: Must fix before proceeding
-   - 🟡 Important: Should address soon
-   - 🟢 Minor: Nice to have improvements
+2. **액션 아이템** (우선순위 목록)
+   - 🔴 심각: 진행 전 반드시 수정
+   - 🟡 중요: 조속히 해결 필요
+   - 🟢 경미: 개선하면 좋음
 
-3. **Ready-to-Apply Code** (when applicable)
-   - Provide actual code fixes for each issue
-   - Include before/after comparison when helpful
+3. **바로 적용 가능한 코드** (해당 시)
+   - 각 이슈에 대한 실제 코드 수정안
+   - 필요 시 before/after 비교 포함
 
-## Output Format Template
+## 출력 형식 템플릿
 
 ```markdown
 ---
-## 📋 Gemini Review Results
+## 📋 Gemini 리뷰 결과
 
-### A. Gemini Response (Raw)
+### A. Gemini 응답 (원본)
 
 {gemini_response_verbatim}
 
 ---
 
-### B. Claude's Analysis
+### B. Claude 분석
 
-#### Summary
-{2-3 sentence overview}
+#### 요약
+{2-3문장 개요}
 
-#### Action Items
+#### 액션 아이템
 
-🔴 **Critical**
-- Issue: {description}
-- Fix: {solution}
+🔴 **심각**
+- 이슈: {설명}
+- 수정: {해결책}
 
-🟡 **Important**  
-- Issue: {description}
-- Fix: {solution}
+🟡 **중요**
+- 이슈: {설명}
+- 수정: {해결책}
 
-🟢 **Minor**
-- Issue: {description}
-- Fix: {solution}
+🟢 **경미**
+- 이슈: {설명}
+- 수정: {해결책}
 
-#### Ready-to-Apply Code
+#### 바로 적용 가능한 코드
 
-**{issue_name}**
+**{이슈명}**
 ```{language}
 {fixed_code}
 ```
@@ -148,73 +148,73 @@ Based on Gemini's feedback, Claude provides:
 ---
 ```
 
-## Command Examples
+## 명령어 예시
 
-### Plan Review
+### 계획 리뷰
 ```bash
-gemini -m gemini-3-pro-preview --output-format json -p "$(cat << 'EOF'
-[PLAN REVIEW REQUEST]
-Review this implementation plan for completeness and potential issues:
+gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
+[계획 리뷰 요청]
+이 구현 계획의 완전성과 잠재적 문제를 검토해주세요:
 
 {plan_content}
 
-Check for: Logic errors, missing edge cases, architecture flaws, security concerns.
-Provide specific, actionable feedback.
+확인 사항: 로직 오류, 누락된 엣지 케이스, 아키텍처 결함, 보안 우려.
+구체적이고 실행 가능한 피드백을 제공해주세요.
 EOF
 )"
 ```
 
-### Code Review (piping file)
+### 코드 리뷰 (파일 파이핑)
 ```bash
-cat src/api/auth.py | gemini -m gemini-3-pro-preview -p "Review this FastAPI authentication code for security issues, bugs, and best practices. Provide specific line-by-line feedback." --output-format json
+cat src/routes/api/auth.ts | gemini -m gemini-2.5-pro -p "이 TanStack Start 인증 코드를 보안 이슈, 버그, 베스트 프랙티스 관점에서 리뷰해주세요. 구체적인 라인별 피드백을 제공해주세요." --output-format json
 ```
 
-### Architecture Review
+### 아키텍처 리뷰
 ```bash
-gemini -m gemini-3-pro-preview --output-format json -p "$(cat << 'EOF'
-[ARCHITECTURE REVIEW]
-System: {system_name}
-Tech Stack: FastAPI + Next.js + AWS
+gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
+[아키텍처 리뷰]
+시스템: {system_name}
+기술 스택: TanStack Start + FastAPI + AWS
 
 {architecture_description}
 
-Evaluate: Scalability, reliability, maintainability, security, cost efficiency.
-Suggest improvements with trade-off analysis.
+평가 항목: 확장성, 신뢰성, 유지보수성, 보안, 비용 효율성.
+트레이드오프 분석과 함께 개선안을 제시해주세요.
 EOF
 )"
 ```
 
-## Environment Compatibility
+## 환경 호환성
 
-| Environment | Execution Method |
-|-------------|------------------|
-| Claude Code | Direct bash execution |
-| Claude (Web/Desktop) | Use `bash_tool` |
+| 환경 | 실행 방법 |
+|------|-----------|
+| Claude Code | 직접 bash 실행 |
+| Claude (Web/Desktop) | `bash_tool` 사용 |
 
-Command syntax remains identical across environments.
+명령어 문법은 모든 환경에서 동일.
 
-## Error Handling
+## 에러 처리
 
-If Gemini returns an error:
-1. Display the error message to user
-2. Check for common issues:
-   - Quota exceeded (60/min or 1000/day limit)
-   - Network connectivity
-   - Invalid prompt format
-3. Suggest retry or alternative approach
+Gemini 에러 발생 시:
+1. 사용자에게 에러 메시지 표시
+2. 일반적인 문제 확인:
+   - 할당량 초과 (60/min 또는 1000/day 한도)
+   - 네트워크 연결
+   - 잘못된 프롬프트 형식
+3. 재시도 또는 대안 제안
 
-## Quota Management
+## 할당량 관리
 
-Free tier limits:
-- 60 requests per minute
-- 1000 requests per day
+무료 티어 한도:
+- 분당 60 요청
+- 일당 1000 요청
 
-To conserve quota:
-- Combine related reviews into single prompts
-- Use specific, focused review requests
-- Avoid redundant re-reviews
+할당량 절약:
+- 관련 리뷰를 단일 프롬프트로 결합
+- 구체적이고 집중된 리뷰 요청 사용
+- 중복 리뷰 회피
 
-## References
+## 참조 파일
 
-- `references/checklists.md`: Tech stack-specific review checklists
-- `references/prompt-templates.md`: Prompt templates for each review type
+- `references/checklists.md`: 기술 스택별 리뷰 체크리스트
+- `references/prompt-templates.md`: 리뷰 타입별 프롬프트 템플릿

package/templates/tanstack-start/docs/skills/gemini-review/references/checklists.md

@@ -1,150 +1,144 @@
-# Review Checklists by Tech Stack
-
-## FastAPI Checklist
-
-### API Design
-- [ ] RESTful conventions followed (proper HTTP methods, status codes)
-- [ ] Consistent URL naming (kebab-case, plural nouns)
-- [ ] Proper use of path vs query parameters
-- [ ] API versioning strategy (if applicable)
-- [ ] Response model consistency across endpoints
-
-### Pydantic Models
-- [ ] Field validation with appropriate constraints (min, max, regex)
-- [ ] Optional vs required fields correctly defined
-- [ ] Proper use of `Field()` for metadata and examples
-- [ ] Config class settings (orm_mode, validate_assignment)
-- [ ] Custom validators where needed
-
-### Async Patterns
-- [ ] Async/await used consistently
-- [ ] No blocking I/O in async functions
-- [ ] Proper use of `asyncio.gather()` for concurrent operations
-- [ ] Background tasks for long-running operations
-- [ ] Connection pooling for databases
-
-### Security
-- [ ] Authentication implemented (OAuth2, JWT, API keys)
-- [ ] Authorization checks on protected endpoints
-- [ ] Input sanitization and validation
-- [ ] CORS configuration appropriate for use case
-- [ ] Rate limiting consideration
-- [ ] Secrets not hardcoded
-
-### Error Handling
-- [ ] Custom exception handlers defined
-- [ ] Consistent error response format
-- [ ] Proper HTTP status codes for errors
-- [ ] Sensitive information not leaked in errors
-
-### Performance
-- [ ] Database queries optimized (N+1 problem avoided)
-- [ ] Pagination for list endpoints
-- [ ] Caching strategy where appropriate
-- [ ] Response model excludes unnecessary fields
-
-### Testing
-- [ ] Test client setup with TestClient
-- [ ] Dependency overrides for mocking
-- [ ] Coverage of happy path and edge cases
+# 기술 스택별 리뷰 체크리스트
+
+## TanStack Start 체크리스트
+
+### 라우팅
+- [ ] 파일 기반 라우팅 구조가 논리적으로 구성됨
+- [ ] 동적 라우트가 적절히 파라미터화됨 (`$param`)
+- [ ] 레이아웃 라우트가 올바르게 중첩됨
+- [ ] 404 및 에러 경계가 적절히 처리됨
+- [ ] 라우트 그룹이 효과적으로 활용됨
+
+### 서버 함수
+- [ ] `createServerFn`이 올바르게 사용됨
+- [ ] 서버 함수에서 적절한 유효성 검사 수행
+- [ ] 에러 처리가 일관되게 구현됨
+- [ ] 민감한 데이터가 클라이언트에 노출되지 않음
+- [ ] 적절한 HTTP 메서드 사용 (GET vs POST)
+
+### 데이터 페칭
+- [ ] TanStack Query가 올바르게 통합됨
+- [ ] `queryOptions`가 적절히 정의됨
+- [ ] 로더에서 효율적인 데이터 페칭
+- [ ] 적절한 캐싱 전략 사용
+- [ ] 로딩/에러 상태 처리 완비
+
+### SSR/CSR
+- [ ] SSR이 필요한 곳에 적절히 사용됨
+- [ ] 클라이언트 전용 코드가 올바르게 분리됨
+- [ ] 하이드레이션 미스매치 방지
+- [ ] SEO 필수 페이지에 SSR 적용
+- [ ] 사용자별 데이터는 클라이언트에서 페칭
+
+### 상태 관리
+- [ ] 서버 상태와 클라이언트 상태가 분리됨
+- [ ] TanStack Query로 서버 상태 관리
+- [ ] 불필요한 전역 상태 최소화
+- [ ] 컨텍스트가 적절히 사용됨
+
+### 성능
+- [ ] 코드 스플리팅 적용
+- [ ] 이미지 최적화
+- [ ] 번들 사이즈 모니터링
+- [ ] 불필요한 리렌더링 방지
+
+### 타입스크립트
+- [ ] Strict 모드 활성화
+- [ ] Props 인터페이스 정의
+- [ ] API 응답 타입 정의
+- [ ] `any` 타입 사용 최소화
 
 ---
 
-## Next.js Checklist
-
-### Rendering Strategy
-- [ ] Appropriate use of SSR vs SSG vs ISR vs CSR
-- [ ] `getStaticProps` for static content
-- [ ] `getServerSideProps` only when necessary
-- [ ] ISR with proper revalidation intervals
-- [ ] Client-side fetching for user-specific data
-
-### Routing
-- [ ] File-based routing structure organized
-- [ ] Dynamic routes properly parameterized
-- [ ] Catch-all routes used appropriately
-- [ ] Route groups for organization (App Router)
-- [ ] Parallel routes if needed
-
-### Data Fetching
-- [ ] SWR or React Query for client-side
-- [ ] Proper loading and error states
-- [ ] Optimistic updates where appropriate
-- [ ] Cache invalidation strategy
-
-### State Management
-- [ ] Server state vs client state separated
-- [ ] Zustand/Jotai for simple state
-- [ ] Context used sparingly
-- [ ] State lifted appropriately
-
-### Performance
-- [ ] Image optimization with next/image
-- [ ] Font optimization with next/font
-- [ ] Code splitting and lazy loading
-- [ ] Bundle size monitored
-- [ ] Core Web Vitals considered
-
-### SEO
-- [ ] Metadata properly configured
-- [ ] Open Graph tags present
-- [ ] Structured data where appropriate
-- [ ] Sitemap generation
-- [ ] robots.txt configured
-
-### Security
-- [ ] API routes protected
-- [ ] Environment variables properly used
-- [ ] CSRF protection if needed
-- [ ] Content Security Policy headers
-
-### TypeScript
-- [ ] Strict mode enabled
-- [ ] Props interfaces defined
-- [ ] API response types defined
-- [ ] No `any` types without justification
+## FastAPI 체크리스트
+
+### API 설계
+- [ ] RESTful 규칙 준수 (적절한 HTTP 메서드, 상태 코드)
+- [ ] 일관된 URL 명명 (kebab-case, 복수형 명사)
+- [ ] path vs query 파라미터 적절한 사용
+- [ ] API 버저닝 전략 (해당 시)
+- [ ] 엔드포인트 간 응답 모델 일관성
+
+### Pydantic 모델
+- [ ] 적절한 제약조건으로 필드 유효성 검사 (min, max, regex)
+- [ ] Optional vs required 필드 올바르게 정의
+- [ ] `Field()`로 메타데이터와 예시 적절히 사용
+- [ ] Config 클래스 설정 (orm_mode, validate_assignment)
+- [ ] 필요 시 커스텀 밸리데이터
+
+### 비동기 패턴
+- [ ] async/await 일관되게 사용
+- [ ] async 함수 내 블로킹 I/O 없음
+- [ ] 동시 작업에 `asyncio.gather()` 적절히 사용
+- [ ] 장시간 작업에 백그라운드 태스크 사용
+- [ ] 데이터베이스 연결 풀링
+
+### 보안
+- [ ] 인증 구현 (OAuth2, JWT, API 키)
+- [ ] 보호된 엔드포인트에 인가 검사
+- [ ] 입력 검증 및 살균
+- [ ] 적절한 CORS 설정
+- [ ] 레이트 리미팅 고려
+- [ ] 하드코딩된 시크릿 없음
+
+### 에러 처리
+- [ ] 커스텀 예외 핸들러 정의
+- [ ] 일관된 에러 응답 형식
+- [ ] 에러에 적절한 HTTP 상태 코드
+- [ ] 에러에 민감 정보 노출 없음
+
+### 성능
+- [ ] 데이터베이스 쿼리 최적화 (N+1 문제 방지)
+- [ ] 목록 엔드포인트에 페이지네이션
+- [ ] 적절한 캐싱 전략
+- [ ] 응답 모델에서 불필요한 필드 제외
+
+### 테스팅
+- [ ] TestClient로 테스트 클라이언트 설정
+- [ ] 모킹을 위한 의존성 오버라이드
+- [ ] 정상 경로 및 엣지 케이스 커버리지
 
 ---
 
-## General Checklist
-
-### Code Quality
-- [ ] Single responsibility principle followed
-- [ ] DRY - no unnecessary duplication
-- [ ] Functions/methods are focused and small
-- [ ] Clear naming conventions
-- [ ] Comments explain "why", not "what"
-
-### Logic & Correctness
-- [ ] Edge cases handled (empty, null, boundary values)
-- [ ] Error handling comprehensive
-- [ ] Race conditions considered
-- [ ] Input validation present
-- [ ] Return values checked
-
-### Security
-- [ ] No hardcoded secrets
-- [ ] User input sanitized
-- [ ] SQL injection prevented (parameterized queries)
-- [ ] XSS prevention measures
-- [ ] Authentication/authorization proper
-
-### Performance
-- [ ] Time complexity acceptable for scale
-- [ ] Space complexity reasonable
-- [ ] No unnecessary loops or iterations
-- [ ] Database queries optimized
-- [ ] Caching considered where appropriate
-
-### Maintainability
-- [ ] Code is testable
-- [ ] Dependencies minimal and justified
-- [ ] Configuration externalized
-- [ ] Logging present for debugging
-- [ ] Error messages helpful
-
-### Documentation
-- [ ] Public APIs documented
-- [ ] Complex logic explained
-- [ ] Setup instructions clear
-- [ ] Environment variables documented
+## 범용 체크리스트
+
+### 코드 품질
+- [ ] 단일 책임 원칙 준수
+- [ ] DRY - 불필요한 중복 없음
+- [ ] 함수/메서드가 집중적이고 작음
+- [ ] 명확한 명명 규칙
+- [ ] 주석은 "why"를 설명, "what"이 아님
+
+### 로직 및 정확성
+- [ ] 엣지 케이스 처리 (빈 값, null, 경계값)
+- [ ] 포괄적인 에러 처리
+- [ ] 레이스 컨디션 고려
+- [ ] 입력 유효성 검사
+- [ ] 반환값 확인
+
+### 보안
+- [ ] 하드코딩된 시크릿 없음
+- [ ] 사용자 입력 살균
+- [ ] SQL 인젝션 방지 (파라미터화된 쿼리)
+- [ ] XSS 방지 조치
+- [ ] 적절한 인증/인가
+
+### 성능
+- [ ] 스케일에 적합한 시간 복잡도
+- [ ] 적절한 공간 복잡도
+- [ ] 불필요한 반복 없음
+- [ ] 데이터베이스 쿼리 최적화
+- [ ] 적절한 캐싱 고려
+
+### 유지보수성
+- [ ] 테스트 가능한 코드
+- [ ] 최소한의 정당화된 의존성
+- [ ] 설정 외부화
+- [ ] 디버깅을 위한 로깅
+- [ ] 도움이 되는 에러 메시지
+
+### 문서화
+- [ ] 공개 API 문서화
+- [ ] 복잡한 로직 설명
+- [ ] 명확한 설정 가이드
+- [ ] 환경 변수 문서화