npm - @kood/claude-code - Versions diffs - 0.1.6 → 0.1.7 - Mend

@kood/claude-code 0.1.6 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (75) hide show

package/templates/hono/docs/mcp/serena.md DELETED Viewed

@@ -1,269 +0,0 @@
-# Serena MCP Server
-> **Purpose**: 시맨틱 코드 이해, 프로젝트 메모리, 세션 지속성을 위한 MCP 서버
----
-## 프로젝트 시작 전 필수 확인
-프로젝트 작업을 시작하기 전에 **반드시** Serena가 활성화되어 있는지 확인해야 합니다.
-### 1. 현재 설정 확인
-```
-mcp__serena__get_current_config
-```
-**확인 사항:**
-- `Active project`: 현재 작업할 프로젝트명이 표시되는지 확인
-- 프로젝트가 `Available projects` 목록에 있는지 확인
-### 2. 프로젝트 활성화
-프로젝트가 활성화되지 않은 경우:
-```
-mcp__serena__activate_project({ project: "프로젝트명" })
-```
-### 3. 온보딩 확인
-새 프로젝트의 경우 온보딩이 필요할 수 있습니다:
-```
-mcp__serena__check_onboarding_performed
-```
-온보딩이 필요한 경우:
-```
-mcp__serena__onboarding
-```
----
-## 핵심 기능
-### 심볼 탐색 (Symbol Navigation)
-파일 내 심볼(클래스, 함수, 변수 등) 개요 확인:
-```
-mcp__serena__get_symbols_overview({ relative_path: "src/index.ts" })
-```
-특정 심볼 검색:
-```
-mcp__serena__find_symbol({
-  name_path_pattern: "MyClass/myMethod",
-  include_body: true,
-  depth: 1
-})
-```
-심볼 참조 찾기:
-```
-mcp__serena__find_referencing_symbols({
-  name_path: "MyClass",
-  relative_path: "src/my-class.ts"
-})
-```
-### 코드 수정 (Code Modification)
-심볼 본문 교체:
-```
-mcp__serena__replace_symbol_body({
-  name_path: "MyClass/myMethod",
-  relative_path: "src/my-class.ts",
-  body: "새로운 코드 본문"
-})
-```
-심볼 뒤에 코드 삽입:
-```
-mcp__serena__insert_after_symbol({
-  name_path: "MyClass",
-  relative_path: "src/my-class.ts",
-  body: "\n\nexport const newFunction = () => {}"
-})
-```
-심볼 앞에 코드 삽입:
-```
-mcp__serena__insert_before_symbol({
-  name_path: "MyClass",
-  relative_path: "src/my-class.ts",
-  body: "import { Something } from './something'\n\n"
-})
-```
-심볼 이름 변경 (전체 코드베이스):
-```
-mcp__serena__rename_symbol({
-  name_path: "oldFunctionName",
-  relative_path: "src/utils.ts",
-  new_name: "newFunctionName"
-})
-```
-### 파일 탐색 (File Navigation)
-디렉토리 목록:
-```
-mcp__serena__list_dir({
-  relative_path: "src",
-  recursive: false
-})
-```
-파일 검색:
-```
-mcp__serena__find_file({
-  file_mask: "*.ts",
-  relative_path: "src"
-})
-```
-패턴 검색:
-```
-mcp__serena__search_for_pattern({
-  substring_pattern: "createServerFn",
-  relative_path: "src/services",
-  context_lines_before: 2,
-  context_lines_after: 2
-})
-```
-### 메모리 관리 (Memory Management)
-프로젝트 관련 정보를 메모리에 저장하여 세션 간 유지:
-메모리 목록 확인:
-```
-mcp__serena__list_memories
-```
-메모리 읽기:
-```
-mcp__serena__read_memory({ memory_file_name: "architecture.md" })
-```
-메모리 작성:
-```
-mcp__serena__write_memory({
-  memory_file_name: "decisions.md",
-  content: "# 주요 결정 사항\n\n- API 설계: REST 대신 Server Functions 사용"
-})
-```
-메모리 수정:
-```
-mcp__serena__edit_memory({
-  memory_file_name: "decisions.md",
-  needle: "REST 대신",
-  repl: "REST API 대신",
-  mode: "literal"
-})
-```
-메모리 삭제:
-```
-mcp__serena__delete_memory({ memory_file_name: "outdated.md" })
-```
-### 사고 도구 (Thinking Tools)
-수집된 정보 검토:
-```
-mcp__serena__think_about_collected_information
-```
-작업 목표 준수 확인:
-```
-mcp__serena__think_about_task_adherence
-```
-작업 완료 여부 확인:
-```
-mcp__serena__think_about_whether_you_are_done
-```
----
-## 사용 시나리오
-### 시나리오 1: 새 프로젝트 시작
-```
-1. get_current_config → 현재 상태 확인
-2. activate_project → 프로젝트 활성화
-3. check_onboarding_performed → 온보딩 필요 여부 확인
-4. onboarding → 필요시 온보딩 진행
-5. list_memories → 기존 메모리 확인
-```
-### 시나리오 2: 기존 프로젝트 재개
-```
-1. get_current_config → 프로젝트 활성화 확인
-2. list_memories → 이전 세션 컨텍스트 확인
-3. read_memory → 필요한 메모리 읽기
-4. 작업 진행
-5. write_memory → 중요 결정/진행 상황 저장
-```
-### 시나리오 3: 대규모 리팩토링
-```
-1. get_symbols_overview → 파일 구조 파악
-2. find_symbol → 수정할 심볼 찾기
-3. find_referencing_symbols → 영향받는 코드 확인
-4. replace_symbol_body → 심볼 수정
-5. rename_symbol → 필요시 이름 변경
-6. think_about_whether_you_are_done → 완료 확인
-```
----
-## Best Practices
-### 1. 항상 프로젝트 활성화 확인
-작업 시작 전 `get_current_config`로 올바른 프로젝트가 활성화되어 있는지 확인하세요.
-### 2. 심볼 도구 우선 사용
-전체 파일을 읽지 말고, `get_symbols_overview`와 `find_symbol`을 사용하여 필요한 부분만 확인하세요.
-### 3. 메모리 적극 활용
-중요한 결정, 아키텍처 정보, 작업 진행 상황을 메모리에 저장하여 세션 간 컨텍스트를 유지하세요.
-### 4. 사고 도구 활용
-복잡한 작업 중에는 `think_about_*` 도구를 사용하여 진행 상황을 검토하세요.
----
-## 참고 자료
-- [Serena GitHub](https://github.com/oraios/serena)
-- [MCP Protocol](https://modelcontextprotocol.io)

package/templates/hono/docs/mcp/sgrep.md DELETED Viewed

@@ -1,105 +0,0 @@
-# sgrep - Semantic Grep
-> AST 기반 시맨틱 코드 검색 도구
----
-## ⛔ 필수 규칙
-```
-❌ grep, rg 등 기본 검색 도구 사용 금지
-❌ find 명령어로 코드 검색 금지
-✅ 코드베이스 검색 시 sgrep 사용 필수
-```
----
-## 개요
-sgrep는 단순 텍스트 매칭이 아닌 AST(Abstract Syntax Tree) 기반의 시맨틱 검색을 수행합니다.
-### grep vs sgrep
-| 기능 | grep | sgrep |
-|------|------|-------|
-| 검색 방식 | 텍스트 매칭 | AST 기반 |
-| 코드 구조 인식 | ❌ | ✅ |
-| 언어별 최적화 | ❌ | ✅ |
-| False positive | 많음 | 적음 |
----
-## 사용 시점
-### ✅ sgrep 사용
-- 함수 정의 찾기
-- 클래스 사용처 검색
-- 특정 패턴의 코드 찾기
-- import 문 검색
-- API 엔드포인트 검색
-### 예시 상황
-```
-"prisma.user.create 사용처를 찾아줘" → sgrep 사용
-"authMiddleware가 어디서 쓰이는지 찾아줘" → sgrep 사용
-"HTTPException을 throw하는 곳을 찾아줘" → sgrep 사용
-```
----
-## 장점
-### 1. 정확한 코드 구조 인식
-```typescript
-// 주석 안의 function은 무시
-// function test() {}
-// 실제 함수만 찾음
-function test() {}
-```
-### 2. 언어별 최적화
-- TypeScript/JavaScript
-- Python
-- Go
-- 기타 주요 언어
-### 3. 패턴 매칭
-- 함수 호출 패턴
-- 클래스 정의 패턴
-- import/export 패턴
----
-## 설치
-### Claude Code Plugin 설치 (권장)
-```bash
-# Plugin 추가
-/plugin marketplace add rika-labs/sgrep
-# 설치
-/plugin install sgrep
-```
-### 사용법
-```bash
-# 인증 처리 코드 찾기
-sgrep search for where we handle authentication
-# API 엔드포인트 검색
-sgrep search API routes definition
-# 에러 핸들링 패턴
-sgrep search error handling with HTTPException
-```
----
-## 관련 문서
-- [MCP 개요](./index.md)
-- [Sequential Thinking](./sequential-thinking.md)
-- [Context7](./context7.md)

package/templates/hono/docs/skills/gemini-review/SKILL.md DELETED Viewed

@@ -1,220 +0,0 @@
----
-name: gemini-review
-description: Google Gemini CLI를 활용한 코드 리뷰 및 계획 검증 스킬. 구현 계획 검토, 코드 리뷰, 아키텍처 논의 시 Gemini를 세컨드 오피니언으로 활용. Hono, Cloudflare Workers 등 특화 체크리스트 지원. gemini-2.5-pro 모델 사용 (무료: 60req/min, 1000req/day).
----
-# Gemini 리뷰 스킬
-## 개요
-Claude가 컨텍스트를 준비하고 Gemini가 독립적인 검증을 제공하는 듀얼 AI 리뷰 워크플로우. 결과는 항상 Gemini 원본 응답과 Claude의 종합 액션 플랜 두 섹션으로 제공.
-**모델**: `gemini-2.5-pro` (고정)
-**비용**: 무료 티어 (60 req/min, 1000 req/day)
-## 사용 시점
-- 코딩 전 구현 계획 검증
-- 완성된 코드의 버그, 보안, 베스트 프랙티스 리뷰
-- 아키텍처 결정에 대한 세컨드 AI 의견
-- Hono, Cloudflare Workers 프로젝트 특화 피드백
-## 워크플로우 타입
-| 타입 | 목적 | 사용 시점 |
-|------|------|-----------|
-| **plan** | 구현 계획 검증 | 개발 시작 전 |
-| **code** | 완성 코드 리뷰 | 기능 구현 후 |
-| **architecture** | 시스템 설계 논의 | 설계 단계 또는 리팩토링 시 |
-## 실행 프로세스
-### Step 1: 사용자 컨텍스트 수집
-실행 전 수집할 정보:
-1. **리뷰 타입**: `plan`, `code`, `architecture`
-2. **기술 스택** (선택): `hono`, `cloudflare`, `general`
-3. **리뷰 대상**: 실제 계획, 코드, 아키텍처 설명
-### Step 2: 체크리스트 로드
-기술 스택에 따라 `references/checklists.md`에서 해당 체크리스트 로드:
-- **Hono**: API 설계, 미들웨어 패턴, 유효성 검사, 에러 처리
-- **Cloudflare**: Workers, KV, D1, R2, 엣지 런타임 고려사항
-- **General**: 범용 베스트 프랙티스
-### Step 3: Gemini 명령어 구성 및 실행
-`references/prompt-templates.md`에서 적절한 프롬프트 템플릿 로드 후 실행:
-**인라인 프롬프트:**
-```bash
-gemini -m gemini-2.5-pro -p "{constructed_prompt}" --output-format json
-```
-**파일 내용 리뷰:**
-```bash
-cat {file_path} | gemini -m gemini-2.5-pro -p "{review_instructions}" --output-format json
-```
-**멀티라인 프롬프트 (heredoc):**
-```bash
-gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
-{constructed_prompt}
-EOF
-)"
-```
-### Step 4: JSON 응답 파싱
-Gemini 응답 구조:
-```json
-{
-  "response": "실제 리뷰 내용",
-  "stats": {
-    "models": { ... },
-    "tools": { ... }
-  }
-}
-```
-`response` 필드에서 리뷰 내용 추출. `jq` 사용:
-```bash
-result=$(gemini -m gemini-2.5-pro -p "..." --output-format json)
-echo "$result" | jq -r '.response'
-```
-### Step 5: 결과를 두 섹션으로 제시
-**중요**: 항상 두 개의 명확히 구분된 섹션으로 결과 제시:
-#### 섹션 A: Gemini 원본 응답
-Gemini의 완전한 응답을 수정 없이 제시. 사용자에게 Gemini가 발견한 내용을 그대로 보여줌.
-#### 섹션 B: Claude 분석 및 액션 플랜
-Gemini 피드백을 기반으로 Claude가 제공:
-1. **요약** (2-3문장)
-   - 핵심 발견 사항
-   - 전체 평가
-2. **액션 아이템** (우선순위 목록)
-   - 🔴 심각: 진행 전 반드시 수정
-   - 🟡 중요: 조속히 해결 필요
-   - 🟢 경미: 개선하면 좋음
-3. **바로 적용 가능한 코드** (해당 시)
-   - 각 이슈에 대한 실제 코드 수정안
-   - 필요 시 before/after 비교 포함
-## 출력 형식 템플릿
-```markdown
----
-## 📋 Gemini 리뷰 결과
-### A. Gemini 응답 (원본)
-{gemini_response_verbatim}
----
-### B. Claude 분석
-#### 요약
-{2-3문장 개요}
-#### 액션 아이템
-🔴 **심각**
-- 이슈: {설명}
-- 수정: {해결책}
-🟡 **중요**
-- 이슈: {설명}
-- 수정: {해결책}
-🟢 **경미**
-- 이슈: {설명}
-- 수정: {해결책}
-#### 바로 적용 가능한 코드
-**{이슈명}**
-```{language}
-{fixed_code}
-```
----
-```
-## 명령어 예시
-### 계획 리뷰
-```bash
-gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
-[계획 리뷰 요청]
-이 구현 계획의 완전성과 잠재적 문제를 검토해주세요:
-{plan_content}
-확인 사항: 로직 오류, 누락된 엣지 케이스, 아키텍처 결함, 보안 우려.
-구체적이고 실행 가능한 피드백을 제공해주세요.
-EOF
-)"
-```
-### 코드 리뷰 (파일 파이핑)
-```bash
-cat src/routes/auth.ts | gemini -m gemini-2.5-pro -p "이 Hono 인증 코드를 보안 이슈, 버그, 베스트 프랙티스 관점에서 리뷰해주세요. 구체적인 라인별 피드백을 제공해주세요." --output-format json
-```
-### 아키텍처 리뷰
-```bash
-gemini -m gemini-2.5-pro --output-format json -p "$(cat << 'EOF'
-[아키텍처 리뷰]
-시스템: {system_name}
-기술 스택: Hono + Cloudflare Workers + D1
-{architecture_description}
-평가 항목: 확장성, 신뢰성, 유지보수성, 보안, 비용 효율성.
-트레이드오프 분석과 함께 개선안을 제시해주세요.
-EOF
-)"
-```
-## 환경 호환성
-| 환경 | 실행 방법 |
-|------|-----------|
-| Claude Code | 직접 bash 실행 |
-| Claude (Web/Desktop) | `bash_tool` 사용 |
-명령어 문법은 모든 환경에서 동일.
-## 에러 처리
-Gemini 에러 발생 시:
-1. 사용자에게 에러 메시지 표시
-2. 일반적인 문제 확인:
-   - 할당량 초과 (60/min 또는 1000/day 한도)
-   - 네트워크 연결
-   - 잘못된 프롬프트 형식
-3. 재시도 또는 대안 제안
-## 할당량 관리
-무료 티어 한도:
-- 분당 60 요청
-- 일당 1000 요청
-할당량 절약:
-- 관련 리뷰를 단일 프롬프트로 결합
-- 구체적이고 집중된 리뷰 요청 사용
-- 중복 리뷰 회피
-## 참조 파일
-- `references/checklists.md`: 기술 스택별 리뷰 체크리스트
-- `references/prompt-templates.md`: 리뷰 타입별 프롬프트 템플릿

package/templates/hono/docs/skills/gemini-review/references/checklists.md DELETED Viewed

@@ -1,136 +0,0 @@
-# 기술 스택별 리뷰 체크리스트
-## Hono 체크리스트
-### API 설계
-- [ ] RESTful 규칙 준수 (적절한 HTTP 메서드, 상태 코드)
-- [ ] 일관된 URL 명명 (kebab-case, 복수형 명사)
-- [ ] path vs query 파라미터 적절한 사용
-- [ ] 응답 형식 일관성 (c.json, c.text, c.html)
-- [ ] c.notFound() 및 에러 응답의 적절한 사용
-### 미들웨어
-- [ ] 미들웨어 순서가 올바름 (인증이 라우트 핸들러 전에)
-- [ ] 타입드 미들웨어에 createMiddleware 사용
-- [ ] 미들웨어가 next()로 제어를 올바르게 전달
-- [ ] 빌트인 미들웨어 적절히 설정 (cors, logger 등)
-- [ ] 커스텀 미들웨어가 재사용 가능하고 테스트 가능
-### 유효성 검사 (zValidator)
-- [ ] 모든 POST/PUT/PATCH 라우트에 zValidator 적용
-- [ ] 유효성 검사 대상 올바름: json, query, param, header, form
-- [ ] Zod v4 문법 사용 (z.email(), z.url())
-- [ ] zValidator 콜백에서 커스텀 에러 처리
-- [ ] 관련 엔드포인트 간 스키마 재사용
-### 에러 처리
-- [ ] HTTP 에러에 HTTPException 사용
-- [ ] 전역 onError 핸들러 설정
-- [ ] 일관된 에러 응답 형식
-- [ ] 에러에 민감 정보 노출 없음
-- [ ] 비즈니스 로직 에러용 커스텀 에러 클래스
-### 타입 안전성
-- [ ] 환경 변수용 Bindings 타입 정의
-- [ ] 요청 컨텍스트용 Variables 타입 정의
-- [ ] c.env와 c.var 적절히 타입 지정
-- [ ] RPC 타입 내보내기 (AppType)
-- [ ] 클라이언트에서 InferRequestType/InferResponseType 사용
-### 보안
-- [ ] 보호된 라우트에 인증 미들웨어 적용
-- [ ] Bearer 토큰 또는 JWT 검증 구현
-- [ ] CORS 적절히 설정
-- [ ] 레이트 리미팅 고려
-- [ ] 시크릿은 c.env로 접근, 하드코딩 금지
----
-## Cloudflare Workers 체크리스트
-### 바인딩 설정
-- [ ] wrangler.toml 적절히 설정
-- [ ] 모든 바인딩 선언 (KV, D1, R2 등)
-- [ ] 바인딩 타입이 wrangler.toml과 일치
-- [ ] 시크릿용 환경 변수 설정
-- [ ] 필요 시 compatibility_flags에 nodejs_compat 포함
-### KV Namespace
-- [ ] 키가 적절히 네임스페이스됨
-- [ ] 적절한 곳에 TTL (expirationTtl) 설정
-- [ ] 추가 키 정보에 메타데이터 사용
-- [ ] List 작업에 prefix와 cursor로 페이지네이션
-- [ ] KV 작업에 에러 처리
-### D1 데이터베이스
-- [ ] Prepared statements 사용 (문자열 연결 금지)
-- [ ] 여러 쿼리에 배치 작업 사용
-- [ ] 데이터베이스 작업에 에러 처리
-- [ ] 스키마 마이그레이션 적절히 관리
-- [ ] 자주 쿼리되는 컬럼에 인덱스 생성
-### R2 Bucket
-- [ ] 업로드 시 Content-Type 설정
-- [ ] 누락된 객체에 대한 적절한 에러 처리
-- [ ] 대용량 파일에 멀티파트 업로드
-- [ ] 커스텀 메타데이터 적절히 사용
-- [ ] 액세스 제어 설정
-### 엣지 런타임
-- [ ] Node.js 전용 API 사용 안 함
-- [ ] 웹 API 사용 (fetch, Request, Response)
-- [ ] 메모리 한도 고려 (<128MB)
-- [ ] CPU 시간 한도 고려 (<30s)
-- [ ] 서브리퀘스트 한도 고려 (<50)
-### 배포
-- [ ] 환경별 wrangler.toml 섹션
-- [ ] wrangler secret put으로 시크릿 설정
-- [ ] 프리뷰 배포 작동 확인
-- [ ] 프로덕션 배포 테스트
-- [ ] 롤백 전략 마련
----
-## 범용 체크리스트
-### 코드 품질
-- [ ] 단일 책임 원칙 준수
-- [ ] DRY - 불필요한 중복 없음
-- [ ] 함수/메서드가 집중적이고 작음
-- [ ] 명확한 명명 규칙
-- [ ] 주석은 "why"를 설명, "what"이 아님
-### 로직 및 정확성
-- [ ] 엣지 케이스 처리 (빈 값, null, 경계값)
-- [ ] 포괄적인 에러 처리
-- [ ] 레이스 컨디션 고려
-- [ ] 입력 유효성 검사
-- [ ] 반환값 확인
-### 보안
-- [ ] 하드코딩된 시크릿 없음
-- [ ] 사용자 입력 살균
-- [ ] SQL 인젝션 방지 (파라미터화된 쿼리)
-- [ ] XSS 방지 조치
-- [ ] 적절한 인증/인가
-### 성능
-- [ ] 스케일에 적합한 시간 복잡도
-- [ ] 적절한 공간 복잡도
-- [ ] 불필요한 반복 없음
-- [ ] 데이터베이스 쿼리 최적화
-- [ ] 적절한 캐싱 고려
-### 유지보수성
-- [ ] 테스트 가능한 코드
-- [ ] 최소한의 정당화된 의존성
-- [ ] 설정 외부화
-- [ ] 디버깅을 위한 로깅
-- [ ] 도움이 되는 에러 메시지
-### 문서화
-- [ ] 공개 API 문서화
-- [ ] 복잡한 로직 설명
-- [ ] 명확한 설정 가이드
-- [ ] 환경 변수 문서화