@su-record/vibe 0.1.4 → 0.1.7
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/commands/vibe.analyze.md +123 -0
- package/.claude/commands/vibe.diagram.md +174 -0
- package/.claude/commands/vibe.plan.md +75 -0
- package/.claude/commands/vibe.run.md +151 -0
- package/.claude/commands/vibe.spec.md +273 -0
- package/.claude/commands/vibe.tasks.md +77 -0
- package/.claude/commands/vibe.ui.md +133 -0
- package/.claude/commands/vibe.verify.md +128 -0
- package/.claude/settings.local.json +14 -0
- package/README.md +159 -104
- package/bin/vibe +94 -225
- package/package.json +3 -2
- package/skills/quality/bdd-contract-testing.md +388 -0
- package/templates/contract-backend-template.md +517 -0
- package/templates/contract-frontend-template.md +594 -0
- package/templates/feature-template.md +259 -0
- package/templates/spec-template.md +60 -3
package/bin/vibe
CHANGED
|
@@ -8,19 +8,9 @@
|
|
|
8
8
|
const path = require('path');
|
|
9
9
|
const fs = require('fs');
|
|
10
10
|
|
|
11
|
-
// 명령어 목록
|
|
11
|
+
// 명령어 목록 (Claude Code 전용)
|
|
12
12
|
const commands = {
|
|
13
|
-
init: 'Initialize vibe in current project',
|
|
14
|
-
spec: 'Create/manage SPEC documents',
|
|
15
|
-
plan: 'Create technical implementation plan',
|
|
16
|
-
tasks: 'Break down SPEC into actionable tasks',
|
|
17
|
-
run: 'Run task implementation (with auto guide generation)',
|
|
18
|
-
verify: 'Verify implementation against SPEC',
|
|
19
|
-
analyze: 'Analyze project (code quality, architecture, dependencies)',
|
|
20
|
-
ui: 'Preview UI with ASCII art',
|
|
21
|
-
diagram: 'Generate diagrams (architecture, ERD, flow)',
|
|
22
|
-
agents: 'List available agents',
|
|
23
|
-
skills: 'List installed skills',
|
|
13
|
+
init: 'Initialize vibe in current project (MCP registration)',
|
|
24
14
|
help: 'Show help message'
|
|
25
15
|
};
|
|
26
16
|
|
|
@@ -30,50 +20,40 @@ const command = args[0];
|
|
|
30
20
|
// 도움말 출력
|
|
31
21
|
function showHelp() {
|
|
32
22
|
console.log(`
|
|
33
|
-
📖
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
init
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
analyze
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
diagram Generate architecture diagram
|
|
53
|
-
diagram --er Generate ERD diagram
|
|
54
|
-
|
|
55
|
-
agents List available agents
|
|
56
|
-
skills List installed skills
|
|
57
|
-
help Show this message
|
|
23
|
+
📖 Vibe - SPEC-driven AI coding framework for Claude Code
|
|
24
|
+
|
|
25
|
+
⚠️ Vibe는 Claude Code 전용 프레임워크입니다.
|
|
26
|
+
터미널에서는 초기화만 가능합니다.
|
|
27
|
+
|
|
28
|
+
터미널 명령어:
|
|
29
|
+
vibe init Initialize vibe in current project
|
|
30
|
+
vibe init <project-name> Create new project with vibe
|
|
31
|
+
vibe help Show this message
|
|
32
|
+
|
|
33
|
+
Claude Code 슬래시 커맨드 (프로젝트 내에서 사용):
|
|
34
|
+
/vibe.spec "기능명" SPEC 작성 (대화형 Q&A)
|
|
35
|
+
/vibe.plan "기능명" 기술 계획 작성
|
|
36
|
+
/vibe.tasks "기능명" Task 목록 생성
|
|
37
|
+
/vibe.run "Task 1-1" Task 구현
|
|
38
|
+
/vibe.verify "기능명" 검증
|
|
39
|
+
/vibe.analyze 프로젝트 분석
|
|
40
|
+
/vibe.ui "설명" UI 미리보기
|
|
41
|
+
/vibe.diagram --er 다이어그램 생성
|
|
58
42
|
|
|
59
43
|
Workflow:
|
|
60
|
-
1. vibe
|
|
61
|
-
2.
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
$ vibe run --all # 전체 실행
|
|
74
|
-
|
|
75
|
-
More info:
|
|
76
|
-
https://github.com/your-username/vibe
|
|
44
|
+
1. 터미널에서 vibe init 실행 (MCP 서버 등록)
|
|
45
|
+
2. Claude Code에서 슬래시 커맨드 사용
|
|
46
|
+
/vibe.spec "푸시 알림 설정"
|
|
47
|
+
/vibe.plan "푸시 알림 설정"
|
|
48
|
+
/vibe.tasks "푸시 알림 설정"
|
|
49
|
+
/vibe.run "Task 1-1"
|
|
50
|
+
/vibe.verify "푸시 알림 설정"
|
|
51
|
+
|
|
52
|
+
설치:
|
|
53
|
+
npm install -g @su-record/vibe
|
|
54
|
+
|
|
55
|
+
문서:
|
|
56
|
+
https://github.com/su-record/vibe/wiki
|
|
77
57
|
`);
|
|
78
58
|
}
|
|
79
59
|
|
|
@@ -84,8 +64,25 @@ function showVersion() {
|
|
|
84
64
|
}
|
|
85
65
|
|
|
86
66
|
// 프로젝트 초기화
|
|
87
|
-
function init() {
|
|
88
|
-
|
|
67
|
+
function init(projectName) {
|
|
68
|
+
let projectRoot = process.cwd();
|
|
69
|
+
let isNewProject = false;
|
|
70
|
+
|
|
71
|
+
// 새 프로젝트 생성 케이스
|
|
72
|
+
if (projectName) {
|
|
73
|
+
projectRoot = path.join(process.cwd(), projectName);
|
|
74
|
+
|
|
75
|
+
if (fs.existsSync(projectRoot)) {
|
|
76
|
+
console.log(`❌ 폴더가 이미 존재합니다: ${projectName}/`);
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
console.log(`📁 새 프로젝트 생성: ${projectName}/\n`);
|
|
81
|
+
fs.mkdirSync(projectRoot, { recursive: true });
|
|
82
|
+
isNewProject = true;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
const vibeDir = path.join(projectRoot, '.vibe');
|
|
89
86
|
|
|
90
87
|
if (fs.existsSync(vibeDir)) {
|
|
91
88
|
console.log('❌ .vibe/ 폴더가 이미 존재합니다.');
|
|
@@ -112,6 +109,28 @@ function init() {
|
|
|
112
109
|
fs.mkdirSync(path.join(vibeDir, 'plans'));
|
|
113
110
|
fs.mkdirSync(path.join(vibeDir, 'tasks'));
|
|
114
111
|
|
|
112
|
+
// .claude/commands 폴더 생성 및 슬래시 커맨드 복사
|
|
113
|
+
const claudeDir = path.join(projectRoot, '.claude');
|
|
114
|
+
const commandsDir = path.join(claudeDir, 'commands');
|
|
115
|
+
|
|
116
|
+
if (!fs.existsSync(claudeDir)) {
|
|
117
|
+
fs.mkdirSync(claudeDir);
|
|
118
|
+
}
|
|
119
|
+
if (!fs.existsSync(commandsDir)) {
|
|
120
|
+
fs.mkdirSync(commandsDir);
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
// 슬래시 커맨드 파일들 복사
|
|
124
|
+
const sourceCommandsDir = path.join(__dirname, '../.claude/commands');
|
|
125
|
+
if (fs.existsSync(sourceCommandsDir)) {
|
|
126
|
+
const commandFiles = fs.readdirSync(sourceCommandsDir);
|
|
127
|
+
commandFiles.forEach(file => {
|
|
128
|
+
const sourcePath = path.join(sourceCommandsDir, file);
|
|
129
|
+
const destPath = path.join(commandsDir, file);
|
|
130
|
+
fs.copyFileSync(sourcePath, destPath);
|
|
131
|
+
});
|
|
132
|
+
}
|
|
133
|
+
|
|
115
134
|
// constitution.md 템플릿 복사
|
|
116
135
|
const templatePath = path.join(__dirname, '../templates/constitution-template.md');
|
|
117
136
|
const constitutionPath = path.join(vibeDir, 'constitution.md');
|
|
@@ -141,7 +160,11 @@ function init() {
|
|
|
141
160
|
console.log(`
|
|
142
161
|
✅ vibe 초기화 완료!
|
|
143
162
|
|
|
144
|
-
|
|
163
|
+
${isNewProject ? `프로젝트 위치:
|
|
164
|
+
${projectRoot}/
|
|
165
|
+
|
|
166
|
+
` : ''}생성된 구조:
|
|
167
|
+
.claude/commands/ # 슬래시 커맨드 (8개)
|
|
145
168
|
.vibe/
|
|
146
169
|
├── config.json # 프로젝트 설정 (언어: 한국어)
|
|
147
170
|
├── constitution.md # 프로젝트 원칙
|
|
@@ -157,67 +180,17 @@ MCP 서버:
|
|
|
157
180
|
.vibe/config.json에서 "language"를 "en" 또는 "ko"로 변경
|
|
158
181
|
|
|
159
182
|
다음 단계:
|
|
160
|
-
|
|
183
|
+
${isNewProject ? `1. cd ${projectName}\n 2. ` : ''}Claude Code에서 슬래시 커맨드 사용:
|
|
184
|
+
/vibe.spec "기능명"
|
|
185
|
+
/vibe.plan "기능명"
|
|
161
186
|
`);
|
|
162
187
|
}
|
|
163
188
|
|
|
164
|
-
// 에이전트 목록
|
|
165
|
-
function listAgents() {
|
|
166
|
-
const agentsDir = path.join(__dirname, '../agents');
|
|
167
|
-
const agents = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'));
|
|
168
|
-
|
|
169
|
-
console.log('\n🤖 사용 가능한 에이전트:\n');
|
|
170
|
-
agents.forEach((agent, i) => {
|
|
171
|
-
const name = agent.replace('.md', '');
|
|
172
|
-
console.log(` ${i + 1}. ${name}`);
|
|
173
|
-
});
|
|
174
|
-
console.log('');
|
|
175
|
-
}
|
|
176
|
-
|
|
177
|
-
// 스킬 목록
|
|
178
|
-
function listSkills() {
|
|
179
|
-
const skillsDir = path.join(__dirname, '../skills');
|
|
180
|
-
const categories = fs.readdirSync(skillsDir).filter(f => {
|
|
181
|
-
return fs.statSync(path.join(skillsDir, f)).isDirectory();
|
|
182
|
-
});
|
|
183
|
-
|
|
184
|
-
console.log('\n📚 설치된 스킬:\n');
|
|
185
|
-
categories.forEach(category => {
|
|
186
|
-
const skills = fs.readdirSync(path.join(skillsDir, category))
|
|
187
|
-
.filter(f => f.endsWith('.md'));
|
|
188
|
-
console.log(` ${category}/`);
|
|
189
|
-
skills.forEach(skill => {
|
|
190
|
-
console.log(` - ${skill.replace('.md', '')}`);
|
|
191
|
-
});
|
|
192
|
-
});
|
|
193
|
-
console.log('');
|
|
194
|
-
}
|
|
195
|
-
|
|
196
|
-
// Claude Code와 통합 (추후 구현)
|
|
197
|
-
function delegateToClaudeCode(command, args) {
|
|
198
|
-
console.log(`
|
|
199
|
-
⚠️ 이 명령어는 Claude Code와 통합이 필요합니다.
|
|
200
|
-
|
|
201
|
-
지금은 수동으로 Claude Code를 열고 다음과 같이 요청하세요:
|
|
202
|
-
|
|
203
|
-
"${command} ${args.join(' ')}"
|
|
204
|
-
|
|
205
|
-
향후 업데이트에서 자동화될 예정입니다.
|
|
206
|
-
`);
|
|
207
|
-
}
|
|
208
189
|
|
|
209
190
|
// 메인 라우터
|
|
210
191
|
switch (command) {
|
|
211
192
|
case 'init':
|
|
212
|
-
init();
|
|
213
|
-
break;
|
|
214
|
-
|
|
215
|
-
case 'agents':
|
|
216
|
-
listAgents();
|
|
217
|
-
break;
|
|
218
|
-
|
|
219
|
-
case 'skills':
|
|
220
|
-
listSkills();
|
|
193
|
+
init(args[1]);
|
|
221
194
|
break;
|
|
222
195
|
|
|
223
196
|
case 'version':
|
|
@@ -233,124 +206,20 @@ switch (command) {
|
|
|
233
206
|
showHelp();
|
|
234
207
|
break;
|
|
235
208
|
|
|
236
|
-
// vibe run 명령어 (새로운 구현 워크플로우)
|
|
237
|
-
case 'run':
|
|
238
|
-
handleRunCommand(args.slice(1));
|
|
239
|
-
break;
|
|
240
|
-
|
|
241
|
-
// Claude Code 위임이 필요한 명령어들
|
|
242
|
-
case 'spec':
|
|
243
|
-
case 'plan':
|
|
244
|
-
case 'tasks':
|
|
245
|
-
case 'verify':
|
|
246
|
-
case 'analyze':
|
|
247
|
-
case 'ui':
|
|
248
|
-
case 'diagram':
|
|
249
|
-
delegateToClaudeCode(command, args.slice(1));
|
|
250
|
-
break;
|
|
251
|
-
|
|
252
209
|
default:
|
|
253
|
-
console.log(`❌ 알 수 없는 명령어: ${command}`);
|
|
254
|
-
console.log('사용법을 보려면: vibe help');
|
|
255
|
-
process.exit(1);
|
|
256
|
-
}
|
|
257
|
-
|
|
258
|
-
// vibe run 명령어 핸들러
|
|
259
|
-
function handleRunCommand(args) {
|
|
260
|
-
const option = args[0];
|
|
261
|
-
|
|
262
|
-
if (!option) {
|
|
263
|
-
console.log(`
|
|
264
|
-
❌ 사용법: vibe run <task-id> | --phase <N> | --all
|
|
265
|
-
|
|
266
|
-
예시:
|
|
267
|
-
vibe run "Task 1-1" # 특정 Task 실행
|
|
268
|
-
vibe run --phase 1 # Phase 1 전체 실행
|
|
269
|
-
vibe run --all # 모든 Task 실행
|
|
270
|
-
`);
|
|
271
|
-
return;
|
|
272
|
-
}
|
|
273
|
-
|
|
274
|
-
// --all 플래그 처리
|
|
275
|
-
if (option === '--all') {
|
|
276
210
|
console.log(`
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
Claude Code에 다음과 같이 요청하세요:
|
|
211
|
+
❌ 알 수 없는 명령어: ${command}
|
|
280
212
|
|
|
281
|
-
|
|
213
|
+
⚠️ Vibe는 Claude Code 전용 프레임워크입니다.
|
|
214
|
+
터미널에서는 'init'만 사용 가능합니다.
|
|
282
215
|
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
216
|
+
Claude Code에서 슬래시 커맨드를 사용하세요:
|
|
217
|
+
/vibe.spec "기능명"
|
|
218
|
+
/vibe.plan "기능명"
|
|
219
|
+
/vibe.tasks "기능명"
|
|
220
|
+
/vibe.run "Task 1-1"
|
|
287
221
|
|
|
288
|
-
|
|
222
|
+
사용법: vibe help
|
|
289
223
|
`);
|
|
290
|
-
|
|
291
|
-
}
|
|
292
|
-
|
|
293
|
-
// --phase 플래그 처리
|
|
294
|
-
if (option === '--phase') {
|
|
295
|
-
const phaseNumber = args[1];
|
|
296
|
-
if (!phaseNumber) {
|
|
297
|
-
console.log(`❌ Phase 번호를 지정하세요: vibe run --phase <1|2|3>`);
|
|
298
|
-
return;
|
|
299
|
-
}
|
|
300
|
-
|
|
301
|
-
console.log(`
|
|
302
|
-
🚀 Phase ${phaseNumber} 실행 시작...
|
|
303
|
-
|
|
304
|
-
Claude Code에 다음과 같이 요청하세요:
|
|
305
|
-
|
|
306
|
-
"vibe run --phase ${phaseNumber} 실행해줘. TASKS 문서의 Phase ${phaseNumber} Task들을 순차적으로 구현해줘."
|
|
307
|
-
|
|
308
|
-
Phase ${phaseNumber} 작업 목록:
|
|
309
|
-
${getPhaseTaskList(phaseNumber)}
|
|
310
|
-
|
|
311
|
-
예상 시간: ${getPhaseEstimatedTime(phaseNumber)}
|
|
312
|
-
`);
|
|
313
|
-
return;
|
|
314
|
-
}
|
|
315
|
-
|
|
316
|
-
// 특정 Task 실행
|
|
317
|
-
const taskId = option;
|
|
318
|
-
console.log(`
|
|
319
|
-
🚀 Task 실행: "${taskId}"
|
|
320
|
-
|
|
321
|
-
Claude Code에 다음과 같이 요청하세요:
|
|
322
|
-
|
|
323
|
-
"vibe run '${taskId}' 실행해줘. 다음 순서로 진행해줘:
|
|
324
|
-
|
|
325
|
-
1. TASKS 문서에서 '${taskId}' 찾기
|
|
326
|
-
2. 구현 가이드 생성 (.vibe/guides/${taskId}.md)
|
|
327
|
-
3. 가이드에 따라 코드 구현
|
|
328
|
-
4. Acceptance Criteria 검증
|
|
329
|
-
5. Task 상태를 ✅ 완료로 업데이트"
|
|
330
|
-
|
|
331
|
-
구현 가이드 생성 위치:
|
|
332
|
-
.vibe/guides/${taskId.replace(/\s+/g, '-').toLowerCase()}.md
|
|
333
|
-
|
|
334
|
-
검증 명령어는 TASKS 문서 참고
|
|
335
|
-
`);
|
|
336
|
-
}
|
|
337
|
-
|
|
338
|
-
// Phase별 Task 목록 (하드코딩 - 추후 TASKS 파일에서 파싱)
|
|
339
|
-
function getPhaseTaskList(phase) {
|
|
340
|
-
const phases = {
|
|
341
|
-
'1': 'Task 1-1 ~ 1-8 (Backend 개발)',
|
|
342
|
-
'2': 'Task 2-1 ~ 2-8 (Frontend 개발)',
|
|
343
|
-
'3': 'Task 3-1 ~ 3-3 (FCM 연동 및 테스트)'
|
|
344
|
-
};
|
|
345
|
-
return phases[phase] || '알 수 없는 Phase';
|
|
346
|
-
}
|
|
347
|
-
|
|
348
|
-
// Phase별 예상 시간
|
|
349
|
-
function getPhaseEstimatedTime(phase) {
|
|
350
|
-
const times = {
|
|
351
|
-
'1': '8시간 (1일)',
|
|
352
|
-
'2': '12시간 (1.5일)',
|
|
353
|
-
'3': '4시간 (0.5일)'
|
|
354
|
-
};
|
|
355
|
-
return times[phase] || '알 수 없음';
|
|
224
|
+
process.exit(1);
|
|
356
225
|
}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@su-record/vibe",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "Vibe - SPEC-driven AI coding framework
|
|
3
|
+
"version": "0.1.7",
|
|
4
|
+
"description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework",
|
|
5
5
|
"main": "cli/index.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"vibe": "./bin/vibe"
|
|
@@ -38,6 +38,7 @@
|
|
|
38
38
|
"files": [
|
|
39
39
|
"bin/",
|
|
40
40
|
"cli/",
|
|
41
|
+
".claude/",
|
|
41
42
|
"agents/",
|
|
42
43
|
"skills/",
|
|
43
44
|
"templates/",
|