@su-record/vibe 1.1.7 → 1.1.9
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.spec.md +69 -1
- package/README.md +9 -0
- package/package.json +1 -1
|
@@ -202,7 +202,53 @@ Scenario: {제목}
|
|
|
202
202
|
| 1 | AC-1 | ⬜ |
|
|
203
203
|
```
|
|
204
204
|
|
|
205
|
-
### 5.
|
|
205
|
+
### 5. 모호성 스캔 (Ambiguity Scan) - 필수
|
|
206
|
+
|
|
207
|
+
SPEC 초안 작성 후, **반드시 체계적인 모호성 검사**를 수행합니다.
|
|
208
|
+
|
|
209
|
+
**검사 카테고리:**
|
|
210
|
+
|
|
211
|
+
| 카테고리 | 검사 항목 |
|
|
212
|
+
|----------|-----------|
|
|
213
|
+
| **Functional Scope** | 누락된 기능, 불명확한 동작 정의 |
|
|
214
|
+
| **Data Model** | 정의되지 않은 엔티티, 불명확한 관계 |
|
|
215
|
+
| **Non-Functional** | 성능 요구사항, 보안 고려사항 누락 |
|
|
216
|
+
| **Edge Cases** | 경계 조건, 에러 처리 시나리오 |
|
|
217
|
+
| **Integration Points** | 외부 시스템 연동, API 계약 |
|
|
218
|
+
|
|
219
|
+
**검사 프로세스:**
|
|
220
|
+
|
|
221
|
+
```
|
|
222
|
+
1. SPEC 초안 작성
|
|
223
|
+
↓
|
|
224
|
+
2. 카테고리별 모호성 스캔
|
|
225
|
+
↓
|
|
226
|
+
3. 발견된 모호성 목록 제시
|
|
227
|
+
↓
|
|
228
|
+
4. 사용자 확인/명확화 요청
|
|
229
|
+
↓
|
|
230
|
+
5. SPEC 보완
|
|
231
|
+
↓
|
|
232
|
+
6. 재검사 (모호성 0이 될 때까지)
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
**모호성 발견 시 출력 형식:**
|
|
236
|
+
|
|
237
|
+
```markdown
|
|
238
|
+
## 🔍 모호성 스캔 결과
|
|
239
|
+
|
|
240
|
+
### Functional Scope
|
|
241
|
+
- ⚠️ "로그인 실패 시 동작"이 정의되지 않음
|
|
242
|
+
- ⚠️ "세션 만료 처리"가 불명확
|
|
243
|
+
|
|
244
|
+
### Edge Cases
|
|
245
|
+
- ⚠️ 동시 로그인 허용 여부 미정의
|
|
246
|
+
- ⚠️ 비밀번호 재시도 횟수 제한 없음
|
|
247
|
+
|
|
248
|
+
위 항목들을 명확히 해주세요.
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
### 6. 품질 검증
|
|
206
252
|
|
|
207
253
|
`.vibe/rules/quality/checklist.md` 기준 자체 평가 (0-100점)
|
|
208
254
|
|
|
@@ -210,6 +256,7 @@ Scenario: {제목}
|
|
|
210
256
|
|
|
211
257
|
- `.vibe/specs/{기능명}.md` - PTCF 구조 SPEC
|
|
212
258
|
- `.vibe/features/{기능명}.feature` - BDD Feature 파일
|
|
259
|
+
- 모호성 스캔 결과 (모호성 0 확인)
|
|
213
260
|
- 품질 점수 및 개선 제안
|
|
214
261
|
|
|
215
262
|
## Example
|
|
@@ -255,9 +302,30 @@ User: 2
|
|
|
255
302
|
|
|
256
303
|
[대화 계속...]
|
|
257
304
|
|
|
305
|
+
Claude: SPEC 초안을 작성했습니다. 모호성 스캔을 수행합니다.
|
|
306
|
+
|
|
307
|
+
## 🔍 모호성 스캔 결과
|
|
308
|
+
|
|
309
|
+
### Functional Scope
|
|
310
|
+
- ⚠️ 게임 오버 조건이 정의되지 않음 (공 낙하 vs 목숨 시스템)
|
|
311
|
+
- ⚠️ 스테이지 클리어 조건 불명확
|
|
312
|
+
|
|
313
|
+
### Edge Cases
|
|
314
|
+
- ⚠️ 공이 패들 모서리에 맞을 때 반사각 처리
|
|
315
|
+
- ⚠️ 동시에 여러 벽돌 충돌 시 처리
|
|
316
|
+
|
|
317
|
+
위 항목들을 명확히 해주세요.
|
|
318
|
+
|
|
319
|
+
User: 목숨 3개, 모든 벽돌 파괴시 클리어, 모서리는 45도 반사
|
|
320
|
+
|
|
321
|
+
Claude: 감사합니다. SPEC을 보완했습니다.
|
|
322
|
+
|
|
323
|
+
🔍 재검사 결과: 모호성 0개
|
|
324
|
+
|
|
258
325
|
✅ SPEC 문서 작성 완료!
|
|
259
326
|
📄 .vibe/specs/brick-game.md (PTCF 구조)
|
|
260
327
|
📄 .vibe/features/brick-game.feature
|
|
328
|
+
📊 품질 점수: 92/100 (A)
|
|
261
329
|
```
|
|
262
330
|
|
|
263
331
|
## Next Step
|
package/README.md
CHANGED
|
@@ -36,6 +36,7 @@ npm install -g @su-record/vibe
|
|
|
36
36
|
```bash
|
|
37
37
|
# 기존 프로젝트에서
|
|
38
38
|
vibe init
|
|
39
|
+
# → hi-ai MCP가 .vibe/mcp/에 로컬 설치됨
|
|
39
40
|
|
|
40
41
|
# 새 프로젝트 생성
|
|
41
42
|
vibe init my-project
|
|
@@ -245,6 +246,14 @@ AI의 역할과 전문성 정의
|
|
|
245
246
|
|
|
246
247
|
> **Note**: hi-ai MCP는 프로젝트별 `.vibe/mcp/` 폴더에 로컬 설치되어 안정적으로 작동합니다.
|
|
247
248
|
|
|
249
|
+
### Hooks (자동 설정)
|
|
250
|
+
|
|
251
|
+
| Hook | 트리거 | 동작 |
|
|
252
|
+
|------|--------|------|
|
|
253
|
+
| `SessionStart` | 세션 시작 | 이전 컨텍스트 자동 복원 |
|
|
254
|
+
| `PostToolUse` | Write/Edit 후 | 품질 체크리스트 검토 |
|
|
255
|
+
| `Notification` | 컨텍스트 70/85/95% | 저장 알림 |
|
|
256
|
+
|
|
248
257
|
### 선택적 연동 (외부 LLM)
|
|
249
258
|
|
|
250
259
|
| MCP 서버 | 명령어 | 설명 |
|