@kood/claude-code 0.6.6 → 0.6.7

package/dist/index.js

@@ -118,6 +118,11 @@ var templateMetadata = {
     name: "NPX CLI",
     description: "NPX\uB85C \uC2E4\uD589 \uAC00\uB2A5\uD55C CLI \uB3C4\uAD6C \uD504\uB85C\uC81D\uD2B8",
     stack: "Node.js, TypeScript, Commander.js"
+  },
+  tauri: {
+    name: "Tauri",
+    description: "Cross-platform Desktop & Mobile \uC571 \uD504\uB85C\uC81D\uD2B8",
+    stack: "Rust, React, TypeScript, Vite"
   }
 };
 var generateIndexClaudeMd = (templates) => {
@@ -754,7 +759,8 @@ async function updateGitignore(targetDir) {
 var TEMPLATE_DESCRIPTIONS = {
   "tanstack-start": "TanStack Start + React \uD480\uC2A4\uD0DD \uD504\uB85C\uC81D\uD2B8",
   hono: "Hono \uC11C\uBC84 \uD504\uB808\uC784\uC6CC\uD06C \uD504\uB85C\uC81D\uD2B8",
-  npx: "NPX CLI \uB3C4\uAD6C \uD504\uB85C\uC81D\uD2B8"
+  npx: "NPX CLI \uB3C4\uAD6C \uD504\uB85C\uC81D\uD2B8",
+  tauri: "Tauri \uB370\uC2A4\uD06C\uD1B1/\uBAA8\uBC14\uC77C \uD06C\uB85C\uC2A4\uD50C\uB7AB\uD3FC \uC571"
 };
 async function validateTargetDirectory(targetDir) {
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kood/claude-code",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/.claude/agents/researcher.md

@@ -61,7 +61,7 @@ permissionMode: default
 |------|------|------|
 | **1. 분석** | 질문 분해, 키워드 추출, 버전 확인 | - |
 | **2. 검색** | 공식 문서 → GitHub → Stack Overflow | WebSearch |
-| **3. 수집** | 관련 페이지 내용 읽기 | WebFetch |
+| **3. 수집** | 관련 페이지 내용 읽기 (JS 렌더링 필요 시 `r.jina.ai` 폴백) | WebFetch |
 | **4. 검증** | 버전 일치 확인, 교차 검증 | - |
 | **5. 종합** | 핵심 요약 + 상세 내용 + 출처 | - |
 
@@ -78,6 +78,13 @@ permissionMode: default
 "[라이브러리명] migration guide v[버전]"
 ```
 
+## Jina Reader (JS 렌더링 / WebFetch 실패 시 폴백)
+```
+WebFetch('https://r.jina.ai/{공식문서URL}', '{추출할 내용}')
+→ JS 렌더링 지원, 광고/네비 제거, 클린 마크다운 변환
+→ WebFetch로 빈 결과 시 Jina Reader 시도
+```
+
 ## GitHub
 ```
 "site:github.com [org]/[repo] [키워드]"

package/templates/.claude/instructions/sourcing/reliable-search.md

@@ -298,6 +298,7 @@ WebSearch({ query: "AI agent frameworks comparison" })
 | **WebSearch** | 연도 포함, 영어+한국어 병렬 |
 | **SearXNG** | `time_range=year` + 연도 키워드 |
 | **Firecrawl** | 공식 문서 URL 직접 지정 |
+| **Jina Reader** | `WebFetch('https://r.jina.ai/{URL}')` — JS 렌더링 클린 MD 변환 |
 | **GitHub** | `created:>YYYY-01-01` 필터, stars 정렬 |
 
 ---
@@ -314,6 +315,7 @@ Tier 1 (MCP, ToolSearch로 감지):
 Tier 2 (내장, 항상 가용):
   WebSearch → 웹 검색 (연도 키워드 필수)
   WebFetch  → 페이지 직접 읽기
+  Jina Reader → WebFetch('https://r.jina.ai/{URL}') 클린 마크다운 변환
   gh CLI    → GitHub API (Bash via explore)
 
 Tier 3: Playwright → SPA/JS 렌더링 필요 시 (crawler skill)
@@ -323,10 +325,10 @@ Tier 3: Playwright → SPA/JS 렌더링 필요 시 (crawler skill)
 
 | MCP 도구 | 용도 | 미설치 시 폴백 |
 |----------|------|--------------|
-| `firecrawl_map/scrape/crawl` | 사이트 구조/페이지 수집 | WebFetch (페이지별) |
+| `firecrawl_map/scrape/crawl` | 사이트 구조/페이지 수집 | Jina Reader → WebFetch (페이지별) |
 | SearXNG `web_search` | 246+ 엔진 메타검색 | WebSearch (내장) |
 | `search_repositories/code/issues` | GitHub 리포/코드/이슈 | `gh search` (Bash) |
-| `resolve-library-id` + `query-docs` | 라이브러리 문서 조회 | WebFetch (직접) |
+| `resolve-library-id` + `query-docs` | 라이브러리 문서 조회 | Jina Reader → WebFetch (직접) |
 
 ### MCP 감지 (Phase 0 공통)
 
@@ -339,6 +341,51 @@ ToolSearch("context7")  → Context7 활성화
 
 ---
 
+## Jina Reader (`r.jina.ai`)
+
+**용도:** URL → 클린 마크다운 변환 (JS 렌더링 지원, 광고/네비 제거)
+
+| 특성 | 설명 |
+|------|------|
+| **엔드포인트** | `https://r.jina.ai/{URL}` |
+| **호출 방법** | `WebFetch('https://r.jina.ai/{URL}', '{프롬프트}')` |
+| **장점** | JS 렌더링, 클린 MD, 광고/네비 자동 제거, 무료 |
+| **한계** | 검색 기능 없음 (URL 필수), 대량 크롤링 비적합 |
+
+### 활용 시나리오
+
+| 시나리오 | 사용 |
+|----------|------|
+| **WebFetch 실패** | JS 렌더링 필요 페이지 → Jina Reader 폴백 |
+| **Firecrawl 미설치** | 개별 페이지 클린 MD 변환 |
+| **공식 문서 읽기** | SPA 기반 문서 사이트 (React, Vue 등) |
+| **블로그/미디어** | 광고 제거된 본문만 추출 |
+
+### 사용 패턴
+
+```typescript
+// ✅ 기본: URL을 클린 마크다운으로 변환
+WebFetch('https://r.jina.ai/https://react.dev/reference/react/use', '핵심 API 사용법 추출')
+
+// ✅ WebFetch 실패 시 Jina 폴백
+WebFetch('https://docs.example.com/guide')  // → 빈 결과 (JS 렌더링 필요)
+WebFetch('https://r.jina.ai/https://docs.example.com/guide', '가이드 내용 추출')  // → 클린 MD
+
+// ✅ Firecrawl 미설치 시 개별 페이지 대안
+WebFetch('https://r.jina.ai/https://prisma.io/docs/orm/prisma-schema', 'Prisma 스키마 문법 추출')
+
+// ❌ 검색 용도로 사용 (검색은 WebSearch/SearXNG 사용)
+WebFetch('https://r.jina.ai/react hooks tutorial')  // 잘못된 사용
+```
+
+### 폴백 체인 (페이지 읽기)
+
+```
+Firecrawl scrape → Jina Reader → WebFetch (직접) → Playwright (최후 수단)
+```
+
+---
+
 ## 수집 후 검증
 
 | 단계 | 검증 |

package/templates/.claude/skills/docs-fetch/SKILL.md

@@ -74,8 +74,9 @@ ARGUMENT 있음 → 다음 단계 진행
 | **2** | GitHub MCP + gh CLI | README, docs/, CHANGELOG 직접 접근 |
 | **3** | Firecrawl `/map`→`/crawl` + SearXNG 검색 | 문서 일괄 수집 + breaking changes 보충 (동시 실행) |
 | **4** | Context7 MCP | 라이브러리 문서 즉시 조회, 업데이트 지연 가능성 있음 |
-| **5** | WebFetch | 개별 페이지 직접 읽기 |
-| **6** | WebSearch | 최후 보충 검색 |
+| **5** | Jina Reader | `WebFetch('https://r.jina.ai/{URL}')` JS 렌더링 클린 MD (WebFetch 실패 시) |
+| **6** | WebFetch | 개별 페이지 직접 읽기 |
+| **7** | WebSearch | 최후 보충 검색 |
 
 **Smart Tier Fallback 및 MCP 통합 전략**: @../../instructions/sourcing/reliable-search.md 참조
 
@@ -174,7 +175,7 @@ Task(subagent_type="researcher", model="haiku",
 | Tier | 경로 | 실행 |
 |------|------|------|
 | **1 (MCP)** | Firecrawl + SearXNG | `firecrawl_map` → `firecrawl_crawl` (최대 50p) + `searxng_search` 병렬 |
-| **2 (내장)** | WebFetch | llms.txt 링크 우선, 없으면 GitHub docs/ + 공식 문서 10-15p (5개씩 병렬) |
+| **2 (내장)** | Jina Reader + WebFetch | llms.txt 링크 우선, SPA 문서는 `r.jina.ai` 경유, 없으면 GitHub docs/ + 공식 문서 10-15p (5개씩 병렬) |
 
 ### 공통: Breaking Changes 추출
 
@@ -386,7 +387,7 @@ researcher(검색) ──┘
 | **Context7** | `resolve-library-id`, `get-library-docs` | 라이브러리 문서 즉시 조회 (업데이트 지연 가능) |
 | **GitHub** | `get_file_contents`, `get_latest_release` | README, docs/, CHANGELOG |
 
-**MCP 미설치** → WebFetch (페이지별) + WebSearch (내장) + `gh api` (CLI) 폴백
+**MCP 미설치** → Jina Reader (`r.jina.ai`) → WebFetch (페이지별) → WebSearch (내장) → `gh api` (CLI) 폴백
 
 </mcp_integration>
 

package/templates/.claude/skills/project-optimizer/AGENTS.md

@@ -0,0 +1,275 @@
+# Project Optimizer
+
+**Version 1.0.0**
+범용 프로젝트 최적화 가이드 (언어/프레임워크 무관)
+February 2026
+
+> **참고:**
+> 이 문서는 주로 에이전트와 LLM이 프로젝트 코드베이스를 분석, 최적화, 리팩토링할 때 따르기 위한 것입니다. 어떤 언어/프레임워크든 적용 가능한 보편적 최적화 원칙 기반.
+
+---
+
+## 요약
+
+AI 에이전트를 위한 범용 프로젝트 최적화 가이드. 8개 카테고리에 걸쳐 38개 규칙을 포함하며, 영향도별로 우선순위 매김 (critical: 동시성, 빌드 최적화 → incremental: 아키텍처). 언어/프레임워크를 자동 감지하여 해당 언어의 관용적 패턴으로 규칙 적용. 프레임워크 특화 스킬(nextjs, tanstack-start, tauri)과 자동 체이닝 지원.
+
+---
+
+<instructions>
+
+## 문서 사용 지침
+
+@rules/concurrency-parallel.md
+@rules/concurrency-defer-await.md
+@rules/concurrency-pipeline.md
+@rules/concurrency-pool.md
+@rules/build-incremental.md
+@rules/build-tree-shake.md
+@rules/build-code-split.md
+@rules/build-minify.md
+@rules/build-cache.md
+@rules/io-batch-queries.md
+@rules/io-cache-layer.md
+@rules/io-stream.md
+@rules/io-connection-reuse.md
+@rules/io-serialize-minimal.md
+@rules/memory-leak-prevention.md
+@rules/memory-pool-reuse.md
+@rules/memory-lazy-init.md
+@rules/memory-bounded-cache.md
+@rules/memory-large-data.md
+@rules/code-dead-elimination.md
+@rules/code-duplication.md
+@rules/code-complexity.md
+@rules/code-naming.md
+@rules/code-error-handling.md
+@rules/deps-unused-removal.md
+@rules/deps-security-audit.md
+@rules/deps-version-pin.md
+@rules/deps-lightweight-alt.md
+@rules/deps-peer-align.md
+@rules/dx-type-safety.md
+@rules/dx-lint-config.md
+@rules/dx-test-coverage.md
+@rules/dx-ci-speed.md
+@rules/dx-dev-server.md
+@rules/arch-module-boundary.md
+@rules/arch-interface-segregation.md
+@rules/arch-config-centralize.md
+@rules/arch-hot-path.md
+
+</instructions>
+
+---
+
+<categories>
+
+## 카테고리별 우선순위
+
+| 우선순위 | 카테고리 | 영향도 | 설명 |
+|---------|---------|--------|------|
+| 1 | 동시성/병렬화 | **CRITICAL** | 순차 I/O를 병렬로 전환. 가장 큰 성능 향상 |
+| 2 | 빌드/번들 최적화 | **CRITICAL** | 빌드 시간, 출력 크기 감소 |
+| 3 | I/O 성능 | **HIGH** | DB/네트워크/파일 I/O 효율화 |
+| 4 | 메모리/리소스 관리 | HIGH | 메모리 누수 방지, 리소스 효율 |
+| 5 | 코드 품질 | MEDIUM-HIGH | 유지보수성, 가독성, 정확성 |
+| 6 | 의존성 관리 | MEDIUM | 보안, 크기, 호환성 |
+| 7 | DX (개발자 경험) | MEDIUM | 타입 안전성, 린팅, 테스트, CI |
+| 8 | 아키텍처 | LOW-MEDIUM | 모듈 경계, 인터페이스, 설정 관리 |
+
+</categories>
+
+---
+
+<critical_patterns>
+
+## 1. 동시성/병렬화 (CRITICAL)
+
+순차 I/O는 가장 큰 성능 저해 요소. 독립 작업은 항상 동시 실행.
+
+### 병렬 실행 (다국어)
+
+| 언어 | 순차 (❌) | 병렬 (✅) |
+|------|----------|----------|
+| **JS/TS** | `await a(); await b()` | `await Promise.all([a(), b()])` |
+| **Python** | `await a(); await b()` | `await asyncio.gather(a(), b())` |
+| **Go** | `a(); b()` | `errgroup.Go(a); errgroup.Go(b)` |
+| **Rust** | `a.await; b.await` | `tokio::try_join!(a, b)` |
+| **Java** | `a.get(); b.get()` | `CompletableFuture.allOf(a, b)` |
+| **C#** | `await A(); await B()` | `await Task.WhenAll(A(), B())` |
+| **Elixir** | sequential calls | `Task.async` + `Task.await_many` |
+| **Ruby** | sequential calls | `Async { [task1, task2].map(&:wait) }` |
+
+### 커넥션 풀링
+
+| 언어 | 라이브러리 | 설정 |
+|------|-----------|------|
+| **JS/TS** | `generic-pool`, Prisma | `pool: { min: 2, max: 10 }` |
+| **Python** | `sqlalchemy`, `asyncpg` | `pool_size=10, max_overflow=20` |
+| **Go** | `database/sql` | `SetMaxOpenConns(25)` |
+| **Rust** | `deadpool`, `bb8` | `Pool::builder().max_size(16)` |
+| **Java** | HikariCP | `maximumPoolSize=10` |
+
+</critical_patterns>
+
+---
+
+<build_optimization>
+
+## 2. 빌드/번들 최적화 (CRITICAL)
+
+### 증분 빌드 설정
+
+| 도구 | 설정 |
+|------|------|
+| **TypeScript** | `"incremental": true` in tsconfig.json |
+| **Rust** | `incremental = true` in Cargo.toml `[profile.dev]` |
+| **Go** | 기본 활성화 (`go build` 캐시) |
+| **Python** | Ruff `cache-dir`, mypy `incremental` |
+| **Gradle** | `org.gradle.caching=true` |
+| **CMake** | ccache / sccache 연동 |
+
+### CI 캐시 전략
+
+| 패키지 매니저 | 캐시 대상 |
+|-------------|----------|
+| npm/yarn/pnpm | `node_modules`, `.yarn/cache` |
+| pip | `~/.cache/pip` |
+| cargo | `~/.cargo/registry`, `target/` |
+| go | `~/go/pkg/mod`, `~/.cache/go-build` |
+| gradle | `~/.gradle/caches` |
+
+</build_optimization>
+
+---
+
+<io_performance>
+
+## 3. I/O 성능 (HIGH)
+
+### N+1 쿼리 패턴 제거
+
+```
+❌ N+1: 목록 1쿼리 + 각 항목 N쿼리 = N+1 쿼리
+✅ 배치: 목록 1쿼리 + IN절 1쿼리 = 2쿼리
+✅ 조인: 1쿼리로 전체 해결
+```
+
+| ORM | N+1 해결 방법 |
+|-----|-------------|
+| **Prisma** | `include: { relation: true }` |
+| **SQLAlchemy** | `joinedload()`, `selectinload()` |
+| **GORM** | `Preload("Relation")` |
+| **ActiveRecord** | `includes(:relation)` |
+| **Hibernate** | `@EntityGraph`, `JOIN FETCH` |
+| **Diesel** | `belonging_to().load()` |
+
+### 캐시 레이어
+
+```
+요청 → L1 (인메모리, <1ms) → L2 (Redis, <5ms) → L3 (DB, ~50ms)
+         ↑ 캐시 히트          ↑ 캐시 히트        ↑ 캐시 미스
+```
+
+</io_performance>
+
+---
+
+<memory_management>
+
+## 4. 메모리/리소스 관리 (HIGH)
+
+### 리소스 해제 패턴
+
+| 언어 | 패턴 |
+|------|------|
+| **Python** | `with` (context manager) |
+| **Go** | `defer resource.Close()` |
+| **Rust** | RAII (Drop trait, 자동 해제) |
+| **Java** | try-with-resources |
+| **C#** | `using` statement |
+| **JS/TS** | `try/finally`, `using` (TC39 Stage 3) |
+| **C++** | RAII, `std::unique_ptr` |
+
+### 대용량 데이터 처리
+
+```
+❌ 전체 로드: loadAll() → 메모리 폭발
+✅ 스트리밍: stream/iterator/generator → 일정 메모리
+✅ 페이지네이션: page(offset, limit) → 제한된 메모리
+```
+
+</memory_management>
+
+---
+
+<code_quality>
+
+## 5. 코드 품질 (MEDIUM-HIGH)
+
+### 복잡도 감소 패턴
+
+| 패턴 | 효과 |
+|------|------|
+| **Early return** | 중첩 깊이 -2~3단계 |
+| **Guard clause** | 예외 조건 상단 배치 |
+| **Extract method** | 단일 책임 분리 |
+| **Replace conditional with polymorphism** | if-else 체인 제거 |
+| **Table-driven** | switch/case → 맵/딕셔너리 |
+
+### 에러 처리 일관성
+
+| 언어 | 권장 패턴 |
+|------|----------|
+| **Go** | `(value, error)` 튜플, sentinel errors |
+| **Rust** | `Result<T, E>`, `?` 연산자 |
+| **Python** | 커스텀 Exception 계층, `raise from` |
+| **JS/TS** | 커스텀 Error 클래스, Result 패턴 |
+| **Java** | checked exception 최소화, unchecked 선호 |
+
+</code_quality>
+
+---
+
+<dependency_management>
+
+## 6. 의존성 관리 (MEDIUM)
+
+### 미사용 의존성 감지 도구
+
+| 언어 | 도구 |
+|------|------|
+| **JS/TS** | `depcheck`, `knip` |
+| **Python** | `pip-autoremove`, `deptry` |
+| **Go** | `go mod tidy` (내장) |
+| **Rust** | `cargo-udeps` |
+| **Java** | `gradle-dependency-analysis` |
+
+### 보안 취약점 스캔
+
+| 언어 | 도구 |
+|------|------|
+| **JS/TS** | `npm audit`, `yarn audit`, `snyk` |
+| **Python** | `pip-audit`, `safety` |
+| **Go** | `govulncheck` |
+| **Rust** | `cargo-audit` |
+| **범용** | `trivy`, `grype`, Dependabot |
+
+</dependency_management>
+
+---
+
+<references>
+
+## 참고 자료
+
+### 범용
+1. [Google Engineering Practices](https://google.github.io/eng-practices/)
+2. [The Twelve-Factor App](https://12factor.net/)
+
+### 언어별
+3. [Effective Go](https://go.dev/doc/effective_go)
+4. [Rust Performance Book](https://nnethercote.github.io/perf-book/)
+5. [Node.js Best Practices](https://github.com/goldbergyoni/nodebestpractices)
+
+</references>