@su-record/vibe 2.4.32 → 2.4.34
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/CLAUDE.md +6 -0
- package/README.md +122 -122
- package/dist/cli/index.d.ts.map +1 -1
- package/dist/cli/index.js +131 -142
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/setup.js +38 -38
- package/dist/cli/setup.js.map +1 -1
- package/package.json +1 -1
package/CLAUDE.md
CHANGED
|
@@ -37,6 +37,12 @@ SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
|
|
|
37
37
|
- `@ts-ignore` 금지 → 타입 문제 근본 해결
|
|
38
38
|
- 모든 함수에 반환 타입 명시
|
|
39
39
|
|
|
40
|
+
### TypeScript 규칙
|
|
41
|
+
- `any` 타입 사용 금지 → `unknown` + 타입 가드 사용
|
|
42
|
+
- `as any` 캐스팅 금지 → 적절한 인터페이스 정의
|
|
43
|
+
- `@ts-ignore` 금지 → 타입 문제 근본 해결
|
|
44
|
+
- 모든 함수에 반환 타입 명시
|
|
45
|
+
|
|
40
46
|
### 에러 처리 필수
|
|
41
47
|
- try-catch 또는 error state 필수
|
|
42
48
|
- 로딩 상태 처리
|
package/README.md
CHANGED
|
@@ -1,210 +1,210 @@
|
|
|
1
1
|
# Vibe
|
|
2
2
|
|
|
3
|
-
**SPEC
|
|
3
|
+
**SPEC-driven AI coding framework** (Claude Code only)
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@su-record/vibe)
|
|
6
6
|
[](https://opensource.org/licenses/MIT)
|
|
7
7
|
|
|
8
|
-
##
|
|
8
|
+
## Install
|
|
9
9
|
|
|
10
10
|
```bash
|
|
11
11
|
npm install -g @su-record/vibe
|
|
12
12
|
vibe init
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
##
|
|
15
|
+
## Commands
|
|
16
16
|
|
|
17
|
-
###
|
|
17
|
+
### Terminal
|
|
18
18
|
|
|
19
|
-
|
|
|
20
|
-
|
|
21
|
-
| `vibe init` |
|
|
22
|
-
| `vibe update` |
|
|
23
|
-
| `vibe status` |
|
|
24
|
-
| `vibe auth gpt` | GPT OAuth
|
|
25
|
-
| `vibe auth gemini` | Gemini OAuth
|
|
26
|
-
| `vibe logout gpt` | GPT
|
|
27
|
-
| `vibe logout gemini` | Gemini
|
|
28
|
-
| `vibe help` |
|
|
29
|
-
| `vibe version` |
|
|
19
|
+
| Command | Description |
|
|
20
|
+
|---------|-------------|
|
|
21
|
+
| `vibe init` | Initialize project |
|
|
22
|
+
| `vibe update` | Update settings |
|
|
23
|
+
| `vibe status` | Check status |
|
|
24
|
+
| `vibe auth gpt` | GPT OAuth authentication |
|
|
25
|
+
| `vibe auth gemini` | Gemini OAuth authentication |
|
|
26
|
+
| `vibe logout gpt` | GPT logout |
|
|
27
|
+
| `vibe logout gemini` | Gemini logout |
|
|
28
|
+
| `vibe help` | Help |
|
|
29
|
+
| `vibe version` | Version info |
|
|
30
30
|
|
|
31
31
|
### Claude Code
|
|
32
32
|
|
|
33
|
-
|
|
|
34
|
-
|
|
35
|
-
| `/vibe.spec "
|
|
36
|
-
| `/vibe.run "
|
|
37
|
-
| `/vibe.run "
|
|
38
|
-
| `/vibe.verify "
|
|
39
|
-
| `/vibe.review` | 13+
|
|
40
|
-
| `/vibe.analyze` |
|
|
41
|
-
| `/vibe.reason "
|
|
42
|
-
| `/vibe.utils` |
|
|
33
|
+
| Command | Description |
|
|
34
|
+
|---------|-------------|
|
|
35
|
+
| `/vibe.spec "feature"` | Create SPEC + parallel research |
|
|
36
|
+
| `/vibe.run "feature"` | Execute implementation |
|
|
37
|
+
| `/vibe.run "feature" ultrawork` | Maximum performance mode |
|
|
38
|
+
| `/vibe.verify "feature"` | BDD verification |
|
|
39
|
+
| `/vibe.review` | 13+ agent parallel review |
|
|
40
|
+
| `/vibe.analyze` | Code analysis |
|
|
41
|
+
| `/vibe.reason "problem"` | Systematic reasoning |
|
|
42
|
+
| `/vibe.utils` | Utilities (--e2e, --diagram, etc.) |
|
|
43
43
|
|
|
44
|
-
##
|
|
44
|
+
## Workflow
|
|
45
45
|
|
|
46
46
|
```
|
|
47
47
|
/vibe.spec → /vibe.run → /vibe.verify → /vibe.review
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
-
##
|
|
50
|
+
## Key Features
|
|
51
51
|
|
|
52
|
-
|
|
|
53
|
-
|
|
54
|
-
|
|
|
55
|
-
| **13+
|
|
56
|
-
| **BDD
|
|
57
|
-
| **ULTRAWORK
|
|
58
|
-
| **36
|
|
59
|
-
|
|
|
52
|
+
| Feature | Description |
|
|
53
|
+
|---------|-------------|
|
|
54
|
+
| **Multi-model orchestration** | Claude + GPT-5.2 + Gemini 3 Pro |
|
|
55
|
+
| **13+ parallel review agents** | Security, performance, architecture |
|
|
56
|
+
| **BDD auto verification** | Given/When/Then scenario verification |
|
|
57
|
+
| **ULTRAWORK mode** | One keyword enables all optimizations |
|
|
58
|
+
| **36 built-in tools** | Code analysis, memory management, quality validation |
|
|
59
|
+
| **Auto context management** | 80%+ auto-save, session restore |
|
|
60
60
|
|
|
61
|
-
## ULTRAWORK
|
|
61
|
+
## ULTRAWORK Mode
|
|
62
62
|
|
|
63
|
-
`ultrawork`
|
|
63
|
+
Enable maximum performance with `ultrawork` or `ulw`:
|
|
64
64
|
|
|
65
65
|
```bash
|
|
66
|
-
/vibe.run "
|
|
67
|
-
/vibe.run "
|
|
66
|
+
/vibe.run "feature" ultrawork
|
|
67
|
+
/vibe.run "feature" ulw # Same
|
|
68
68
|
```
|
|
69
69
|
|
|
70
|
-
|
|
71
|
-
-
|
|
72
|
-
- Boulder Loop (
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
-
|
|
70
|
+
**Enabled features:**
|
|
71
|
+
- Parallel subagent exploration (3+ concurrent)
|
|
72
|
+
- Boulder Loop (auto-progress until all scenarios complete)
|
|
73
|
+
- Auto-retry on errors (max 3)
|
|
74
|
+
- Continuous execution without phase confirmation
|
|
75
|
+
- Auto-save at 80%+ context
|
|
76
76
|
|
|
77
|
-
##
|
|
77
|
+
## Multi-model Orchestration
|
|
78
78
|
|
|
79
|
-
|
|
79
|
+
Call GPT/Gemini directly with hook prefixes:
|
|
80
80
|
|
|
81
|
-
| LLM | Prefix |
|
|
82
|
-
|
|
83
|
-
| GPT | `gpt-`, `gpt
|
|
84
|
-
| Gemini | `gemini-`, `gemini
|
|
81
|
+
| LLM | Prefix | Example | Features |
|
|
82
|
+
|-----|--------|---------|----------|
|
|
83
|
+
| GPT | `gpt-`, `gpt.` | `gpt.weather today` | Web Search enabled |
|
|
84
|
+
| Gemini | `gemini-`, `gemini.` | `gemini.UI improvements` | Google Search enabled |
|
|
85
85
|
|
|
86
|
-
|
|
|
87
|
-
|
|
88
|
-
|
|
|
89
|
-
| UI/UX
|
|
90
|
-
|
|
|
91
|
-
|
|
|
86
|
+
| Scenario | Recommended | Example |
|
|
87
|
+
|----------|-------------|---------|
|
|
88
|
+
| Latest info search | GPT | `gpt.React 19 changes` |
|
|
89
|
+
| UI/UX review | Gemini | `gemini.improve this form UX` |
|
|
90
|
+
| Architecture review | GPT | `gpt-review this architecture` |
|
|
91
|
+
| Code analysis | Gemini | `gemini-analyze this code` |
|
|
92
92
|
|
|
93
|
-
|
|
93
|
+
**Direct API call:**
|
|
94
94
|
|
|
95
95
|
```javascript
|
|
96
|
-
import('@su-record/vibe/lib/gpt').then(g => g.quickWebSearch('
|
|
97
|
-
import('@su-record/vibe/lib/gemini').then(g => g.quickAsk('
|
|
96
|
+
import('@su-record/vibe/lib/gpt').then(g => g.quickWebSearch('weather today'))
|
|
97
|
+
import('@su-record/vibe/lib/gemini').then(g => g.quickAsk('question'))
|
|
98
98
|
```
|
|
99
99
|
|
|
100
|
-
##
|
|
100
|
+
## Parallel Review Agents
|
|
101
101
|
|
|
102
|
-
`/vibe.review`
|
|
102
|
+
`/vibe.review` runs 13+ agents concurrently:
|
|
103
103
|
|
|
104
|
-
|
|
|
105
|
-
|
|
106
|
-
|
|
|
107
|
-
|
|
|
108
|
-
|
|
|
109
|
-
|
|
|
110
|
-
|
|
|
104
|
+
| Category | Agents |
|
|
105
|
+
|----------|--------|
|
|
106
|
+
| Security | security-reviewer, data-integrity-reviewer |
|
|
107
|
+
| Performance | performance-reviewer, complexity-reviewer |
|
|
108
|
+
| Architecture | architecture-reviewer, simplicity-reviewer |
|
|
109
|
+
| Language | python, typescript, rails, react reviewers |
|
|
110
|
+
| Context | git-history, test-coverage reviewers |
|
|
111
111
|
|
|
112
|
-
|
|
113
|
-
- 🔴 P1 (Critical):
|
|
114
|
-
- 🟡 P2 (Important):
|
|
115
|
-
- 🔵 P3 (Nice-to-have):
|
|
112
|
+
**Priority:**
|
|
113
|
+
- 🔴 P1 (Critical): Blocks merge
|
|
114
|
+
- 🟡 P2 (Important): Recommended fix
|
|
115
|
+
- 🔵 P3 (Nice-to-have): Backlog
|
|
116
116
|
|
|
117
|
-
##
|
|
117
|
+
## Built-in Tools
|
|
118
118
|
|
|
119
|
-
|
|
|
120
|
-
|
|
121
|
-
| `vibe_find_symbol` |
|
|
122
|
-
| `vibe_find_references` |
|
|
123
|
-
| `vibe_analyze_complexity` |
|
|
124
|
-
| `vibe_validate_code_quality` |
|
|
125
|
-
| `vibe_start_session` |
|
|
126
|
-
| `vibe_save_memory` |
|
|
127
|
-
| `vibe_auto_save_context` |
|
|
119
|
+
| Tool | Description |
|
|
120
|
+
|------|-------------|
|
|
121
|
+
| `vibe_find_symbol` | Find symbol definition |
|
|
122
|
+
| `vibe_find_references` | Find references |
|
|
123
|
+
| `vibe_analyze_complexity` | Complexity analysis |
|
|
124
|
+
| `vibe_validate_code_quality` | Quality validation |
|
|
125
|
+
| `vibe_start_session` | Start session (restore previous context) |
|
|
126
|
+
| `vibe_save_memory` | Save important decisions |
|
|
127
|
+
| `vibe_auto_save_context` | Auto-save current state |
|
|
128
128
|
|
|
129
|
-
##
|
|
129
|
+
## Project Structure
|
|
130
130
|
|
|
131
|
-
|
|
131
|
+
**Global install (`~/.claude/`):**
|
|
132
132
|
|
|
133
133
|
```text
|
|
134
134
|
~/.claude/
|
|
135
|
-
├── commands/ #
|
|
136
|
-
├── agents/ #
|
|
137
|
-
├── skills/ #
|
|
138
|
-
└── settings.json # Hooks + MCP
|
|
135
|
+
├── commands/ # Slash commands (7)
|
|
136
|
+
├── agents/ # Review/research agents
|
|
137
|
+
├── skills/ # Auto-activated guides (7)
|
|
138
|
+
└── settings.json # Hooks + MCP settings
|
|
139
139
|
```
|
|
140
140
|
|
|
141
|
-
|
|
141
|
+
**Project-specific (`project/.claude/vibe/`):**
|
|
142
142
|
|
|
143
143
|
```text
|
|
144
144
|
.claude/vibe/
|
|
145
|
-
├── specs/ # SPEC
|
|
146
|
-
├── features/ # BDD
|
|
147
|
-
├── rules/ #
|
|
148
|
-
├── solutions/ #
|
|
149
|
-
├── config.json #
|
|
150
|
-
└── constitution.md #
|
|
145
|
+
├── specs/ # SPEC documents
|
|
146
|
+
├── features/ # BDD scenarios
|
|
147
|
+
├── rules/ # Coding rules (per stack)
|
|
148
|
+
├── solutions/ # Solution archive
|
|
149
|
+
├── config.json # Project settings
|
|
150
|
+
└── constitution.md # Project principles
|
|
151
151
|
```
|
|
152
152
|
|
|
153
|
-
##
|
|
153
|
+
## Code Quality Standards
|
|
154
154
|
|
|
155
|
-
|
|
|
156
|
-
|
|
157
|
-
|
|
|
158
|
-
|
|
|
159
|
-
|
|
|
160
|
-
|
|
|
155
|
+
| Metric | Limit |
|
|
156
|
+
|--------|-------|
|
|
157
|
+
| Function length | 30 lines recommended, 50 allowed |
|
|
158
|
+
| Nesting depth | 3 levels max |
|
|
159
|
+
| Parameters | 5 max |
|
|
160
|
+
| Cyclomatic complexity | 10 max |
|
|
161
161
|
|
|
162
|
-
##
|
|
162
|
+
## Usage Example
|
|
163
163
|
|
|
164
164
|
```
|
|
165
|
-
User: /vibe.spec "
|
|
165
|
+
User: /vibe.spec "login feature"
|
|
166
166
|
|
|
167
|
-
Claude:
|
|
168
|
-
1.
|
|
169
|
-
2.
|
|
167
|
+
Claude: You're building a login feature! I have a few questions.
|
|
168
|
+
1. Auth method? (email/password, OAuth, Passkey)
|
|
169
|
+
2. Tech stack?
|
|
170
170
|
...
|
|
171
171
|
|
|
172
|
-
[
|
|
173
|
-
[4
|
|
172
|
+
[Requirements confirmed via conversation]
|
|
173
|
+
[4 parallel research agents run]
|
|
174
174
|
|
|
175
|
-
✅ SPEC
|
|
175
|
+
✅ SPEC document created
|
|
176
176
|
📄 .claude/vibe/specs/login.md
|
|
177
177
|
📄 .claude/vibe/features/login.feature
|
|
178
178
|
|
|
179
|
-
|
|
179
|
+
Next: /vibe.run "login feature" ultrawork
|
|
180
180
|
```
|
|
181
181
|
|
|
182
|
-
##
|
|
182
|
+
## Requirements
|
|
183
183
|
|
|
184
184
|
- Node.js 18.0.0+
|
|
185
185
|
- Claude Code
|
|
186
186
|
|
|
187
|
-
##
|
|
187
|
+
## License
|
|
188
188
|
|
|
189
189
|
MIT - [GitHub](https://github.com/su-record/vibe)
|
|
190
190
|
|
|
191
191
|
## Vibe Setup (AI Coding)
|
|
192
192
|
|
|
193
|
-
|
|
193
|
+
This project uses [Vibe](https://github.com/su-record/vibe) AI coding framework.
|
|
194
194
|
|
|
195
|
-
###
|
|
195
|
+
### Collaborator Install
|
|
196
196
|
|
|
197
197
|
```bash
|
|
198
|
-
#
|
|
198
|
+
# Global install (recommended)
|
|
199
199
|
npm install -g @su-record/vibe
|
|
200
200
|
vibe update
|
|
201
201
|
|
|
202
|
-
#
|
|
202
|
+
# Or run setup script
|
|
203
203
|
./.claude/vibe/setup.sh
|
|
204
204
|
```
|
|
205
205
|
|
|
206
|
-
###
|
|
206
|
+
### Usage
|
|
207
207
|
|
|
208
|
-
|
|
209
|
-
- `/vibe.spec "
|
|
210
|
-
- `/vibe.run "
|
|
208
|
+
Use slash commands in Claude Code:
|
|
209
|
+
- `/vibe.spec "feature"` - Create SPEC document
|
|
210
|
+
- `/vibe.run "feature"` - Execute implementation
|
package/dist/cli/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAoiBH,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,qBAAqB,IAAI,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAErF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC"}
|