@su-record/vibe 2.4.1 → 2.4.3

package/dist/tools/semantic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/semantic/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/tools/semantic/index.js

@@ -0,0 +1,7 @@
+/**
+ * Semantic Tools - 코드 분석 및 심볼 탐색
+ */
+export { findSymbol } from './findSymbol.js';
+export { findReferences } from './findReferences.js';
+export { analyzeDependencyGraph } from './analyzeDependencyGraph.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/semantic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/semantic/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/tools/thinking/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Thinking Tools - 사고 체인 및 문제 분석
+ */
+export { createThinkingChain } from './createThinkingChain.js';
+export { analyzeProblem } from './analyzeProblem.js';
+export { stepByStepAnalysis } from './stepByStepAnalysis.js';
+export { formatAsPlan } from './formatAsPlan.js';
+export { breakDownProblem } from './breakDownProblem.js';
+export { thinkAloudProcess } from './thinkAloudProcess.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/thinking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/thinking/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/thinking/index.js

@@ -0,0 +1,10 @@
+/**
+ * Thinking Tools - 사고 체인 및 문제 분석
+ */
+export { createThinkingChain } from './createThinkingChain.js';
+export { analyzeProblem } from './analyzeProblem.js';
+export { stepByStepAnalysis } from './stepByStepAnalysis.js';
+export { formatAsPlan } from './formatAsPlan.js';
+export { breakDownProblem } from './breakDownProblem.js';
+export { thinkAloudProcess } from './thinkAloudProcess.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/thinking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/thinking/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/tools/time/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Time Tools - 시간 관련
+ */
+export { getCurrentTime } from './getCurrentTime.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/time/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/time/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/time/index.js

@@ -0,0 +1,5 @@
+/**
+ * Time Tools - 시간 관련
+ */
+export { getCurrentTime } from './getCurrentTime.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/time/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/time/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/ui/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * UI Tools - UI 미리보기
+ */
+export { previewUiAscii } from './previewUiAscii.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/ui/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/ui/index.js

@@ -0,0 +1,5 @@
+/**
+ * UI Tools - UI 미리보기
+ */
+export { previewUiAscii } from './previewUiAscii.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/ui/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/hooks/hooks.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';Promise.all([import('@su-record/vibe/tools').then(t => t.startSession({projectPath: p})), import('@su-record/vibe/tools').then(t => t.getCurrentTime({format: 'human', timezone: 'Asia/Seoul'})), import('@su-record/vibe/tools').then(t => t.listMemories({limit: 5, projectPath: p}))]).then(([session, time, memories]) => console.log(session.content[0].text + '\\n\\n' + time.content[0].text + '\\n\\n[Recent Memories]\\n' + memories.content[0].text))\""
+            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';Promise.all([import('@su-record/vibe/tools/memory').then(t => t.startSession({projectPath: p})), import('@su-record/vibe/tools/time').then(t => t.getCurrentTime({format: 'human', timezone: 'Asia/Seoul'})), import('@su-record/vibe/tools/memory').then(t => t.listMemories({limit: 5, projectPath: p}))]).then(([session, time, memories]) => console.log(session.content[0].text + '\\n\\n' + time.content[0].text + '\\n\\n[Recent Memories]\\n' + memories.content[0].text))\""
           }
         ]
       }
@@ -27,12 +27,21 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools').then(t => t.validateCodeQuality({targetPath: '.', projectPath: p}).then(r => console.log('[CODE CHECK]', r.content[0].text.split('\\n').slice(0,3).join(' | ')))).catch(() => console.log('[AUTO-CONTINUE] Code written. Continue.'))\""
+            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools/convention').then(t => t.validateCodeQuality({targetPath: '.', projectPath: p}).then(r => console.log('[CODE CHECK]', r.content[0].text.split('\\n').slice(0,3).join(' | ')))).catch(() => console.log('[AUTO-CONTINUE] Code written. Continue.'))\""
           }
         ]
       }
     ],
     "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '[MANDATORY SKILL PROTOCOL] Available skills: vibe-capabilities (vibe features), multi-llm-orchestration (GPT/Gemini usage), tool-fallback (error recovery), context7-usage (library docs), parallel-research (complex problems), git-worktree (branch work), priority-todos (task management). Step 1: For EACH skill state YES/NO with reason. Step 2: Use Skill(name) for YES skills NOW. Step 3: IMPLEMENT only after activation. CRITICAL: Skipping activation makes response WORTHLESS.'",
+            "statusMessage": "Evaluating skills..."
+          }
+        ]
+      },
       {
         "matcher": "ultrawork|ulw|울트라워크",
         "hooks": [
@@ -47,7 +56,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools').then(t => t.saveMemory({key: 'solution-' + Date.now(), value: 'Solution documented at ' + new Date().toISOString(), category: 'solution', projectPath: p}).then(r => console.log('[COMPOUND]', r.content[0].text))).catch(() => console.log('[COMPOUND TRIGGER] Consider /vibe.utils --compound'))\""
+            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools/memory').then(t => t.saveMemory({key: 'solution-' + Date.now(), value: 'Solution documented at ' + new Date().toISOString(), category: 'solution', projectPath: p}).then(r => console.log('[COMPOUND]', r.content[0].text))).catch(() => console.log('[COMPOUND TRIGGER] Consider /vibe.utils --compound'))\""
           }
         ]
       },
@@ -56,7 +65,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools').then(t => t.validateCodeQuality({targetPath: '.', projectPath: p}).then(r => console.log('[REVIEW PREP]', r.content[0].text.split('\\n').slice(0,5).join(' | ')))).catch(() => console.log('[REVIEW MODE] Use /vibe.review'))\""
+            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools/convention').then(t => t.validateCodeQuality({targetPath: '.', projectPath: p}).then(r => console.log('[REVIEW PREP]', r.content[0].text.split('\\n').slice(0,5).join(' | ')))).catch(() => console.log('[REVIEW MODE] Use /vibe.review'))\""
           }
         ]
       },
@@ -74,7 +83,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools').then(t => t.analyzeComplexity({targetPath: '.', projectPath: p}).then(r => console.log('[COMPLEXITY]', r.content[0].text.split('\\n').slice(0,5).join(' | ')))).catch(() => console.log('[ANALYZE] Use analyzeComplexity tool'))\""
+            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools/convention').then(t => t.analyzeComplexity({targetPath: '.', projectPath: p}).then(r => console.log('[COMPLEXITY]', r.content[0].text.split('\\n').slice(0,5).join(' | ')))).catch(() => console.log('[ANALYZE] Use analyzeComplexity tool'))\""
           }
         ]
       },
@@ -83,7 +92,61 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools').then(t => t.listMemories({limit: 10, projectPath: p}).then(r => console.log('[RECALL]', r.content[0].text.split('\\n').slice(0,7).join(' | ')))).catch(() => console.log('[RECALL] Use recallMemory tool'))\""
+            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools/memory').then(t => t.listMemories({limit: 10, projectPath: p}).then(r => console.log('[RECALL]', r.content[0].text.split('\\n').slice(0,7).join(' | ')))).catch(() => console.log('[RECALL] Use recallMemory tool'))\""
+          }
+        ]
+      },
+      {
+        "matcher": "아키텍처|architecture|설계.*검토|design.*review|구조.*분석",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '[GPT-5.2 AVAILABLE] Architecture review → Consider mcp__vibe-gpt__gpt_analyze_architecture for GPT-5.2 perspective.'"
+          }
+        ]
+      },
+      {
+        "matcher": "UI|UX|사용자.*경험|user.*experience|디자인.*리뷰|design.*feedback",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '[GEMINI-3-PRO AVAILABLE] UI/UX review → Consider mcp__vibe-gemini__gemini_review_ui for Gemini 3 Pro perspective.'"
+          }
+        ]
+      },
+      {
+        "matcher": "gpt.*물어|gpt.*질문|gpt.*한테|ask.*gpt|gpt.*chat",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '[GPT-5.2 MCP] To ask GPT-5.2 → Use mcp__vibe-gpt__gpt_chat directly.'"
+          }
+        ]
+      },
+      {
+        "matcher": "gemini.*물어|gemini.*질문|gemini.*한테|ask.*gemini|gemini.*chat",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '[GEMINI-3-PRO MCP] To ask Gemini 3 Pro → Use mcp__vibe-gemini__gemini_chat directly.'"
+          }
+        ]
+      },
+      {
+        "matcher": "디버깅|debugging|버그.*찾|find.*bug|debug.*this",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '[GPT-5.2 DEBUG] For debugging → Consider mcp__vibe-gpt__gpt_debug for GPT-5.2 second opinion.'"
+          }
+        ]
+      },
+      {
+        "matcher": "코드.*분석|analyze.*code|code.*review.*gemini",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '[GEMINI-3-PRO CODE] For code analysis → Consider mcp__vibe-gemini__gemini_analyze_code for Gemini 3 Pro second opinion.'"
           }
         ]
       }
@@ -94,7 +157,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools').then(t => t.autoSaveContext({urgency: 'medium', contextType: 'progress', summary: 'Context at 80% - auto checkpoint', projectPath: p}).then(r => console.log('[CONTEXT 80%]', r.content[0].text)))\""
+            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools/memory').then(t => t.autoSaveContext({urgency: 'medium', contextType: 'progress', summary: 'Context at 80% - auto checkpoint', projectPath: p}).then(r => console.log('[CONTEXT 80%]', r.content[0].text)))\""
           }
         ]
       },
@@ -103,7 +166,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools').then(t => t.autoSaveContext({urgency: 'high', contextType: 'progress', summary: 'Context at 90% - save before overflow', projectPath: p}).then(r => console.log('[CONTEXT 90%]', r.content[0].text)))\""
+            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools/memory').then(t => t.autoSaveContext({urgency: 'high', contextType: 'progress', summary: 'Context at 90% - save before overflow', projectPath: p}).then(r => console.log('[CONTEXT 90%]', r.content[0].text)))\""
           }
         ]
       },
@@ -112,7 +175,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools').then(t => t.autoSaveContext({urgency: 'critical', contextType: 'progress', summary: 'Context at 95% - CRITICAL save before session end', projectPath: p}).then(r => console.log('[CONTEXT 95%]', r.content[0].text)))\""
+            "command": "node -e \"const p='$CLAUDE_PROJECT_DIR';import('@su-record/vibe/tools/memory').then(t => t.autoSaveContext({urgency: 'critical', contextType: 'progress', summary: 'Context at 95% - CRITICAL save before session end', projectPath: p}).then(r => console.log('[CONTEXT 95%]', r.content[0].text)))\""
           }
         ]
       }

package/package.json

@@ -1,12 +1,22 @@
 {
   "name": "@su-record/vibe",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework with 35+ integrated tools",
   "type": "module",
   "main": "dist/cli/index.js",
   "exports": {
     ".": "./dist/cli/index.js",
     "./tools": "./dist/tools/index.js",
+    "./tools/memory": "./dist/tools/memory/index.js",
+    "./tools/convention": "./dist/tools/convention/index.js",
+    "./tools/semantic": "./dist/tools/semantic/index.js",
+    "./tools/thinking": "./dist/tools/thinking/index.js",
+    "./tools/planning": "./dist/tools/planning/index.js",
+    "./tools/prompt": "./dist/tools/prompt/index.js",
+    "./tools/ui": "./dist/tools/ui/index.js",
+    "./tools/time": "./dist/tools/time/index.js",
+    "./tools/reasoning": "./dist/tools/reasoning/index.js",
+    "./tools/analytics": "./dist/tools/analytics/index.js",
     "./orchestrator": "./dist/orchestrator/index.js"
   },
   "bin": {

package/skills/context7-usage.md

@@ -0,0 +1,82 @@
+---
+description: Context7 MCP for latest library documentation. Auto-activates when docs, documentation, latest version, official docs, API reference, or library help is needed.
+---
+# Context7 Usage
+
+Guide for searching latest library/framework documentation using Context7 MCP.
+
+## When to Use
+
+| Situation | Example |
+|-----------|---------|
+| Latest API check | "React 19 use() hook usage" |
+| Version differences | "Next.js 15 changes" |
+| Official docs needed | "Prisma schema syntax" |
+| Migration guide | "Vue 2 → Vue 3 migration" |
+
+## Usage (2 Steps)
+
+### Step 1: Find Library ID
+
+```
+mcp__context7__resolve-library-id({
+  libraryName: "react"
+})
+```
+
+Returns: `/facebook/react`, `/vercel/next.js`, etc.
+
+### Step 2: Get Documentation
+
+```
+mcp__context7__get-library-docs({
+  context7CompatibleLibraryID: "/facebook/react",
+  topic: "hooks"  // optional: specific topic only
+})
+```
+
+## Common Library IDs
+
+| Library | Context7 ID |
+|---------|-------------|
+| React | /facebook/react |
+| Next.js | /vercel/next.js |
+| Vue | /vuejs/vue |
+| Svelte | /sveltejs/svelte |
+| Express | /expressjs/express |
+| Prisma | /prisma/prisma |
+| TypeScript | /microsoft/typescript |
+
+## Search Tips
+
+```
+# Broad search
+topic: omit → full documentation
+
+# Narrow search
+topic: "authentication" → auth related only
+
+# Specific feature
+topic: "server components" → server components only
+```
+
+## Web Search vs Context7
+
+| Aspect | Web Search | Context7 |
+|--------|------------|----------|
+| Speed | Slow | Fast |
+| Accuracy | Blogs mixed in | Official docs only |
+| Freshness | Variable | Always latest |
+| Reliability | Medium | High |
+
+**Prefer Context7 for library documentation**
+
+## Fallback When Fails
+
+```
+context7 fails
+    ↓
+Web Search for official docs
+    ↓
+Ask vibe-gpt
+```

package/skills/git-worktree.md

@@ -1,3 +1,6 @@
+---
+description: Git Worktree for parallel branch work. Auto-activates for PR review, hotfix, parallel testing, or working on multiple branches simultaneously.
+---
 # Git Worktree Skill
 
 Git Worktree를 활용한 병렬 브랜치 작업 스킬

package/skills/multi-llm-orchestration.md

@@ -0,0 +1,97 @@
+---
+description: Multi-LLM collaboration guide. Auto-activates for architecture review, design decisions, debugging, UI/UX consultation, complex problem solving, or when a different perspective is needed.
+---
+# Multi-LLM Orchestration
+
+Guide for using GPT/Gemini as sub-agents in Claude Code.
+
+## When to Use GPT (mcp__vibe-gpt)
+
+| Situation | Reason |
+|-----------|--------|
+| Architecture design/review | Get different perspective on design |
+| Complex debugging | Fresh eyes on the problem |
+| Algorithm optimization | Alternative algorithm suggestions |
+| Security review | Cross-check vulnerabilities |
+| Technology decisions | Compare pros/cons |
+
+### Usage
+
+```
+mcp__vibe-gpt__gpt_chat({
+  prompt: "Review this auth architecture: [code/description]",
+  model: "gpt-5.2-codex"  // coding specialized
+})
+```
+
+### Recommended Models
+
+| Model | Use Case |
+|-------|----------|
+| gpt-5.2 | General purpose (default) |
+| gpt-5.2-codex | Coding specialized |
+| gpt-5.1-codex-mini | Quick responses needed |
+
+## When to Use Gemini (mcp__vibe-gemini)
+
+| Situation | Reason |
+|-----------|--------|
+| UI/UX design consultation | User experience perspective |
+| Design system advice | Component structuring |
+| Accessibility (a11y) review | Accessibility guidelines |
+| User flow design | UX optimization |
+
+### Usage
+
+```
+mcp__vibe-gemini__gemini_chat({
+  prompt: "Suggest UX improvements for this login form: [description]"
+})
+```
+
+## When NOT to Use
+
+- Simple implementation (Claude alone is sufficient)
+- File read/write (use Claude's tools)
+- Quick response needed (API latency exists)
+- Tasks requiring project context (Claude has the context)
+
+## Collaboration Patterns
+
+### Pattern 1: Design Cross-check
+
+```
+Claude: Draft design
+    ↓
+GPT: Architecture review (mcp__vibe-gpt__gpt_analyze_architecture)
+    ↓
+Claude: Incorporate feedback into final design
+```
+
+### Pattern 2: Debugging Collaboration
+
+```
+Claude: Attempt problem analysis
+    ↓
+If stuck, ask GPT (mcp__vibe-gpt__gpt_debug)
+    ↓
+Claude: Apply GPT's suggestions
+```
+
+### Pattern 3: UI/UX Consultation
+
+```
+Claude: Implement feature
+    ↓
+Gemini: Suggest UX improvements (mcp__vibe-gemini__gemini_chat)
+    ↓
+Claude: Apply UX feedback
+```
+
+## API Key Setup
+
+```bash
+vibe gpt <api-key>      # Enable GPT
+vibe gemini <api-key>   # Enable Gemini
+vibe status             # Check current settings
+```

package/skills/parallel-research.md

@@ -0,0 +1,77 @@
+---
+description: Parallel research guide. Auto-activates for complex features, new technologies, security-critical work, architecture design, or technology selection decisions.
+---
+# Parallel Research
+
+Parallel research patterns for solving complex problems.
+
+## When Parallel Research is Needed
+
+| Situation | Reason |
+|-----------|--------|
+| New technology adoption | Need best practices |
+| Security-related features | Multi-angle review needed |
+| Architecture design | Multiple perspectives needed |
+| Technology selection | Comparison analysis needed |
+| Complex bugs | Explore multiple causes |
+
+## Research Agents (4 Parallel)
+
+| Agent | Role | Tools |
+|-------|------|-------|
+| best-practices | Search best practices | Web Search, context7 |
+| framework-docs | Search official docs | context7 |
+| codebase-patterns | Analyze existing code patterns | Grep, Glob |
+| security-advisory | Search security advisories | Web Search |
+
+## Usage Methods
+
+### Method 1: Direct Orchestrator Call
+
+```bash
+node -e "import('@su-record/vibe/orchestrator').then(o =>
+  o.research('passkey authentication', ['React', 'Supabase'])
+  .then(r => console.log(r.content[0].text))
+)"
+```
+
+### Method 2: Use /vibe.spec
+
+```
+/vibe.spec "feature-name"
+→ Parallel research runs automatically after requirements confirmed
+```
+
+### Method 3: Parallel Task Tool Execution
+
+```
+Task 1: "Search React auth best practices"
+Task 2: "Search Supabase Auth official docs" (concurrent)
+Task 3: "Analyze existing auth code patterns" (concurrent)
+Task 4: "Search auth security vulnerabilities" (concurrent)
+```
+
+## Using Research Results
+
+```
+Parallel research complete
+    ↓
+Synthesize results
+    ↓
+Reflect in SPEC Context section
+OR
+Reference during implementation
+```
+
+## When Research is NOT Needed
+
+- Simple CRUD operations
+- Already familiar patterns
+- Similar code exists in project
+- Time-critical (supplement with review later)
+
+## Notes
+
+- Research runs **after requirements confirmed**
+- Split overly broad topics
+- Research results are references, not absolute truth

package/skills/priority-todos.md

@@ -1,3 +1,6 @@
+---
+description: Priority-based TODO management (P1/P2/P3). Auto-activates when managing tasks, reviewing issues, or organizing work by priority.
+---
 # Priority-Based Todo Management Skill
 
 우선순위 기반 TODO 관리 시스템

package/skills/tool-fallback.md

@@ -0,0 +1,126 @@
+---
+description: Tool failure fallback strategies with circuit breaker. Auto-activates on API errors, search failures, timeouts, 429, 5xx, overloaded errors.
+---
+# Tool Fallback Strategies
+
+Guide for finding alternatives when tools fail to continue work.
+
+## Circuit Breaker Pattern
+
+Track tool failures and temporarily disable unreliable tools:
+
+```
+Tool State Machine:
+┌─────────┐   3 failures   ┌─────────┐   30s cooldown   ┌─────────────┐
+│ CLOSED  │ ─────────────→ │  OPEN   │ ───────────────→ │ HALF-OPEN   │
+│ (normal)│                │ (block) │                  │ (test 1 req)│
+└─────────┘                └─────────┘                  └─────────────┘
+     ↑                                                        │
+     │                      success                           │
+     └────────────────────────────────────────────────────────┘
+```
+
+| State | Behavior |
+|-------|----------|
+| **CLOSED** | Normal operation, count failures |
+| **OPEN** | Block all requests, use alternative immediately |
+| **HALF-OPEN** | Allow 1 test request after cooldown |
+
+**Per-tool tracking:**
+```
+vibe-gpt: failures=2, state=CLOSED
+vibe-gemini: failures=0, state=CLOSED
+WebSearch: failures=3, state=OPEN (blocked until 14:32:00)
+context7: failures=1, state=CLOSED
+```
+
+## When Web Search Fails
+
+| Alternative | Method |
+|-------------|--------|
+| context7 MCP | `mcp__context7__query-docs` |
+| vibe-gpt | `mcp__vibe-gpt__gpt_chat` |
+| Cached knowledge | Use Claude's built-in knowledge |
+
+```
+Web Search fails (429, 529, timeout)
+    ↓
+Check circuit breaker state
+    ↓
+If OPEN → Skip to alternative immediately
+    ↓
+If CLOSED → Try context7 for library docs
+    ↓
+If still fails, ask GPT
+    ↓
+Last resort: Claude's built-in knowledge
+```
+
+## API Error Responses
+
+| Error | Cause | Response | Circuit Breaker |
+|-------|-------|----------|-----------------|
+| 429 | Rate Limit | Exponential backoff | +1 failure count |
+| 5xx | Server Error | Switch to alternative | +1 failure count |
+| 529 | Overloaded | Wait and retry | +1 failure count |
+| Timeout | Network | Split request or retry | +1 failure count |
+| 401/403 | Auth Error | Re-auth or alternative | Don't count (auth issue) |
+
+## When File/Code Not Found
+
+```
+Glob fails
+    ↓
+Expand pattern: *.ts → **/*.ts → **/*
+    ↓
+Use Grep for content-based search
+    ↓
+Check git log for history
+```
+
+## When MCP Fails
+
+```
+vibe-gpt fails
+    ↓
+Check circuit: If OPEN, skip to next
+    ↓
+Try vibe-gemini (similar capability)
+    ↓
+Try context7 (for docs)
+    ↓
+Claude solves alone
+```
+
+## Retry Strategy with Circuit Breaker
+
+```
+Request to tool
+    ↓
+Check circuit state
+    ↓
+┌─ OPEN? ──→ Use alternative immediately (no retry)
+│
+└─ CLOSED/HALF-OPEN? ──→ Try request
+                              ↓
+                         Success? ──→ Reset failure count
+                              ↓ No
+                         Retry with backoff:
+                           retry(1): wait 2s
+                           retry(2): wait 4s
+                           retry(3): wait 8s
+                              ↓
+                         All failed? ──→ +1 failure, check threshold
+                              ↓
+                         failures >= 3? ──→ OPEN circuit for 30s
+                              ↓
+                         Use alternative
+```
+
+## Principles
+
+1. **Never stop** - Always find an alternative
+2. **Before asking user** - Try alternatives first
+3. **Track failures** - Open circuit after 3 consecutive failures
+4. **Auto-recover** - Test after 30s cooldown
+5. **Fail fast** - Skip blocked tools immediately