@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.
@@ -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
- - mcp__vibe-gpt__* - GPT search (when integrated)
31
+ - GPT hook - `gpt- [query]` (fallback)
32
32
 
33
33
  ## Process
34
34
 
@@ -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 | Model | Condition |
271
- |------|-------|-----------|
272
- | Architecture/Debugging | GPT 5.2 | When `vibe gpt <key>` executed |
273
- | UI/UX Design, Exploration | Gemini 2.5/3 | When `vibe gemini --auth` executed |
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
- ### External LLM Fallback
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
- **IMPORTANT**: When Gemini/GPT MCP returns `"status": "fallback"`, Claude MUST handle the task directly:
281
+ ### External LLM Fallback
285
282
 
286
- ```json
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] + MCP(vibe-gpt): Architecture review
453
- │ [If Gemini enabled] + MCP(vibe-gemini): UI/UX consultation
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 MCP 호출 (필수)**
649
+ **MUST: Gemini 코드 리뷰 (필수)**
659
650
 
660
- Gemini MCP가 활성화된 경우, **반드시** 아래 MCP를 호출하여 코드 리뷰를 받아야 합니다:
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
- mcp__vibe-gemini__gemini_analyze_code({
664
- code: "[변경된 파일들의 전체 코드]",
665
- context: "SPEC 요구사항: [요약]\n시나리오: [구현한 시나리오 목록]",
666
- focus: "security,performance,best-practices"
667
- })
662
+ 제미나이- 이 코드 리뷰해줘 (보안, 성능, 베스트프랙티스):
663
+ [코드]
668
664
  ```
669
665
 
670
666
  **호출 순서:**
671
- 1. 변경된 모든 파일 내용을 `code` 파라미터에 포함
672
- 2. SPEC의 핵심 요구사항을 `context`에 요약
673
- 3. MCP 호출 실행
667
+ 1. 변경된 모든 파일 내용을 질문에 포함
668
+ 2. SPEC의 핵심 요구사항 요약 추가
669
+ 3. 호출 실행
674
670
  4. 응답의 피드백 항목별로 코드 수정
675
671
  5. 빌드/테스트 재실행
676
672
 
@@ -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 in `.claude/vibe/config.json`, automatically utilize during SPEC creation:
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?] → Cross-review design via MCP(vibe-gpt)
38
+ [GPT enabled?] → gpt- Review this architecture: [design]
39
39
 
40
- [Gemini enabled?] → UI/UX consultation via MCP(vibe-gemini)
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 5.2 | Architecture/design review | After SPEC draft completion |
48
- | Gemini 3 | UI/UX consultation | During design reference discussion |
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 <api-key> # Enable GPT
53
- vibe gemini <api-key> # Enable Gemini
54
- vibe status # Check current settings
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": "(?!.*gemini)(gpt\\s*한테|gpt\\s*에게|gpt에\\s*물어|gpt.*질문|ask\\s*gpt)",
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(/gpt.*?(물어|질문|한테|분석)[^가-힣]*/i,'').trim();import(V).then(g=>g.quickAsk(q)).then(r=>console.log('[GPT] '+r)).catch(e=>console.log('[GPT] Error:',e.message))})\"",
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": "(?!.*gpt)(gemini\\s*한테|gemini\\s*에게|gemini에\\s*물어|gemini.*질문|ask\\s*gemini|제미나이)",
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(/(gemini|제미나이).*?(물어|질문|한테|분석)[^가-힣]*/i,'').trim();import(V).then(g=>g.quickAsk(q)).then(r=>console.log('[Gemini] '+r)).catch(e=>console.log('[Gemini] Error:',e.message))})\"",
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@su-record/vibe",
3
- "version": "2.4.27",
3
+ "version": "2.4.29",
4
4
  "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework with 35+ integrated tools",
5
5
  "type": "module",
6
6
  "main": "dist/cli/index.js",
@@ -78,5 +78,5 @@ context7 fails
78
78
 
79
79
  Web Search for official docs
80
80
 
81
- Ask vibe-gpt
81
+ gpt- [library question]
82
82
  ```
@@ -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
- ## When to Use GPT (mcp__vibe-gpt)
8
+ ## Calling GPT
9
9
 
10
- | Situation | Reason |
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
- ### Usage
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
- mcp__vibe-gpt__gpt_chat({
22
- prompt: "Review this auth architecture: [code/description]",
23
- model: "gpt-5.2-codex" // coding specialized
24
- })
23
+ gpt- 이 인증 아키텍처를 검토해줘: [코드]
24
+ gpt- Review this REST API design
25
+ 지피티- 알고리즘 최적화 방법 알려줘
25
26
  ```
26
27
 
27
- ### Recommended Models
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
- ## When to Use Gemini (mcp__vibe-gemini)
30
+ Use `gemini-` or `제미나이-` prefix:
36
31
 
37
- | Situation | Reason |
38
- |-----------|--------|
39
- | UI/UX design consultation | User experience perspective |
40
- | Design system advice | Component structuring |
41
- | Accessibility (a11y) review | Accessibility guidelines |
42
- | User flow design | UX optimization |
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
- mcp__vibe-gemini__gemini_chat({
48
- prompt: "Suggest UX improvements for this login form: [description]"
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
- GPT: Architecture review (mcp__vibe-gpt__gpt_analyze_architecture)
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, ask GPT (mcp__vibe-gpt__gpt_debug)
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
- Gemini: Suggest UX improvements (mcp__vibe-gemini__gemini_chat)
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 <api-key> # Enable GPT
95
- vibe gemini <api-key> # Enable Gemini
96
- vibe status # Check current settings
89
+ vibe gpt login # Enable GPT (OAuth)
90
+ vibe gemini login # Enable Gemini (OAuth)
91
+ vibe status # Check current settings
97
92
  ```
@@ -28,8 +28,8 @@ Tool State Machine:
28
28
 
29
29
  **Per-tool tracking:**
30
30
  ```
31
- vibe-gpt: failures=2, state=CLOSED
32
- vibe-gemini: failures=0, state=CLOSED
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
- | vibe-gpt | `mcp__vibe-gpt__gpt_chat` |
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, ask GPT
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 MCP Fails
81
+ ## When LLM Hook Fails
82
82
 
83
83
  ```
84
- vibe-gpt fails
84
+ gpt- [question] fails
85
85
 
86
86
  Check circuit: If OPEN, skip to next
87
87
 
88
- Try vibe-gemini (similar capability)
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
- ## MCP Integrations
71
+ ## LLM Integrations (Hooks)
72
72
 
73
- | MCP | Purpose |
74
- |-----|---------|
75
- | vibe-gpt | GPT sub-agent (architecture, debugging) |
76
- | vibe-gemini | Gemini sub-agent (UI/UX) |
77
- | context7 | Latest library documentation |
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 MCP integrations (gpt, gemini, context7)
127
+ 2. Use LLM hooks (`gpt-`, `gemini-`)
126
128
  3. Reference skills for guidance
127
129
  4. Apply coding rules from `.claude/vibe/rules/`