@su-record/vibe 2.4.27 → 2.4.29
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.
- package/agents/searcher.md +5 -5
- package/commands/vibe.run.md +28 -32
- package/commands/vibe.spec.md +10 -10
- package/hooks/hooks.json +4 -4
- package/package.json +1 -1
- package/skills/context7-usage.md +1 -1
- package/skills/multi-llm-orchestration.md +33 -38
- package/skills/tool-fallback.md +7 -7
- package/skills/vibe-capabilities.md +9 -7
package/agents/searcher.md
CHANGED
|
@@ -11,24 +11,24 @@ Web search specialist sub-agent.
|
|
|
11
11
|
|
|
12
12
|
## Model
|
|
13
13
|
|
|
14
|
-
- **With GPT integration**: Use GPT (mcp__vibe-gpt__search)
|
|
15
14
|
- **Default**: Haiku 4.5 + WebSearch
|
|
15
|
+
- **Fallback**: GPT hook (`gpt- [query]`)
|
|
16
16
|
|
|
17
17
|
## Usage
|
|
18
18
|
|
|
19
19
|
```
|
|
20
|
-
# With GPT integration
|
|
21
|
-
mcp__vibe-gpt__search("React 19 changes")
|
|
22
|
-
|
|
23
20
|
# Default (Haiku + WebSearch)
|
|
24
21
|
Task(model: "haiku", prompt: "Search React 19 changes")
|
|
22
|
+
|
|
23
|
+
# Fallback to GPT
|
|
24
|
+
gpt- Search for React 19 changes and new features
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
## Tools
|
|
28
28
|
|
|
29
29
|
- WebSearch - Web search (default)
|
|
30
30
|
- WebFetch - Fetch page content
|
|
31
|
-
-
|
|
31
|
+
- GPT hook - `gpt- [query]` (fallback)
|
|
32
32
|
|
|
33
33
|
## Process
|
|
34
34
|
|
package/commands/vibe.run.md
CHANGED
|
@@ -267,29 +267,20 @@ Automatically select optimal model based on task type:
|
|
|
267
267
|
|
|
268
268
|
When external LLMs are enabled in `.claude/vibe/config.json`:
|
|
269
269
|
|
|
270
|
-
| Role |
|
|
271
|
-
|
|
272
|
-
| Architecture/Debugging |
|
|
273
|
-
| UI/UX Design, Exploration |
|
|
274
|
-
|
|
275
|
-
When external LLM enabled, automatically called via MCP:
|
|
276
|
-
- `mcp__vibe-gpt__chat` - GPT 5.2 architecture consultation
|
|
277
|
-
- `mcp__vibe-gemini__gemini_chat` - Gemini 질문/상담
|
|
278
|
-
- `mcp__vibe-gemini__gemini_analyze_code` - 코드 분석
|
|
279
|
-
- `mcp__vibe-gemini__gemini_review_ui` - UI/UX 리뷰
|
|
280
|
-
- `mcp__vibe-gemini__gemini_quick_ask` - 빠른 질문 (탐색용)
|
|
270
|
+
| Role | Prefix | Condition |
|
|
271
|
+
|------|--------|-----------|
|
|
272
|
+
| Architecture/Debugging | `gpt-` or `지피티-` | When `vibe gpt login` executed |
|
|
273
|
+
| UI/UX Design, Exploration | `gemini-` or `제미나이-` | When `vibe gemini login` executed |
|
|
281
274
|
|
|
282
|
-
|
|
275
|
+
When external LLM enabled, use hook prefixes:
|
|
276
|
+
- `gpt- [question]` - GPT architecture consultation
|
|
277
|
+
- `gemini- [question]` - Gemini 질문/상담
|
|
278
|
+
- `gemini- Analyze this code: [code]` - 코드 분석
|
|
279
|
+
- `gemini- Review UI/UX for: [component]` - UI/UX 리뷰
|
|
283
280
|
|
|
284
|
-
|
|
281
|
+
### External LLM Fallback
|
|
285
282
|
|
|
286
|
-
|
|
287
|
-
{
|
|
288
|
-
"status": "fallback",
|
|
289
|
-
"reason": "rate_limit", // or "auth_error"
|
|
290
|
-
"message": "Gemini API 할당량 초과. Claude가 직접 처리해주세요."
|
|
291
|
-
}
|
|
292
|
-
```
|
|
283
|
+
**IMPORTANT**: When GPT/Gemini hook fails, Claude MUST handle the task directly:
|
|
293
284
|
|
|
294
285
|
**Fallback behavior**:
|
|
295
286
|
- Do NOT retry the external LLM call
|
|
@@ -449,8 +440,8 @@ Then: 로그인 성공 + JWT 토큰 반환
|
|
|
449
440
|
│ │ │
|
|
450
441
|
│ Task(haiku) ─┴─→ "Find existing patterns and conventions" │
|
|
451
442
|
│ │
|
|
452
|
-
│ [If GPT enabled]
|
|
453
|
-
│ [If Gemini enabled]
|
|
443
|
+
│ [If GPT enabled] gpt- Review architecture: [design] │
|
|
444
|
+
│ [If Gemini enabled] gemini- Suggest UX for: [component] │
|
|
454
445
|
└─────────────────────────────────────────────────────────────────┘
|
|
455
446
|
│
|
|
456
447
|
↓ (wait for all to complete)
|
|
@@ -655,22 +646,27 @@ Phase N+1 Start (IMMEDIATE - exploration already done!)
|
|
|
655
646
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
656
647
|
```
|
|
657
648
|
|
|
658
|
-
**MUST: Gemini
|
|
649
|
+
**MUST: Gemini 코드 리뷰 (필수)**
|
|
659
650
|
|
|
660
|
-
Gemini
|
|
651
|
+
Gemini가 활성화된 경우, **반드시** 아래 훅을 사용하여 코드 리뷰를 받아야 합니다:
|
|
652
|
+
|
|
653
|
+
```
|
|
654
|
+
gemini- Review this code for security, performance, best-practices:
|
|
655
|
+
[변경된 파일들의 전체 코드]
|
|
656
|
+
SPEC 요구사항: [요약]
|
|
657
|
+
시나리오: [구현한 시나리오 목록]
|
|
658
|
+
```
|
|
661
659
|
|
|
660
|
+
또는 한글로:
|
|
662
661
|
```
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
context: "SPEC 요구사항: [요약]\n시나리오: [구현한 시나리오 목록]",
|
|
666
|
-
focus: "security,performance,best-practices"
|
|
667
|
-
})
|
|
662
|
+
제미나이- 이 코드 리뷰해줘 (보안, 성능, 베스트프랙티스):
|
|
663
|
+
[코드]
|
|
668
664
|
```
|
|
669
665
|
|
|
670
666
|
**호출 순서:**
|
|
671
|
-
1. 변경된 모든 파일 내용을
|
|
672
|
-
2. SPEC의 핵심
|
|
673
|
-
3.
|
|
667
|
+
1. 변경된 모든 파일 내용을 질문에 포함
|
|
668
|
+
2. SPEC의 핵심 요구사항 요약 추가
|
|
669
|
+
3. 훅 호출 실행
|
|
674
670
|
4. 응답의 피드백 항목별로 코드 수정
|
|
675
671
|
5. 빌드/테스트 재실행
|
|
676
672
|
|
package/commands/vibe.spec.md
CHANGED
|
@@ -28,30 +28,30 @@ Collect requirements through conversation with the user and create an **AI-execu
|
|
|
28
28
|
|
|
29
29
|
## External LLM Integration (Optional)
|
|
30
30
|
|
|
31
|
-
When external LLMs are enabled
|
|
31
|
+
When external LLMs are enabled, automatically utilize during SPEC creation:
|
|
32
32
|
|
|
33
33
|
```
|
|
34
34
|
/vibe.spec "complex feature"
|
|
35
35
|
↓
|
|
36
36
|
[Claude Opus] Create SPEC draft
|
|
37
37
|
↓
|
|
38
|
-
[GPT enabled?] →
|
|
38
|
+
[GPT enabled?] → gpt- Review this architecture: [design]
|
|
39
39
|
↓
|
|
40
|
-
[Gemini enabled?] →
|
|
40
|
+
[Gemini enabled?] → gemini- Suggest UX improvements for: [component]
|
|
41
41
|
↓
|
|
42
42
|
[Claude] Finalize SPEC
|
|
43
43
|
```
|
|
44
44
|
|
|
45
|
-
| External LLM | Role | When Used |
|
|
46
|
-
|
|
47
|
-
| GPT
|
|
48
|
-
| Gemini
|
|
45
|
+
| External LLM | Prefix | Role | When Used |
|
|
46
|
+
|--------------|--------|------|-----------|
|
|
47
|
+
| GPT | `gpt-` or `지피티-` | Architecture/design review | After SPEC draft completion |
|
|
48
|
+
| Gemini | `gemini-` or `제미나이-` | UI/UX consultation | During design reference discussion |
|
|
49
49
|
|
|
50
50
|
**Activation:**
|
|
51
51
|
```bash
|
|
52
|
-
vibe gpt
|
|
53
|
-
vibe gemini
|
|
54
|
-
vibe status
|
|
52
|
+
vibe gpt login # Enable GPT (OAuth)
|
|
53
|
+
vibe gemini login # Enable Gemini (OAuth)
|
|
54
|
+
vibe status # Check current settings
|
|
55
55
|
```
|
|
56
56
|
|
|
57
57
|
## Process
|
package/hooks/hooks.json
CHANGED
|
@@ -122,21 +122,21 @@
|
|
|
122
122
|
]
|
|
123
123
|
},
|
|
124
124
|
{
|
|
125
|
-
"matcher": "(
|
|
125
|
+
"matcher": "^(gpt-|지피티-)",
|
|
126
126
|
"hooks": [
|
|
127
127
|
{
|
|
128
128
|
"type": "command",
|
|
129
|
-
"command": "node -e \"const V='file:///{{VIBE_PATH}}/node_modules/@su-record/vibe/dist/lib/gpt-api.js';let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const q=JSON.parse(d).prompt.replace(
|
|
129
|
+
"command": "node -e \"const V='file:///{{VIBE_PATH}}/node_modules/@su-record/vibe/dist/lib/gpt-api.js';let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const q=JSON.parse(d).prompt.replace(/^(gpt-|지피티-)\\s*/i,'').trim();import(V).then(g=>g.quickAsk(q)).then(r=>console.log('[GPT] '+r)).catch(e=>console.log('[GPT] Error:',e.message))})\"",
|
|
130
130
|
"statusMessage": "Asking GPT..."
|
|
131
131
|
}
|
|
132
132
|
]
|
|
133
133
|
},
|
|
134
134
|
{
|
|
135
|
-
"matcher": "(
|
|
135
|
+
"matcher": "^(gemini-|제미나이-)",
|
|
136
136
|
"hooks": [
|
|
137
137
|
{
|
|
138
138
|
"type": "command",
|
|
139
|
-
"command": "node -e \"const V='file:///{{VIBE_PATH}}/node_modules/@su-record/vibe/dist/lib/gemini-api.js';let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const q=JSON.parse(d).prompt.replace(
|
|
139
|
+
"command": "node -e \"const V='file:///{{VIBE_PATH}}/node_modules/@su-record/vibe/dist/lib/gemini-api.js';let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const q=JSON.parse(d).prompt.replace(/^(gemini-|제미나이-)\\s*/i,'').trim();import(V).then(g=>g.quickAsk(q)).then(r=>console.log('[Gemini] '+r)).catch(e=>console.log('[Gemini] Error:',e.message))})\"",
|
|
140
140
|
"statusMessage": "Asking Gemini..."
|
|
141
141
|
}
|
|
142
142
|
]
|
package/package.json
CHANGED
package/skills/context7-usage.md
CHANGED
|
@@ -3,50 +3,45 @@ description: Multi-LLM collaboration guide. Auto-activates for architecture revi
|
|
|
3
3
|
---
|
|
4
4
|
# Multi-LLM Orchestration
|
|
5
5
|
|
|
6
|
-
Guide for using GPT/Gemini as sub-agents in Claude Code.
|
|
6
|
+
Guide for using GPT/Gemini as sub-agents in Claude Code via hooks.
|
|
7
7
|
|
|
8
|
-
##
|
|
8
|
+
## Calling GPT
|
|
9
9
|
|
|
10
|
-
|
|
11
|
-
|-----------|--------|
|
|
12
|
-
| Architecture design/review | Get different perspective on design |
|
|
13
|
-
| Complex debugging | Fresh eyes on the problem |
|
|
14
|
-
| Algorithm optimization | Alternative algorithm suggestions |
|
|
15
|
-
| Security review | Cross-check vulnerabilities |
|
|
16
|
-
| Technology decisions | Compare pros/cons |
|
|
10
|
+
Use `gpt-` or `지피티-` prefix:
|
|
17
11
|
|
|
18
|
-
|
|
12
|
+
| Situation | Example |
|
|
13
|
+
|-----------|---------|
|
|
14
|
+
| Architecture review | `gpt- Review this auth architecture: [code]` |
|
|
15
|
+
| Complex debugging | `gpt- Debug this error: [error message]` |
|
|
16
|
+
| Algorithm optimization | `gpt- Suggest better algorithm for: [problem]` |
|
|
17
|
+
| Security review | `gpt- Check security vulnerabilities in: [code]` |
|
|
18
|
+
| Technology decisions | `gpt- Compare Redis vs Memcached for caching` |
|
|
19
|
+
|
|
20
|
+
### Usage Examples
|
|
19
21
|
|
|
20
22
|
```
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
})
|
|
23
|
+
gpt- 이 인증 아키텍처를 검토해줘: [코드]
|
|
24
|
+
gpt- Review this REST API design
|
|
25
|
+
지피티- 이 알고리즘 최적화 방법 알려줘
|
|
25
26
|
```
|
|
26
27
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
| Model | Use Case |
|
|
30
|
-
|-------|----------|
|
|
31
|
-
| gpt-5.2 | General purpose (default) |
|
|
32
|
-
| gpt-5.2-codex | Coding specialized |
|
|
33
|
-
| gpt-5.1-codex-mini | Quick responses needed |
|
|
28
|
+
## Calling Gemini
|
|
34
29
|
|
|
35
|
-
|
|
30
|
+
Use `gemini-` or `제미나이-` prefix:
|
|
36
31
|
|
|
37
|
-
| Situation |
|
|
38
|
-
|
|
39
|
-
| UI/UX
|
|
40
|
-
| Design system advice |
|
|
41
|
-
| Accessibility
|
|
42
|
-
| User flow design |
|
|
32
|
+
| Situation | Example |
|
|
33
|
+
|-----------|---------|
|
|
34
|
+
| UI/UX consultation | `gemini- Improve UX for this login form` |
|
|
35
|
+
| Design system advice | `gemini- Suggest component structure` |
|
|
36
|
+
| Accessibility review | `gemini- Check a11y issues in this form` |
|
|
37
|
+
| User flow design | `gemini- Optimize this checkout flow` |
|
|
43
38
|
|
|
44
|
-
### Usage
|
|
39
|
+
### Usage Examples
|
|
45
40
|
|
|
46
41
|
```
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
42
|
+
gemini- 이 로그인 폼 UX 개선해줘
|
|
43
|
+
gemini- Suggest improvements for this dashboard
|
|
44
|
+
제미나이- 이 컴포넌트 구조 분석해줘
|
|
50
45
|
```
|
|
51
46
|
|
|
52
47
|
## When NOT to Use
|
|
@@ -63,7 +58,7 @@ mcp__vibe-gemini__gemini_chat({
|
|
|
63
58
|
```
|
|
64
59
|
Claude: Draft design
|
|
65
60
|
↓
|
|
66
|
-
|
|
61
|
+
gpt- Review this architecture: [design]
|
|
67
62
|
↓
|
|
68
63
|
Claude: Incorporate feedback into final design
|
|
69
64
|
```
|
|
@@ -73,7 +68,7 @@ Claude: Incorporate feedback into final design
|
|
|
73
68
|
```
|
|
74
69
|
Claude: Attempt problem analysis
|
|
75
70
|
↓
|
|
76
|
-
If stuck
|
|
71
|
+
If stuck: gpt- Debug this issue: [error details]
|
|
77
72
|
↓
|
|
78
73
|
Claude: Apply GPT's suggestions
|
|
79
74
|
```
|
|
@@ -83,7 +78,7 @@ Claude: Apply GPT's suggestions
|
|
|
83
78
|
```
|
|
84
79
|
Claude: Implement feature
|
|
85
80
|
↓
|
|
86
|
-
|
|
81
|
+
gemini- Suggest UX improvements for: [component]
|
|
87
82
|
↓
|
|
88
83
|
Claude: Apply UX feedback
|
|
89
84
|
```
|
|
@@ -91,7 +86,7 @@ Claude: Apply UX feedback
|
|
|
91
86
|
## API Key Setup
|
|
92
87
|
|
|
93
88
|
```bash
|
|
94
|
-
vibe gpt
|
|
95
|
-
vibe gemini
|
|
96
|
-
vibe status
|
|
89
|
+
vibe gpt login # Enable GPT (OAuth)
|
|
90
|
+
vibe gemini login # Enable Gemini (OAuth)
|
|
91
|
+
vibe status # Check current settings
|
|
97
92
|
```
|
package/skills/tool-fallback.md
CHANGED
|
@@ -28,8 +28,8 @@ Tool State Machine:
|
|
|
28
28
|
|
|
29
29
|
**Per-tool tracking:**
|
|
30
30
|
```
|
|
31
|
-
|
|
32
|
-
|
|
31
|
+
GPT hook: failures=2, state=CLOSED
|
|
32
|
+
Gemini hook: failures=0, state=CLOSED
|
|
33
33
|
WebSearch: failures=3, state=OPEN (blocked until 14:32:00)
|
|
34
34
|
context7: failures=1, state=CLOSED
|
|
35
35
|
```
|
|
@@ -39,7 +39,7 @@ context7: failures=1, state=CLOSED
|
|
|
39
39
|
| Alternative | Method |
|
|
40
40
|
|-------------|--------|
|
|
41
41
|
| context7 MCP | `mcp__context7__query-docs` |
|
|
42
|
-
|
|
|
42
|
+
| GPT hook | `gpt- [your question]` |
|
|
43
43
|
| Cached knowledge | Use Claude's built-in knowledge |
|
|
44
44
|
|
|
45
45
|
```
|
|
@@ -51,7 +51,7 @@ If OPEN → Skip to alternative immediately
|
|
|
51
51
|
↓
|
|
52
52
|
If CLOSED → Try context7 for library docs
|
|
53
53
|
↓
|
|
54
|
-
If still fails
|
|
54
|
+
If still fails: gpt- [question]
|
|
55
55
|
↓
|
|
56
56
|
Last resort: Claude's built-in knowledge
|
|
57
57
|
```
|
|
@@ -78,14 +78,14 @@ Use Grep for content-based search
|
|
|
78
78
|
Check git log for history
|
|
79
79
|
```
|
|
80
80
|
|
|
81
|
-
## When
|
|
81
|
+
## When LLM Hook Fails
|
|
82
82
|
|
|
83
83
|
```
|
|
84
|
-
|
|
84
|
+
gpt- [question] fails
|
|
85
85
|
↓
|
|
86
86
|
Check circuit: If OPEN, skip to next
|
|
87
87
|
↓
|
|
88
|
-
Try
|
|
88
|
+
Try gemini- [question] (similar capability)
|
|
89
89
|
↓
|
|
90
90
|
Try context7 (for docs)
|
|
91
91
|
↓
|
|
@@ -68,13 +68,15 @@ node -e "import('@su-record/vibe/orchestrator').then(o =>
|
|
|
68
68
|
)"
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
##
|
|
71
|
+
## LLM Integrations (Hooks)
|
|
72
72
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
|
76
|
-
|
|
77
|
-
|
|
|
73
|
+
Use prefix patterns to call GPT/Gemini:
|
|
74
|
+
|
|
75
|
+
| LLM | Prefix | Example |
|
|
76
|
+
|-----|--------|---------|
|
|
77
|
+
| GPT | `gpt-` or `지피티-` | `gpt- Review this code` |
|
|
78
|
+
| Gemini | `gemini-` or `제미나이-` | `gemini- Analyze UX` |
|
|
79
|
+
| context7 | MCP call | Library documentation |
|
|
78
80
|
|
|
79
81
|
## ULTRAWORK Mode
|
|
80
82
|
|
|
@@ -122,6 +124,6 @@ Add `ultrawork` or `ulw` for maximum performance:
|
|
|
122
124
|
Even without `/vibe.*` commands, you can:
|
|
123
125
|
|
|
124
126
|
1. Call tools directly via node commands
|
|
125
|
-
2. Use
|
|
127
|
+
2. Use LLM hooks (`gpt-`, `gemini-`)
|
|
126
128
|
3. Reference skills for guidance
|
|
127
129
|
4. Apply coding rules from `.claude/vibe/rules/`
|