@kood/claude-code 0.5.10 → 0.6.1

package/templates/.claude/skills/ralph/SKILL.md

@@ -66,7 +66,7 @@ while (true) {
 
 **하나라도 실패 → ITERATION++ → Phase 1로 복귀**
 
-### 상태 문서 (`.claude/ralph/{{SESSION}}/`)
+### 상태 문서 (`.claude/ralph/00.[작업명]/`)
 
 | 파일 | 역할 | 업데이트 시점 |
 |------|------|--------------|
@@ -114,7 +114,7 @@ while (true) {
 | 2 | 코드 검증 | **새로 실행한** `/pre-deploy` 결과 | typecheck/lint/build 모두 통과 |
 | 3 | TODO 확인 | **새로 실행한** TaskList 조회 | pending/in_progress = 0 |
 | 4 | 플래너 검증 | **새로 생성한** Planner 에이전트 호출 | "승인" 응답 |
-| 5 | 상태 정리 | `.claude/ralph/` 상태 문서 최종 업데이트 | 완료 시각 기록 |
+| 5 | 상태 정리 | `.claude/ralph/00.[작업명]/` 상태 문서 최종 업데이트 | 완료 시각 기록 |
 
 **모든 5단계 통과 후에만 `<promise>` 출력. 하나라도 실패 시 루프 재개.**
 
@@ -157,7 +157,7 @@ Task(subagent_type="planner", model="opus", ...)  // 새로 검증
 
 ### 상태 문서 정리
 
-완료 직전 `.claude/ralph/{{SESSION}}/` 최종 업데이트:
+완료 직전 `.claude/ralph/00.[작업명]/` 최종 업데이트:
 - TASKS.md: 모든 체크박스 완료
 - PROCESS.md: 완료 시각, 총 소요 시간
 - VERIFICATION.md: 최종 검증 결과
@@ -725,10 +725,10 @@ Task(subagent_type="ko-to-en-translator", model="haiku",
 
 ### 문서화 폴더 구조
 
-**필수:** 세션 시작 시 `.claude/ralph/{{YYMMDD}}-{{N}}-{{작업명}}/` 폴더 생성
+**필수:** 세션 시작 시 `.claude/ralph/00.[작업명]/` 폴더 생성
 
 ```
-.claude/ralph/260129-01-사용자_인증_구현/
+.claude/ralph/00.사용자_인증_구현/
 ├── TASKS.md          # 작업 체크리스트
 ├── PROCESS.md        # 진행 단계 및 의사결정
 ├── VERIFICATION.md   # 검증 결과 기록 (매 반복마다 업데이트)
@@ -736,10 +736,8 @@ Task(subagent_type="ko-to-en-translator", model="haiku",
 └── NOTES.md          # 추가 메모
 ```
 
-**폴더명 형식:** `YYMMDD-N-작업명` (날짜 + 시퀀스 + 한글 설명)
-- 날짜: 오늘 날짜 (YYMMDD)
-- 시퀀스: 같은 날 여러 세션 시 증가 (01, 02, 03...)
-- 작업명: 한글 설명 (언더스코어로 구분)
+**폴더명 형식:** `00.[작업명]` (넘버링 + 한글 설명, 언더스코어로 구분)
+**넘버링:** 기존 ralph 폴더 목록 조회 → 다음 번호 자동 부여 (00, 01, 02...)
 
 **생성 시점:** Ralph 루프 진입 즉시 (첫 반복 시작 전)
 
@@ -908,7 +906,7 @@ Context compaction 후 세션 재개 시:
 
 ```text
 1. pwd 실행 → 작업 디렉토리 확인
-2. ls .claude/ralph/ → 최신 세션 폴더 식별 (가장 큰 번호)
+2. ls .claude/ralph/ → 최신 세션 폴더 식별 (가장 큰 넘버링)
 3. TASKS.md 읽기 → 요구사항 및 진행 상태 파악
 4. PROCESS.md 읽기 → 현재 Phase 및 다음 단계 확인
 5. VERIFICATION.md 읽기 → 검증 결과 확인
@@ -928,7 +926,7 @@ Context compaction 후 세션 재개 시:
 
 ```text
 1. 원본 작업 요구사항 분석
-2. 넘버링 결정 (ls .claude/ralph/)
+2. 넘버링 결정 (ls .claude/ralph/ → 다음 번호 자동 부여)
 3. .claude/ralph/00.[작업명]/ 폴더 생성 (한글 설명)
 4. TASKS.md 작성 (체크리스트)
 5. PROCESS.md 작성 (Phase 1 시작 기록)
@@ -1275,8 +1273,8 @@ Task(subagent_type="code-reviewer", model="opus", ...)
 
 **즉시 실행 (순차):**
 1. 원본 작업(`{{PROMPT}}`) 읽기
-2. 세션 폴더 생성: `.claude/ralph/{{YYMMDD}}-{{N}}-{{작업명}}/`
-   - `ls .claude/ralph/` → 오늘 날짜 폴더 찾기 → 다음 시퀀스 결정
+2. 세션 폴더 생성: `.claude/ralph/00.[작업명]/`
+   - `ls .claude/ralph/` → 기존 폴더 조회 → 다음 넘버링 결정
 3. 상태 문서 초기화 (병렬):
    ```typescript
    Task(subagent_type="document-writer", model="haiku",
@@ -1312,10 +1310,10 @@ Task(subagent_type="code-reviewer", model="opus", ...)
 
 **복구 프로토콜 (순차):**
 1. `pwd` → 작업 디렉토리 확인
-2. `ls -lt .claude/ralph/` → 최신 세션 폴더 찾기 (날짜순 정렬)
-3. `cat .claude/ralph/{{SESSION}}/ITERATION.md` → 반복 히스토리 확인
-4. `cat .claude/ralph/{{SESSION}}/VERIFICATION.md` → 마지막 검증 결과
-5. `cat .claude/ralph/{{SESSION}}/TASKS.md` → 미완료 항목
+2. `ls .claude/ralph/` → 최신 세션 폴더 찾기 (가장 큰 넘버링)
+3. `cat .claude/ralph/00.[작업명]/ITERATION.md` → 반복 히스토리 확인
+4. `cat .claude/ralph/00.[작업명]/VERIFICATION.md` → 마지막 검증 결과
+5. `cat .claude/ralph/00.[작업명]/TASKS.md` → 미완료 항목
 6. `git log --oneline -10` → 최근 커밋
 7. 현재 Iteration 번호 식별 후 루프 재개
 
@@ -1440,7 +1438,7 @@ Task(subagent_type="planner", ...) // Iteration N에서 새로 생성
 
 ### 6. 문서 = 루프 지속성
 
-`.claude/ralph/{{SESSION}}/` 상태 문서:
+`.claude/ralph/00.[작업명]/` 상태 문서:
 - TASKS.md: 요구사항 체크리스트
 - PROCESS.md: Phase 진행 상황
 - VERIFICATION.md: 매 반복 검증 결과

package/templates/.claude/skills/refactor/SKILL.md

@@ -161,6 +161,8 @@ $ARGUMENTS 있음 → 다음 단계 진행
 | **@analyst** | sonnet | 코드 메트릭 분석, 엣지 케이스 검증 |
 | **@explore** | haiku | 코드베이스 탐색, 의존성 파악 |
 | **@document-writer** | haiku/sonnet | 리팩토링 계획 및 결과 문서화 |
+| **@security-reviewer** | opus | 리팩토링 후 보안 취약점 검증 |
+| **@build-fixer** | sonnet | 리팩토링 후 빌드/타입 오류 수정 |
 
 ### 병렬 실행 패턴
 
@@ -314,6 +316,23 @@ Task({
 })
 ```
 
+#### 5-1. 리팩토링 후 보안 + 빌드 검증 병렬
+
+```typescript
+// ✅ 리팩토링 후 보안 + 빌드 검증 병렬
+Task({
+  subagent_type: "security-reviewer",
+  model: "opus",
+  prompt: "리팩토링 후 보안 취약점 검토"
+})
+
+Task({
+  subagent_type: "build-fixer",
+  model: "sonnet",
+  prompt: "리팩토링으로 발생한 빌드/타입 오류 수정"
+})
+```
+
 #### 6. 점진적 마이그레이션 병렬화
 
 ```typescript

package/templates/.claude/skills/research/SKILL.md

@@ -0,0 +1,260 @@
+---
+name: research
+description: 범용 자료조사 후 사람이 읽기 쉬운 구조화 리포트 생성. 모든 검색 채널(WebSearch, WebFetch, GitHub MCP, Firecrawl, SearXNG) 동원.
+user-invocable: true
+---
+
+@../../instructions/workflow-patterns/sequential-thinking.md
+@../../instructions/agent-patterns/parallel-execution.md
+@../../instructions/agent-patterns/model-routing.md
+@../../instructions/validation/forbidden-patterns.md
+@../../instructions/validation/required-behaviors.md
+
+# Research Skill
+
+> 범용 자료조사 → 사람이 읽기 쉬운 구조화 리포트 자동 생성
+
+---
+
+<purpose>
+
+brainstorm = **아이디어 발산** / research = **팩트 수렴**
+docs-fetch = **AI용 문서** / research = **사람이 읽는 리포트**
+
+**입력:** 주제 (자연어) + 선택적 깊이 (--quick/--deep)
+**출력:** `.claude/research/[NN].주제_요약.md` (Consulting Style 리포트)
+
+</purpose>
+
+---
+
+<trigger_conditions>
+
+| 트리거 | 반응 |
+|--------|------|
+| `/research AI 에이전트 프레임워크 비교` | 기술 비교 조사 |
+| `/research --deep 한국 SaaS 시장 트렌드` | 심층 시장 조사 |
+| `/research --quick WebSocket vs SSE` | 빠른 기술 비교 |
+| "OO에 대해 자료조사 해줘" | 주제 확인 후 실행 |
+
+ARGUMENT 없음 → 즉시 질문: "어떤 주제를 조사할까요?"
+
+</trigger_conditions>
+
+---
+
+<depth_levels>
+
+| 설정 | quick | standard (기본) | deep |
+|------|-------|----------------|------|
+| **플래그** | `--quick` | (없음) | `--deep` |
+| **검색 쿼리** | 3-5개 | 5-10개 | 10-15개 |
+| **에이전트** | researcher 2 + explore 0-1 | researcher 3-4 + explore 0-1 | researcher 4-5 + explore 1 + MCP |
+| **Iterative** | X | X | O (analyst → 2차 수집) |
+| **소스 최소** | 5개 | 10개 | 20개+ |
+| **리포트** | 500-1000자 | 1500-3000자 | 3000-6000자 |
+
+</depth_levels>
+
+---
+
+<topic_classification>
+
+Phase 0에서 자동 분류 → 채널 조합 결정:
+
+| 유형 | 키워드 | 채널 |
+|------|--------|------|
+| **기술 비교** | "vs", "비교" | WebSearch + explore(gh) |
+| **시장/트렌드** | "시장", "트렌드" | WebSearch + Firecrawl |
+| **경쟁사 분석** | "경쟁사", "대안" | WebSearch + GitHub MCP |
+| **학술/개념** | "원리", "논문" | WebSearch (arxiv) + WebFetch |
+| **프로젝트 내부** | "우리 코드" | explore + Grep |
+| **라이브러리** | 패키지명@버전 | → **docs-fetch 위임** |
+
+</topic_classification>
+
+---
+
+<sourcing_strategy>
+
+## Smart Tier Fallback
+
+```
+Tier 1 (MCP, Phase 0에서 ToolSearch로 감지):
+  SearXNG MCP  → 메타검색 | Firecrawl MCP → 페이지→MD | GitHub MCP → 코드/리포
+
+Tier 2 (내장, 항상 가용):
+  WebSearch → 웹 검색 | WebFetch → 페이지 읽기 | gh CLI → GitHub API (Bash)
+
+Tier 3: Playwright → SPA/JS 필요 시 (crawler skill)
+```
+
+**MCP는 main agent가 직접 실행** (subagent는 MCP 도구 사용 불가)
+
+| MCP 도구 | 용도 | 미설치 시 폴백 |
+|----------|------|--------------|
+| `firecrawl_map/scrape/crawl` | 사이트 구조/페이지 수집 | WebFetch (페이지별) |
+| SearXNG `search` | 246+ 엔진 메타검색 | WebSearch (내장) |
+| `search_repositories/code/issues` | GitHub 리포/코드/이슈 | `gh search` (Bash via explore) |
+
+</sourcing_strategy>
+
+---
+
+<workflow>
+
+## 실행 흐름
+
+| Phase | 작업 | 도구 |
+|-------|------|------|
+| **0** | 입력 파싱 + MCP 감지 + 주제 분류 | ToolSearch × 3 |
+| **1** | 검색 전략 (Sequential Thinking 2단계) | ST: 질문 도출 → 쿼리 생성 |
+| **2** | 병렬 자료 수집 | researcher + explore + MCP |
+| **3** | 갭 분석 + 2차 수집 (**deep만**) | analyst → researcher |
+| **4** | 리포트 생성 | general-purpose |
+| **5** | 저장 + 터미널 출력 | Write |
+
+---
+
+### Phase 0: 환경 감지
+
+```
+1. 입력 파싱: 주제, --quick/--deep, 특수 지시 ("한국어 우선" 등)
+2. 주제 분류: <topic_classification> 참조 (라이브러리 → docs-fetch 위임)
+3. MCP 감지: ToolSearch("firecrawl"), ToolSearch("searxng"), ToolSearch("github")
+4. 기존 조사: .claude/research/ 동일 주제 → 업데이트 모드
+```
+
+### Phase 1: 검색 전략
+
+```
+Sequential Thinking (2단계):
+  thought 1: 핵심 질문 3-5개, 주제 유형 확정, 범위 결정 (시간/지역/언어)
+  thought 2: 다각도 쿼리 생성 (영어+한국어, 연도 포함), 채널별 배분, 에이전트 역할 분배
+```
+
+### Phase 2: 병렬 수집
+
+**에이전트 도구 제약 (@.claude/agents/ 정의 준수):**
+
+| Agent | Model | 도구 | 역할 |
+|-------|-------|------|------|
+| researcher | sonnet | WebSearch, WebFetch, Read | 웹 조사 + 출처 수집 |
+| explore | haiku | Read, Glob, Grep, **Bash** | `gh` CLI GitHub 분석 |
+| main agent | - | MCP 도구들 | Firecrawl/SearXNG/GitHub MCP 직접 실행 |
+
+```typescript
+// 기술 비교 (standard: researcher 3 + explore 1 병렬)
+Task({ subagent_type: 'researcher', prompt: '기술 A 장단점, 성능. 출처 URL 필수.' })
+Task({ subagent_type: 'researcher', prompt: '기술 B 장단점, 성능. 출처 URL 필수.' })
+Task({ subagent_type: 'researcher', prompt: 'A vs B 벤치마크, 비교, 후기. 출처 URL 필수.' })
+Task({ subagent_type: 'explore', model: 'haiku',
+       prompt: 'gh search repos "기술 A/B" --sort stars. 스타, 커밋, 이슈 비교.' })
+// MCP 가용 시 main agent가 동시에 search_repositories, firecrawl_scrape 등 실행
+```
+
+**researcher 출력:** `요약 → 공식 문서 → GitHub 이슈/PR → 추가 참고 → 권장사항` (researcher agent 정의 준수)
+**시장/트렌드:** researcher를 글로벌/한국/투자 등 관점별 배분
+**경쟁사:** researcher를 경쟁사별 1개씩 + 비교 리뷰 1개
+
+### Phase 3: Iterative Deep Search (deep만)
+
+```
+analyst (opus, 6-gap 프레임워크):
+  1차 수집 갭 분석 → 커버/빈 영역 식별, 미검증 가정, 추가 쿼리 2-5개 도출
+
+researcher × 2-3: 빈 영역 집중 검색
+```
+
+### Phase 4: 리포트 생성
+
+**document-writer는 AI용 문서 전문 → general-purpose 사용.**
+
+```typescript
+Task({ subagent_type: 'general-purpose',
+       prompt: `수집 자료 기반 리포트 작성.
+       형식: <report_template> 참조. 경로: .claude/research/[NN].주제_요약.md
+       필수: Executive Summary 250-400자 (결론 우선), 출처 URL, 비교 테이블, 권장사항
+       사람용 문서: XML 태그/토큰 최적화 하지 말 것` })
+```
+
+### Phase 5: 저장
+
+```
+파일: .claude/research/[NN].주제_요약.md (기존 파일 다음 번호, 한글+언더스코어)
+넘버링: ls .claude/research/ | sort -r | head -1 → 다음 번호
+출력: Executive Summary + 핵심 발견 3-5개 + "전체 리포트: [경로]" 안내
+```
+
+</workflow>
+
+---
+
+<report_template>
+
+@./report-template.md
+
+### 작성 원칙
+
+| 원칙 | 설명 |
+|------|------|
+| **결론 우선** | 가장 중요한 결론을 첫 문장에 (Pyramid Principle) |
+| **팩트 기반** | 모든 핵심 주장에 출처 URL 필수 |
+| **시각적 계층** | H1 하나, H2-H3, 테이블 활용 |
+| **Progressive Disclosure** | 요약→상세, Executive Summary만 읽어도 충분 |
+
+</report_template>
+
+---
+
+<chaining>
+
+| 흐름 | 사용 시점 |
+|------|---------|
+| research → brainstorm | 팩트 조사 후 아이디어 도출 |
+| research → prd | 시장 조사 → 요구사항 정의 |
+| brainstorm → research | 아이디어 실현 가능성 검증 |
+
+</chaining>
+
+---
+
+<examples>
+
+```
+/research WebSocket vs SSE vs gRPC 실시간 통신
+
+Phase 0: 기술 비교, standard
+Phase 1: 쿼리 7개 (장단점, 성능, 사용사례, 스케일링)
+Phase 2: researcher 3 + explore 1 (gh search repos)
+Phase 4: 리포트 → .claude/research/02.실시간_통신_기술_비교.md
+
+Executive Summary:
+gRPC가 처리량/레이턴시 우위(HTTP/2)이나 브라우저 미지원.
+웹 → WebSocket, 단방향 → SSE, 마이크로서비스 → gRPC.
+
+| 기준 | WebSocket | SSE | gRPC |
+|------|-----------|-----|------|
+| 방향 | 양방향 | 서버→클라 | 양방향 |
+| 브라우저 | ✅ | ✅ | ❌ |
+| 복잡도 | 중간 | 낮음 | 높음 |
+```
+
+**deep 예시:** `/research --deep 한국 AI SaaS 시장 2026` → researcher 5 + explore 1 + Phase 3 analyst 갭분석 → .claude/research/03.한국_AI_SaaS_시장_2026.md (~5000자)
+
+</examples>
+
+---
+
+<validation>
+
+| 단계 | 체크 |
+|------|------|
+| **실행 전** | ARGUMENT, 주제 분류, MCP 감지, 깊이 확인 |
+| **수집 후** | 최소 소스 충족 (5/10/20), 출처 URL, 다각도 수집 |
+| **리포트** | Exec Summary 250-400자, 출처, 비교 테이블, 권장사항, 참고자료, 메타데이터 |
+| **저장** | .claude/research/ 저장, 터미널 출력, 경로 안내 |
+
+**절대 금지:** 출처 없는 주장 / 단일 소스 리포트 / Exec Summary 누락 / 권장사항 누락 / 저장 안 함 / 라이브러리 주제 (→ docs-fetch)
+
+</validation>

package/templates/.claude/skills/research/report-template.md

@@ -0,0 +1,88 @@
+# 리포트 템플릿
+
+```markdown
+# [주제] 조사 리포트
+
+> **조사일:** YYYY-MM-DD | **깊이:** quick/standard/deep | **소스:** N개 검토, M개 인용
+
+---
+
+## Executive Summary
+
+[250-400자. 가장 중요한 결론을 첫 문장에 배치 (McKinsey Pyramid Principle).
+핵심 발견사항 3-5개를 결론 우선으로 서술.]
+
+---
+
+## 1. 조사 개요
+
+### 1.1 배경
+[왜 이 조사가 필요한가]
+
+### 1.2 조사 범위
+[포함/제외 범위, 시간 범위, 지역]
+
+### 1.3 방법론
+[사용한 검색 채널, 수집 소스 수, 검색 쿼리 개수]
+
+---
+
+## 2. 핵심 발견사항
+
+### 2.1 [발견사항 1 제목]
+
+**핵심:** [한 문장 요약]
+
+[상세 설명. 데이터, 수치, 사례 포함.]
+
+> 출처: [제목](URL)
+
+(발견사항 개수: quick 3개 / standard 5개 / deep 7개+)
+
+---
+
+## 3. 비교 분석
+(비교 대상이 있을 때만 포함)
+
+| 기준 | 옵션 A | 옵션 B | 옵션 C |
+|------|--------|--------|--------|
+| [기준 1] | ... | ... | ... |
+| **종합 평가** | ... | ... | ... |
+
+---
+
+## 4. 트렌드 및 시사점
+
+- **트렌드 1:** [설명] ([출처](URL))
+
+---
+
+## 5. 결론 및 권장사항
+
+### 핵심 결론
+[Executive Summary의 확장. 최종 판단.]
+
+### 권장사항
+1. **[권장 1]:** [구체적이고 실행 가능한 액션]
+
+### 추가 조사 필요 영역
+- [커버하지 못한 영역]
+
+---
+
+## 참고자료
+
+### 공식 문서 / 1차 자료
+- [제목](URL) - [핵심 내용 1줄]
+
+### 기술 블로그 / 분석
+- [제목](URL) - [핵심 내용 1줄]
+
+---
+
+**메타데이터**
+- 생성일: YYYY-MM-DD
+- 검색 채널: [사용한 도구 목록]
+- 검색 쿼리: N개
+- 검토 소스: N개 / 인용 소스: M개
+```

package/templates/.claude/skills/tanstack-start-react-best-practices/SKILL.md

@@ -2,6 +2,7 @@
 name: tanstack-start-react-best-practices
 description: TanStack Start와 React 성능 최적화 가이드. React 컴포넌트, TanStack Start 페이지 작성/리뷰/리팩토링 시 최적 성능 패턴 보장. React 컴포넌트, TanStack Router 라우트, 데이터 페칭, 번들 최적화, 성능 개선 작업에 트리거.
 license: MIT
+framework: tanstack-start
 metadata:
   author: vercel
   version: "1.0.0"