@kood/claude-code 0.1.6 → 0.1.9

package/templates/tanstack-start/docs/library/tanstack-query/setup.md

@@ -1,107 +0,0 @@
-# TanStack Query - 설치 및 설정
-
-> **상위 문서**: [TanStack Query](./index.md)
-
-## 설치
-
-```bash
-yarn add @tanstack/react-query
-```
-
-## QueryClient 설정
-
-```tsx
-import {
-  QueryClient,
-  QueryClientProvider,
-} from '@tanstack/react-query'
-
-// QueryClient 생성
-const queryClient = new QueryClient()
-
-function App() {
-  return (
-    <QueryClientProvider client={queryClient}>
-      <YourApp />
-    </QueryClientProvider>
-  )
-}
-```
-
-## QueryClient 옵션
-
-```tsx
-const queryClient = new QueryClient({
-  defaultOptions: {
-    queries: {
-      staleTime: 1000 * 60 * 5, // 5분
-      gcTime: 1000 * 60 * 30, // 30분 (이전의 cacheTime)
-      retry: 3,
-      retryDelay: (attemptIndex) => Math.min(1000 * 2 ** attemptIndex, 30000),
-      refetchOnWindowFocus: true,
-      refetchOnReconnect: true,
-    },
-    mutations: {
-      retry: 1,
-    },
-  },
-})
-```
-
-## TanStack Start와 함께 사용
-
-```tsx
-import { useQuery } from '@tanstack/react-query'
-import { getServerPosts } from '@/lib/server-functions'
-
-function PostList() {
-  const { data, isLoading, error } = useQuery({
-    queryKey: ['posts'],
-    queryFn: () => getServerPosts(),
-  })
-
-  if (isLoading) return <div>Loading...</div>
-  if (error) return <div>Error: {error.message}</div>
-
-  return (
-    <ul>
-      {data?.map((post) => (
-        <li key={post.id}>{post.title}</li>
-      ))}
-    </ul>
-  )
-}
-```
-
-## Query Keys 패턴
-
-```typescript
-// 간단한 키
-['todos']
-
-// 파라미터가 있는 키
-['todo', { id: 5 }]
-
-// 계층적 키
-['todos', 'list', { filters: 'all' }]
-['todos', 'detail', todoId]
-```
-
-## DevTools (개발용)
-
-```bash
-yarn add @tanstack/react-query-devtools
-```
-
-```tsx
-import { ReactQueryDevtools } from '@tanstack/react-query-devtools'
-
-function App() {
-  return (
-    <QueryClientProvider client={queryClient}>
-      <YourApp />
-      <ReactQueryDevtools initialIsOpen={false} />
-    </QueryClientProvider>
-  )
-}
-```

package/templates/tanstack-start/docs/library/zod/basic-types.md

@@ -1,186 +0,0 @@
-# Zod - 기본 타입
-
-> **상위 문서**: [Zod](./index.md)
-
-## 문자열
-
-```typescript
-z.string()
-z.string().min(1)          // 최소 길이
-z.string().max(100)        // 최대 길이
-z.string().length(5)       // 정확한 길이
-z.string().regex(/^\d+$/)  // 정규식
-z.string().trim()          // 공백 제거
-z.string().toLowerCase()   // 소문자 변환
-z.string().toUpperCase()   // 대문자 변환
-```
-
-### v4 새로운 최상위 문자열 포맷 API
-
-```typescript
-// 더 나은 tree-shaking을 위해 최상위 API 사용 권장
-z.email()           // 이메일 형식
-z.url()             // URL 형식
-z.uuid()            // UUID 형식
-z.base64()          // Base64 형식
-z.base64url()       // Base64 URL 형식
-z.nanoid()          // NanoID 형식
-z.cuid()            // CUID 형식
-z.cuid2()           // CUID2 형식
-z.ulid()            // ULID 형식
-z.emoji()           // 이모지 (단일 문자)
-z.ipv4()            // IPv4 주소
-z.ipv6()            // IPv6 주소
-z.cidrv4()          // IPv4 범위
-z.cidrv6()          // IPv6 범위
-
-// ISO 날짜/시간 형식
-z.iso.date()        // ISO 날짜 (2024-01-15)
-z.iso.time()        // ISO 시간 (14:30:00)
-z.iso.datetime()    // ISO 날짜시간
-z.iso.duration()    // ISO 기간 (P1D, PT1H)
-```
-
-### 템플릿 리터럴 타입 (v4 신규)
-
-```typescript
-const hello = z.templateLiteral(["hello, ", z.string()])
-// `hello, ${string}`
-
-const cssUnits = z.enum(["px", "em", "rem", "%"])
-const css = z.templateLiteral([z.number(), cssUnits])
-// `${number}px` | `${number}em` | `${number}rem` | `${number}%`
-
-const email = z.templateLiteral([
-  z.string().min(1),
-  "@",
-  z.string().max(64),
-])
-// `${string}@${string}` (min/max refinements도 적용됨!)
-```
-
-## 숫자
-
-```typescript
-z.number()
-z.number().min(0)          // 최솟값
-z.number().max(100)        // 최댓값
-z.number().int()           // 정수만
-z.number().positive()      // 양수만
-z.number().negative()      // 음수만
-z.number().nonnegative()   // 0 이상
-z.number().nonpositive()   // 0 이하
-z.number().finite()        // 유한 숫자
-z.number().safe()          // 안전한 정수 범위
-```
-
-## 불리언
-
-```typescript
-z.boolean()
-```
-
-### 문자열 불리언 (v4 신규)
-
-환경변수 스타일 불리언 변환:
-
-```typescript
-const strbool = z.stringbool()
-
-strbool.parse("true")     // => true
-strbool.parse("1")        // => true
-strbool.parse("yes")      // => true
-strbool.parse("on")       // => true
-strbool.parse("enabled")  // => true
-
-strbool.parse("false")    // => false
-strbool.parse("0")        // => false
-strbool.parse("no")       // => false
-strbool.parse("off")      // => false
-strbool.parse("disabled") // => false
-
-// 커스텀 truthy/falsy 값
-z.stringbool({
-  truthy: ["yes", "true"],
-  falsy: ["no", "false"]
-})
-```
-
-## 날짜
-
-```typescript
-z.date()
-z.date().min(new Date('2020-01-01'))
-z.date().max(new Date('2030-12-31'))
-```
-
-## BigInt
-
-```typescript
-z.bigint()
-z.bigint().positive()
-z.bigint().negative()
-```
-
-## 리터럴
-
-```typescript
-z.literal('hello')       // 정확히 'hello'만
-z.literal(42)            // 정확히 42만
-z.literal(true)          // 정확히 true만
-```
-
-## Null, Undefined, Void
-
-```typescript
-z.null()       // null만 허용
-z.undefined()  // undefined만 허용
-z.void()       // undefined 허용 (반환 타입용)
-```
-
-## Any, Unknown, Never
-
-```typescript
-z.any()      // 모든 타입 허용
-z.unknown()  // unknown 타입
-z.never()    // 값 없음 (유니온에서 사용)
-```
-
-> **v4 변경**: `z.any()`와 `z.unknown()`은 더 이상 객체에서 선택적 키로 추론되지 않습니다.
-> ```typescript
-> const mySchema = z.object({ a: z.any(), b: z.unknown() })
-> // v3: { a?: any; b?: unknown }
-> // v4: { a: any; b: unknown }
-> ```
-
-## Optional & Nullable
-
-```typescript
-z.string().optional()  // string | undefined
-z.string().nullable()  // string | null
-z.string().nullish()   // string | null | undefined
-```
-
-## Default 값
-
-```typescript
-const Schema = z.object({
-  name: z.string().default('Anonymous'),
-  role: z.enum(['admin', 'user']).default('user'),
-})
-
-Schema.parse({}) // { name: 'Anonymous', role: 'user' }
-```
-
-## 타입 추론
-
-```typescript
-const stringSchema = z.string()
-type StringType = z.infer<typeof stringSchema> // string
-
-const numberSchema = z.number().optional()
-type NumberType = z.infer<typeof numberSchema> // number | undefined
-
-const dateSchema = z.date().nullable()
-type DateType = z.infer<typeof dateSchema> // Date | null
-```

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과 조합하여 체계적 구현

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

@@ -1,177 +0,0 @@
-# MCP (Model Context Protocol)
-
-> Claude Code 작업 효율성을 높이는 MCP 서버 활용 가이드
-
----
-
-## ⛔ 프로젝트 시작 전 필수 확인
-
-**작업 시작 전 반드시 아래 3가지 MCP가 활성화되어 있는지 확인하세요:**
-
-```
-1. Serena - 프로젝트 활성화 확인
-   → mcp__serena__get_current_config 호출
-   → 프로젝트 미활성화 시: mcp__serena__activate_project
-
-2. Sequential Thinking - 복잡한 문제 분석용
-   → 사용 가능 여부 확인
-
-3. sgrep - 코드베이스 검색용
-   → grep/rg 대신 반드시 sgrep 사용
-```
-
----
-
-## 🚨 필수 사용 규칙
-
-```
-✅ 프로젝트 시작 전 → Serena 활성화 확인 (필수!)
-✅ 코드베이스 검색 → sgrep 사용 (grep/rg 금지)
-✅ 복잡한 분석/디버깅 → Sequential Thinking 사용
-✅ 라이브러리 문서 조회 → Context7 사용
-✅ 세션 컨텍스트 유지 → Serena 메모리 활용
-✅ 도구 조합: sgrep로 위치 파악 → Sequential로 분석 → Context7로 문서 확인
-```
-
----
-
-## 🚀 Quick Reference
-
-### Serena - 프로젝트 컨텍스트 관리 (필수)
-
-```
-프로젝트 시작 시 (필수):
-1. get_current_config → 현재 상태 확인
-2. activate_project → 프로젝트 활성화
-3. check_onboarding_performed → 온보딩 확인
-
-사용 시점:
-- 프로젝트 시작/재개 시 (필수)
-- 심볼 탐색/수정
-- 세션 간 컨텍스트 유지 (메모리)
-```
-
-### Sequential Thinking - 복잡한 문제 해결
-
-```
-사용 시점:
-- 버그 분석 및 디버깅
-- 아키텍처 설계
-- 복잡한 로직 구현
-- 코드 리팩토링 계획
-- 성능 최적화 분석
-
-사용법: 문제를 단계별로 분해하여 체계적으로 해결
-```
-
-### sgrep - 코드베이스 검색 (필수)
-
-```
-사용 시점:
-- 코드 위치 파악
-- 자연어 검색
-- 심볼 참조 찾기
-
-주의: grep/rg 대신 반드시 sgrep 사용!
-```
-
-### Context7 - 라이브러리 문서 조회
-
-```
-사용 시점:
-- API 사용법 확인
-- 라이브러리 최신 문법 확인
-- 공식 문서 기반 구현
-- 버전별 변경사항 확인
-
-사용법:
-1. resolve-library-id로 라이브러리 ID 조회
-2. get-library-docs로 문서 가져오기
-```
-
----
-
-## 📁 문서 구조
-
-```
-docs/mcp/
-├── index.md              # 이 문서 (개요)
-├── serena.md             # Serena 프로젝트 관리 (필수)
-├── sgrep.md              # 코드베이스 검색 (필수)
-├── sequential-thinking.md # Sequential Thinking 상세 (필수)
-└── context7.md           # Context7 상세
-```
-
----
-
-## 📋 도구 목록
-
-| 도구 | 용도 | 필수 여부 |
-|-----|------|----------|
-| [Serena](./serena.md) | 프로젝트 컨텍스트 관리 | ⭐ 필수 |
-| [sgrep](./sgrep.md) | 코드베이스 검색 | ⭐ 필수 |
-| [Sequential Thinking](./sequential-thinking.md) | 체계적 문제 해결 | ⭐ 필수 |
-| [Context7](./context7.md) | 라이브러리 문서 | 권장 |
-
----
-
-## ⚡ 작업별 MCP 선택 가이드
-
-### 프로젝트 시작 (필수)
-```
-1. Serena: get_current_config로 상태 확인
-2. Serena: activate_project로 프로젝트 활성화
-3. Serena: list_memories로 이전 컨텍스트 확인
-```
-
-### 버그 수정
-```
-1. sgrep로 관련 코드 위치 파악
-2. Sequential Thinking으로 문제 분석
-3. 원인 파악 후 Context7로 관련 API 확인
-4. 수정 구현
-```
-
-### 새 기능 구현
-```
-1. sgrep로 기존 패턴 검색
-2. Sequential Thinking으로 구현 계획 수립
-3. Context7로 사용할 라이브러리 문서 확인
-4. 단계별 구현
-5. Serena: write_memory로 주요 결정 저장
-```
-
-### 라이브러리 사용
-```
-1. Context7로 공식 문서 조회
-2. 필요시 Sequential Thinking으로 복잡한 통합 분석
-```
-
-### 성능 최적화
-```
-1. sgrep로 병목 의심 코드 검색
-2. Sequential Thinking으로 병목 분석
-3. Context7로 최적화 관련 API 확인
-4. 개선 구현
-```
-
-### 코드베이스 탐색
-```
-1. sgrep로 자연어 쿼리 검색
-2. 관련 코드 위치 파악
-3. 필요시 Sequential Thinking으로 흐름 분석
-```
-
-### 세션 종료
-```
-1. Serena: write_memory로 진행 상황 저장
-2. 다음 세션에서 read_memory로 복구
-```
-
----
-
-## 🔗 관련 문서
-
-- [TanStack Start](../library/tanstack-start/index.md) - Server Functions
-- [Prisma](../library/prisma/index.md) - ORM
-- [Zod](../library/zod/index.md) - Validation