@kood/claude-code 0.1.2 → 0.1.3

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

@@ -1,293 +1,292 @@
-# Prompt Templates for Gemini Review
+# Gemini 리뷰 프롬프트 템플릿
 
-## Command Patterns
+## 명령어 패턴
 
-All commands use the fixed model `gemini-3-pro-preview` with JSON output for parsing.
+모든 명령어는 고정 모델 `gemini-2.5-pro`와 JSON 출력 사용.
 
-### Basic Pattern
+### 기본 패턴
 ```bash
-gemini -m gemini-3-pro-preview -p "{prompt}" --output-format json
+gemini -m gemini-2.5-pro -p "{prompt}" --output-format json
 ```
 
-### File Piping Pattern
+### 파일 파이핑 패턴
 ```bash
-cat {file_path} | gemini -m gemini-3-pro-preview -p "{instructions}" --output-format json
+cat {file_path} | gemini -m gemini-2.5-pro -p "{instructions}" --output-format json
 ```
 
-### Multi-line Heredoc Pattern
+### 멀티라인 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'
 {multi_line_prompt}
 EOF
 )"
 ```
 
-### Response Parsing
+### 응답 파싱
 ```bash
-result=$(gemini -m gemini-3-pro-preview -p "..." --output-format json)
+result=$(gemini -m gemini-2.5-pro -p "..." --output-format json)
 review_content=$(echo "$result" | jq -r '.response')
 echo "$review_content"
 ```
 
 ---
 
-## Plan Review Template
+## 계획 리뷰 템플릿
 
 ```bash
-gemini -m gemini-3-pro-preview --output-format json -p "$(cat << 'EOF'
-[PLAN REVIEW REQUEST]
+gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
+[계획 리뷰 요청]
 
-## Context
-Project: {project_name}
-Tech Stack: {tech_stack}
-Current State: {current_state_description}
+## 컨텍스트
+프로젝트: {project_name}
+기술 스택: {tech_stack}
+현재 상태: {current_state_description}
 
-## Implementation Plan
+## 구현 계획
 {plan_content}
 
-## Review Checklist
+## 리뷰 체크리스트
 {checklist_items}
 
-## Review Instructions
-Analyze this implementation plan and provide feedback on:
+## 리뷰 지침
+이 구현 계획을 분석하여 다음에 대한 피드백을 제공해주세요:
 
-1. **Completeness**
-   - Are all requirements addressed?
-   - Any missing steps or considerations?
+1. **완전성**
+   - 모든 요구사항이 다뤄졌는가?
+   - 누락된 단계나 고려사항이 있는가?
 
-2. **Logic & Feasibility**
-   - Will this approach work as intended?
-   - Any logical flaws or contradictions?
+2. **로직 및 실현 가능성**
+   - 이 접근방식이 의도대로 작동할 것인가?
+   - 논리적 결함이나 모순이 있는가?
 
-3. **Edge Cases**
-   - What edge cases might be missed?
-   - How should they be handled?
+3. **엣지 케이스**
+   - 놓칠 수 있는 엣지 케이스는?
+   - 어떻게 처리해야 하는가?
 
-4. **Risks & Issues**
-   - Potential problems during implementation?
-   - Dependencies or blockers?
+4. **위험 및 이슈**
+   - 구현 중 발생할 수 있는 문제는?
+   - 의존성이나 블로커가 있는가?
 
-5. **Alternatives**
-   - Better approaches available?
-   - Trade-offs to consider?
+5. **대안**
+   - 더 나은 접근방식이 있는가?
+   - 고려해야 할 트레이드오프는?
 
-Respond with:
-- ✅ Strengths of the plan
-- ⚠️ Concerns or issues found
-- 💡 Suggestions for improvement
-- 🔄 Alternative approaches (if any)
+응답 형식:
+- ✅ 계획의 강점
+- ⚠️ 발견된 우려사항 또는 이슈
+- 💡 개선 제안
+- 🔄 대안적 접근방식 (있다면)
 EOF
 )"
 ```
 
 ---
 
-## Code Review Template
+## 코드 리뷰 템플릿
 
-### Option A: Inline Code
+### 옵션 A: 인라인 코드
 ```bash
-gemini -m gemini-3-pro-preview --output-format json -p "$(cat << 'EOF'
-[CODE REVIEW REQUEST]
+gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
+[코드 리뷰 요청]
 
-## Context
-File: {file_path}
-Language: {language}
-Tech Stack: {tech_stack}
-Purpose: {purpose_description}
+## 컨텍스트
+파일: {file_path}
+언어: {language}
+기술 스택: {tech_stack}
+목적: {purpose_description}
 
-## Code to Review
+## 리뷰할 코드
 ```{language}
 {code_content}
 ```
 
-## Review Checklist
+## 리뷰 체크리스트
 {checklist_items}
 
-## Review Instructions
-Perform a thorough code review focusing on:
-
-1. **Bugs & Logic Errors**
-   - Incorrect logic or algorithms
-   - Off-by-one errors
-   - Null/undefined handling
-   - Type mismatches
-
-2. **Security Vulnerabilities**
-   - Injection risks (SQL, XSS, etc.)
-   - Authentication/authorization gaps
-   - Data exposure risks
-   - Input validation issues
-
-3. **Performance Issues**
-   - Inefficient algorithms (specify Big-O if problematic)
-   - N+1 queries
-   - Memory leaks
-   - Unnecessary operations
-
-4. **Best Practices**
-   - Code organization
-   - Naming conventions
-   - Error handling patterns
-   - Testing considerations
-
-5. **Maintainability**
-   - Code clarity
-   - Documentation needs
-   - Coupling and cohesion
-   - Future extensibility
-
-For each issue found, provide:
-- 🔴 CRITICAL / 🟡 IMPORTANT / 🟢 MINOR
-- Location (line number or function name)
-- Description of the issue
-- Suggested fix with code example
+## 리뷰 지침
+다음에 초점을 맞춰 철저한 코드 리뷰를 수행해주세요:
+
+1. **버그 및 로직 오류**
+   - 잘못된 로직 또는 알고리즘
+   - Off-by-one 에러
+   - Null/undefined 처리
+   - 타입 불일치
+
+2. **보안 취약점**
+   - 인젝션 위험 (SQL, XSS 등)
+   - 인증/인가 갭
+   - 데이터 노출 위험
+   - 입력 유효성 검사 이슈
+
+3. **성능 이슈**
+   - 비효율적인 알고리즘 (문제 시 Big-O 명시)
+   - N+1 쿼리
+   - 메모리 누수
+   - 불필요한 연산
+
+4. **베스트 프랙티스**
+   - 코드 구성
+   - 명명 규칙
+   - 에러 처리 패턴
+   - 테스트 고려사항
+
+5. **유지보수성**
+   - 코드 명확성
+   - 문서화 필요성
+   - 결합도와 응집도
+   - 향후 확장성
+
+발견된 각 이슈에 대해 다음을 제공:
+- 🔴 심각 / 🟡 중요 / 🟢 경미
+- 위치 (라인 번호 또는 함수명)
+- 이슈 설명
+- 코드 예시와 함께 수정 제안
 EOF
 )"
 ```
 
-### Option B: Piping File Content
+### 옵션 B: 파일 내용 파이핑
 ```bash
-cat {file_path} | gemini -m gemini-3-pro-preview --output-format json -p "Review this {language} code ({tech_stack} project) for:
-1. Bugs and logic errors
-2. Security vulnerabilities  
-3. Performance issues
-4. Best practices violations
-5. Maintainability concerns
-
-For each issue: specify severity (🔴 CRITICAL/🟡 IMPORTANT/🟢 MINOR), location, description, and suggested fix with code."
+cat {file_path} | gemini -m gemini-2.5-pro --output-format json -p "이 {language} 코드 ({tech_stack} 프로젝트)를 다음 관점에서 리뷰해주세요:
+1. 버그 및 로직 오류
+2. 보안 취약점
+3. 성능 이슈
+4. 베스트 프랙티스 위반
+5. 유지보수성 우려
+
+각 이슈에 대해: 심각도 (🔴 심각/🟡 중요/🟢 경미), 위치, 설명, 코드와 함께 수정 제안을 명시해주세요."
 ```
 
 ---
 
-## Architecture Review Template
+## 아키텍처 리뷰 템플릿
 
 ```bash
-gemini -m gemini-3-pro-preview --output-format json -p "$(cat << 'EOF'
-[ARCHITECTURE REVIEW REQUEST]
+gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
+[아키텍처 리뷰 요청]
 
-## System Overview
-Name: {system_name}
-Purpose: {system_purpose}
-Tech Stack: {tech_stack}
-Scale: {expected_scale}
+## 시스템 개요
+이름: {system_name}
+목적: {system_purpose}
+기술 스택: {tech_stack}
+규모: {expected_scale}
 
-## Current/Proposed Architecture
+## 현재/제안 아키텍처
 {architecture_description}
 
-## Components
+## 컴포넌트
 {components_list}
 
-## Data Flow
+## 데이터 흐름
 {data_flow_description}
 
-## Specific Questions
+## 구체적인 질문
 {specific_questions}
 
-## Review Instructions
-Evaluate this architecture considering:
-
-1. **Scalability**
-   - Can it handle expected load?
-   - Horizontal vs vertical scaling options?
-   - Bottlenecks identified?
-
-2. **Reliability**
-   - Single points of failure?
-   - Fault tolerance mechanisms?
-   - Recovery strategies?
-
-3. **Maintainability**
-   - Component coupling?
-   - Deployment complexity?
-   - Operational overhead?
-
-4. **Security**
-   - Attack surface?
-   - Data protection?
-   - Access control boundaries?
-
-5. **Cost Efficiency**
-   - Resource utilization?
-   - Scaling costs?
-   - Operational costs?
-
-6. **Trade-offs**
-   - What are we sacrificing?
-   - Alternative architectures?
-   - Migration path considerations?
-
-Respond with:
-- 📊 Overall assessment
-- ✅ Architectural strengths
-- ⚠️ Concerns and risks
-- 💡 Recommendations
-- 🔄 Alternative approaches worth considering
+## 리뷰 지침
+다음을 고려하여 이 아키텍처를 평가해주세요:
+
+1. **확장성**
+   - 예상 로드를 처리할 수 있는가?
+   - 수평 vs 수직 스케일링 옵션은?
+   - 확인된 병목 지점은?
+
+2. **신뢰성**
+   - 단일 장애 지점이 있는가?
+   - 내결함성 메커니즘은?
+   - 복구 전략은?
+
+3. **유지보수성**
+   - 컴포넌트 결합도는?
+   - 배포 복잡성은?
+   - 운영 오버헤드는?
+
+4. **보안**
+   - 공격 표면은?
+   - 데이터 보호는?
+   - 접근 제어 경계는?
+
+5. **비용 효율성**
+   - 리소스 활용도는?
+   - 스케일링 비용은?
+   - 운영 비용은?
+
+6. **트레이드오프**
+   - 무엇을 희생하고 있는가?
+   - 대안적 아키텍처는?
+   - 마이그레이션 경로 고려사항은?
+
+응답 형식:
+- 📊 전체 평가
+- ✅ 아키텍처 강점
+- ⚠️ 우려사항 및 위험
+- 💡 권장사항
+- 🔄 고려할 가치가 있는 대안적 접근방식
 EOF
 )"
 ```
 
 ---
 
-## FastAPI-Specific Additions
+## TanStack Start 특화 추가사항
 
-When tech_stack is `fastapi`, append to the relevant template:
+tech_stack이 `tanstack-start`일 때 관련 템플릿에 추가:
 
 ```
-## FastAPI-Specific Review Points
-- Pydantic model design and validation
-- Async/await correctness
-- Dependency injection usage
-- OpenAPI documentation quality
-- Middleware and exception handler patterns
-- Database session management
-- Background task handling
+## TanStack Start 특화 리뷰 포인트
+- 파일 기반 라우팅 구조와 중첩
+- createServerFn 사용 및 보안
+- TanStack Query 통합 패턴
+- SSR/CSR 선택의 적절성
+- 로더와 서버 함수 데이터 페칭 전략
+- 하이드레이션 처리
+- TypeScript 타입 안전성
 ```
 
 ---
 
-## Next.js-Specific Additions
+## FastAPI 특화 추가사항
 
-When tech_stack is `nextjs`, append to the relevant template:
+tech_stack이 `fastapi`일 때 관련 템플릿에 추가:
 
 ```
-## Next.js-Specific Review Points
-- Rendering strategy appropriateness (SSR/SSG/ISR/CSR)
-- Data fetching patterns
-- Route organization
-- Image and font optimization
-- Bundle size impact
-- SEO metadata handling
-- API route security
-- TypeScript type safety
+## FastAPI 특화 리뷰 포인트
+- Pydantic 모델 설계 및 유효성 검사
+- async/await 정확성
+- 의존성 주입 사용
+- OpenAPI 문서 품질
+- 미들웨어 및 예외 핸들러 패턴
+- 데이터베이스 세션 관리
+- 백그라운드 태스크 처리
 ```
 
 ---
 
-## Quick Review Templates
+## 빠른 리뷰 템플릿
 
-### Security Quick Check
+### 보안 빠른 체크
 ```bash
-cat {file_path} | gemini -m gemini-3-pro-preview -p "Security audit this code. Find: injection vulnerabilities, auth issues, data exposure risks, input validation gaps. List each with severity and fix." --output-format json
+cat {file_path} | gemini -m gemini-2.5-pro -p "이 코드를 보안 감사해주세요. 찾을 것: 인젝션 취약점, 인증 이슈, 데이터 노출 위험, 입력 유효성 검사 갭. 각각 심각도와 수정안과 함께 나열해주세요." --output-format json
 ```
 
-### Performance Quick Check
+### 성능 빠른 체크
 ```bash
-cat {file_path} | gemini -m gemini-3-pro-preview -p "Performance review this code. Find: inefficient algorithms (note Big-O), N+1 queries, memory issues, unnecessary operations. Suggest optimizations." --output-format json
+cat {file_path} | gemini -m gemini-2.5-pro -p "이 코드를 성능 리뷰해주세요. 찾을 것: 비효율적인 알고리즘 (Big-O 명시), N+1 쿼리, 메모리 이슈, 불필요한 연산. 최적화를 제안해주세요." --output-format json
 ```
 
-### Bug Hunt
+### 버그 헌팅
 ```bash
-cat {file_path} | gemini -m gemini-3-pro-preview -p "Find bugs in this code: logic errors, edge cases, null handling, race conditions, type issues. For each bug, show the fix." --output-format json
+cat {file_path} | gemini -m gemini-2.5-pro -p "이 코드에서 버그를 찾아주세요: 로직 오류, 엣지 케이스, null 처리, 레이스 컨디션, 타입 이슈. 각 버그에 대해 수정안을 보여주세요." --output-format json
 ```
 
 ---
 
-## Template Usage Instructions
+## 템플릿 사용 가이드
 
-1. Select the appropriate base template (plan/code/architecture)
-2. Fill in all `{placeholder}` fields with actual content
-3. Load the relevant checklist from `checklists.md` based on tech stack
-4. Append tech-stack-specific additions if applicable
-5. Execute via Gemini CLI
-6. Parse JSON response to extract `.response` field
-7. Present both raw Gemini response and Claude's analysis
+1. 적절한 기본 템플릿 선택 (plan/code/architecture)
+2. 모든 `{placeholder}` 필드를 실제 내용으로 채움
+3. 기술 스택에 따라 `checklists.md`에서 관련 체크리스트 로드
+4. 해당 시 기술 스택 특화 추가사항 첨부
+5. Gemini CLI로 실행
+6. JSON 응답을 파싱하여 `.response` 필드 추출
+7. Gemini 원본 응답과 Claude 분석 모두 제시

package/templates/hono/docs/git/index.md

@@ -1,180 +0,0 @@
-# Git 커밋 컨벤션
-
-> 프로젝트 Git 워크플로우 및 커밋 메시지 규칙
-
----
-
-## ⛔ 절대 금지 사항
-
-```
-❌ "Generated with Claude Code" 포함 금지
-❌ "🤖" 또는 AI 관련 이모지 포함 금지
-❌ "Co-Authored-By:" 헤더 포함 금지
-❌ AI/봇이 작성했다는 어떤 표시도 금지
-❌ 커밋 메시지 여러 줄 작성 금지
-❌ 커밋 메시지에 이모지 사용 금지
-```
-
----
-
-## 커밋 메시지 형식
-
-### 기본 형식
-
-```
-<prefix>: <설명>
-```
-
-- **한 줄만 작성**
-- **본문 없음**
-- **마침표 없음**
-- **이모지 없음**
-
-### Prefix 목록
-
-| Prefix | 용도 | 예시 |
-|--------|------|------|
-| `feat` | 새 기능 | `feat: 사용자 인증 API 추가` |
-| `fix` | 버그 수정 | `fix: JWT 토큰 검증 오류 수정` |
-| `refactor` | 리팩토링 | `refactor: 사용자 서비스 구조 개선` |
-| `style` | 코드 스타일 | `style: prettier 적용` |
-| `docs` | 문서 | `docs: API 문서 업데이트` |
-| `test` | 테스트 | `test: 인증 미들웨어 테스트 추가` |
-| `chore` | 기타 작업 | `chore: 의존성 업데이트` |
-| `perf` | 성능 개선 | `perf: 쿼리 최적화` |
-| `ci` | CI/CD | `ci: GitHub Actions 설정` |
-
----
-
-## 좋은 예시 vs 나쁜 예시
-
-### ✅ 좋은 예시
-
-```bash
-feat: 사용자 로그인 API 추가
-fix: 세션 만료 오류 수정
-docs: README 업데이트
-refactor: 인증 미들웨어 분리
-test: 사용자 CRUD 테스트 추가
-```
-
-### ❌ 나쁜 예시
-
-```bash
-# 이모지 사용
-🚀 feat: 새 기능 추가
-
-# 여러 줄
-feat: 새 기능 추가
-
-상세 설명...
-
-# AI 표시
-feat: 로그인 기능 추가
-
-Generated with Claude Code
-
-# Co-Authored-By 포함
-feat: 기능 추가
-
-Co-Authored-By: Claude <noreply@anthropic.com>
-
-# 마침표 사용
-feat: 새 기능 추가.
-
-# 모호한 설명
-fix: 버그 수정
-chore: 업데이트
-```
-
----
-
-## 커밋 명령어
-
-### 기본 커밋
-
-```bash
-git add .
-git commit -m "feat: 사용자 인증 API 추가"
-```
-
-### 파일 지정 커밋
-
-```bash
-git add src/routes/users.ts src/validators/user.ts
-git commit -m "feat: 사용자 CRUD API 구현"
-```
-
----
-
-## 브랜치 전략
-
-### 브랜치 네이밍
-
-```
-feature/<기능명>
-fix/<버그명>
-refactor/<대상>
-docs/<문서명>
-```
-
-### 예시
-
-```bash
-git checkout -b feature/user-auth
-git checkout -b fix/jwt-validation
-git checkout -b refactor/middleware-structure
-git checkout -b docs/api-reference
-```
-
----
-
-## 워크플로우
-
-### 1. 브랜치 생성
-
-```bash
-git checkout -b feature/new-feature
-```
-
-### 2. 작업 및 커밋
-
-```bash
-# 작업 진행
-git add .
-git commit -m "feat: 새 기능 구현"
-```
-
-### 3. 푸시
-
-```bash
-git push origin feature/new-feature
-```
-
-### 4. PR 생성
-
-```bash
-# GitHub에서 PR 생성
-# 또는 gh CLI 사용
-gh pr create --title "feat: 새 기능 추가" --body "설명"
-```
-
----
-
-## 커밋 전 체크리스트
-
-```
-□ 커밋 메시지가 한 줄인가?
-□ 적절한 prefix를 사용했는가?
-□ 이모지가 없는가?
-□ AI 관련 표시가 없는가?
-□ Co-Authored-By가 없는가?
-□ 마침표가 없는가?
-□ 설명이 명확한가?
-```
-
----
-
-## 관련 문서
-
-- [CLAUDE.md](../../CLAUDE.md)