@su-record/vibe 1.2.21 → 1.3.0

package/.claude/commands/vibe.run.md

@@ -5,7 +5,9 @@ argument-hint: "feature name" or --phase N
 
 # /vibe.run
 
-Execute implementation based on SPEC (Implementation Agent with Multi-Model Orchestration).
+Execute **Scenario-Driven Implementation** with automatic quality verification.
+
+> **핵심 원칙**: 시나리오가 곧 구현 단위이자 검증 기준. 모든 시나리오 통과 = 품질 보장.
 
 ## Usage
 
@@ -18,6 +20,92 @@ Execute implementation based on SPEC (Implementation Agent with Multi-Model Orch
 
 ---
 
+## **Scenario-Driven Development (SDD)**
+
+> 비개발자도 품질을 신뢰할 수 있도록, **시나리오 = 구현 = 검증**을 자동화
+
+### 핵심 흐름
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    SCENARIO-DRIVEN IMPLEMENTATION                │
+│                                                                  │
+│   Feature 파일 로드                                              │
+│        ↓                                                        │
+│   ┌──────────────────────────────────────────────────────────┐  │
+│   │ Scenario 1: Happy Path                                    │  │
+│   │   Given → When → Then                                     │  │
+│   │        ↓                                                  │  │
+│   │   [구현] → [즉시 검증] → ✅ Pass                          │  │
+│   └──────────────────────────────────────────────────────────┘  │
+│        ↓                                                        │
+│   ┌──────────────────────────────────────────────────────────┐  │
+│   │ Scenario 2: Edge Case                                     │  │
+│   │   Given → When → Then                                     │  │
+│   │        ↓                                                  │  │
+│   │   [구현] → [즉시 검증] → ❌ Fail → [수정] → ✅ Pass       │  │
+│   └──────────────────────────────────────────────────────────┘  │
+│        ↓                                                        │
+│   ┌──────────────────────────────────────────────────────────┐  │
+│   │ Scenario N: ...                                           │  │
+│   │   [구현] → [즉시 검증] → ✅ Pass                          │  │
+│   └──────────────────────────────────────────────────────────┘  │
+│        ↓                                                        │
+│   ┌──────────────────────────────────────────────────────────┐  │
+│   │  📊 QUALITY REPORT                                        │  │
+│   │  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━   │  │
+│   │  시나리오: 5/5 통과 ✅                                    │  │
+│   │  품질 점수: 94/100                                        │  │
+│   │  빌드: ✅ | 테스트: ✅                                    │  │
+│   └──────────────────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### 시나리오 = 구현 단위
+
+**기존 방식 (Phase 기반)**:
+```
+Phase 1 → Phase 2 → Phase 3 → ... → 마지막에 검증
+                                      ↓
+                              "어디서 잘못됐지?"
+```
+
+**SDD 방식 (Scenario 기반)**:
+```
+Scenario 1 → 구현 → 검증 ✅
+Scenario 2 → 구현 → 검증 ✅
+Scenario 3 → 구현 → 검증 ❌ → 수정 → ✅
+...
+전체 통과 = 품질 보장
+```
+
+### 검증 자동화
+
+각 시나리오 구현 후 **자동 검증**:
+
+| 검증 항목 | 자동 체크 |
+|-----------|-----------|
+| Given (전제조건) | 상태/데이터 준비 확인 |
+| When (행동) | 기능 실행 가능 여부 |
+| Then (결과) | 예상 결과 일치 여부 |
+| 코드 품질 | 복잡도, 스타일, 보안 |
+
+### 실패 시 자동 수정
+
+```
+Scenario 검증 실패
+      ↓
+[원인 분석] - 어떤 Then 조건이 실패?
+      ↓
+[수정 구현] - 해당 부분만 수정
+      ↓
+[재검증] - 다시 체크
+      ↓
+통과할 때까지 반복 (최대 3회)
+```
+
+---
+
 ## **ULTRAWORK Mode** (ulw)
 
 > Include `ultrawork` or `ulw` in your command to activate **maximum performance mode**.
@@ -231,31 +319,89 @@ validate_code_quality: Verify quality after implementation
 
 ## Process
 
-### 1. Read SPEC and Config
+### 1. Load SPEC + Feature
 
-Parse `.vibe/specs/{feature-name}.md`:
+```
+📄 .vibe/specs/{feature-name}.md      → SPEC (구조, 제약, 컨텍스트)
+📄 .vibe/features/{feature-name}.feature → Feature (시나리오 = 구현 단위)
+```
 
-| Section | Purpose |
-|---------|---------|
-| `<role>` | AI role definition |
-| `<context>` | Background, tech stack, related code |
-| `<task>` | Phase-by-phase task list |
-| `<constraints>` | Constraints |
-| `<output_format>` | Files to create/modify |
-| `<acceptance>` | Verification criteria |
+**Feature 파일이 없으면 에러**:
+```
+❌ Feature 파일이 없습니다.
+   먼저 /vibe.spec "{feature-name}"을 실행하세요.
+```
 
-Check `.vibe/config.json`:
-- External LLM enablement (`models.gpt.enabled`, `models.gemini.enabled`)
+### 2. Scenario 목록 추출
 
-### 2. Check Feature File
+Feature 파일에서 모든 Scenario 추출:
 
-`.vibe/features/{feature-name}.feature`:
-- Check BDD Scenarios
-- Use as test cases
+```markdown
+## Scenarios to Implement
 
-### 3. Phase-by-Phase Implementation
+| # | Scenario | Status |
+|---|----------|--------|
+| 1 | 유효한 로그인 성공 | ⬜ |
+| 2 | 잘못된 비밀번호 에러 | ⬜ |
+| 3 | 이메일 형식 검증 | ⬜ |
+| 4 | 비밀번호 찾기 링크 | ⬜ |
 
-Follow `<task>` section Phase order.
+Total: 4 scenarios
+```
+
+### 3. Scenario-by-Scenario Implementation (핵심)
+
+**각 시나리오마다**:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 Scenario 1/4: 유효한 로그인 성공
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Given: 사용자가 등록되어 있다
+When: 유효한 이메일과 비밀번호로 로그인
+Then: 로그인 성공 + JWT 토큰 반환
+
+[Step 1] 구현 분석...
+  - 필요한 파일: auth.service.ts, login.controller.ts
+  - 관련 코드 탐색 중...
+
+[Step 2] 구현 중...
+  ✅ auth.service.ts - login() 메서드 추가
+  ✅ login.controller.ts - POST /login 엔드포인트
+
+[Step 3] 검증 중...
+  ✅ Given: 테스트 사용자 생성 가능
+  ✅ When: 로그인 API 호출 성공
+  ✅ Then: JWT 토큰 반환 확인
+
+✅ Scenario 1 통과!
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**실패 시**:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 Scenario 2/4: 잘못된 비밀번호 에러
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[Step 3] 검증 중...
+  ✅ Given: 테스트 사용자 존재
+  ✅ When: 잘못된 비밀번호로 로그인 시도
+  ❌ Then: "Invalid credentials" 에러 메시지
+     실제: "Error occurred" 반환됨
+
+[자동 수정 1/3]
+  원인: 에러 메시지 하드코딩 안됨
+  수정: auth.service.ts line 42
+
+[재검증]
+  ✅ Then: "Invalid credentials" 에러 메시지
+
+✅ Scenario 2 통과! (수정 1회)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
 
 ---
 
@@ -363,24 +509,66 @@ Phase N Complete → Next Phase
 3. **Constraint compliance**: Check `<constraints>`
 4. **Run verification**: Execute verification commands
 
-### 4. Acceptance Criteria Verification
+### 4. Quality Report (자동 생성)
+
+모든 시나리오 완료 후 **품질 리포트 자동 생성**:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  📊 QUALITY REPORT: login                                        │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  ✅ 시나리오: 4/4 통과                                          │
+│                                                                 │
+│  ┌───────────────────────────────────────────────────────────┐  │
+│  │ # │ Scenario                  │ Status │ Retries │        │  │
+│  │───│───────────────────────────│────────│─────────│        │  │
+│  │ 1 │ 유효한 로그인 성공         │ ✅     │ 0       │        │  │
+│  │ 2 │ 잘못된 비밀번호 에러       │ ✅     │ 1       │        │  │
+│  │ 3 │ 이메일 형식 검증           │ ✅     │ 0       │        │  │
+│  │ 4 │ 비밀번호 찾기 링크         │ ✅     │ 0       │        │  │
+│  └───────────────────────────────────────────────────────────┘  │
+│                                                                 │
+│  📈 품질 점수: 94/100                                           │
+│                                                                 │
+│  ┌─────────────────────────────────────────────────────────┐    │
+│  │ 항목              │ 결과  │ 비고                        │    │
+│  │───────────────────│───────│─────────────────────────────│    │
+│  │ 빌드              │ ✅    │ npm run build 성공          │    │
+│  │ 테스트            │ ✅    │ 12/12 통과                  │    │
+│  │ 타입 검사         │ ✅    │ 에러 0개                    │    │
+│  │ 복잡도            │ ✅    │ 모든 함수 ≤20줄            │    │
+│  │ 보안              │ ✅    │ 취약점 0개                  │    │
+│  └─────────────────────────────────────────────────────────┘    │
+│                                                                 │
+│  ⏱️ 총 소요: 3m 42s                                             │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+**사용자가 확인할 것**:
+- 시나리오 통과율 (4/4 = 100%)
+- 품질 점수 (94/100)
+- 빌드/테스트 상태
 
-Check `<acceptance>` checklist:
-- [ ] Each criterion pass status
-- [ ] Tests pass
-- [ ] Build succeeds
+**이것만 보면 품질을 신뢰할 수 있음.**
 
-### 5. Update SPEC
+### 5. Update Feature File
+
+시나리오 상태 자동 업데이트:
 
-Check completed Tasks:
 ```markdown
-## Task
-<task>
-### Phase 1: Backend
-1. [x] Write DB schema ✅
-2. [x] API endpoint ✅
-...
-</task>
+## Coverage
+
+| Scenario | SPEC AC | Status |
+|----------|---------|--------|
+| 유효한 로그인 성공 | AC-1 | ✅ |
+| 잘못된 비밀번호 에러 | AC-2 | ✅ |
+| 이메일 형식 검증 | AC-3 | ✅ |
+| 비밀번호 찾기 링크 | AC-4 | ✅ |
+
+**Last verified**: 2024-01-15 14:32
+**Quality score**: 94/100
 ```
 
 ## TRUST 5 Principles
@@ -410,69 +598,104 @@ Follow during implementation:
 ## Example
 
 ```
-User: /vibe.run "brick-game"
+User: /vibe.run "login"
 
 Claude:
-📄 Reading SPEC: .vibe/specs/brick-game.md
+📄 Loading SPEC: .vibe/specs/login.md
+📄 Loading Feature: .vibe/features/login.feature
 
-<role> analysis:
-- Web game senior developer
-- Phaser.js expert
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 Scenarios to Implement
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-<context> analysis:
-- Tech stack: Phaser.js, TypeScript
-- New project
+| # | Scenario | Status |
+|---|----------|--------|
+| 1 | 유효한 로그인 성공 | ⬜ |
+| 2 | 잘못된 비밀번호 에러 | ⬜ |
+| 3 | 이메일 형식 검증 | ⬜ |
+| 4 | 비밀번호 찾기 링크 | ⬜ |
 
-<task> analysis:
-- Phase 1: Project setup (3 tasks)
-- Phase 2: Game logic (5 tasks)
-- Phase 3: UI/UX (3 tasks)
-- Phase 4: Testing (2 tasks)
+Total: 4 scenarios
 
-🚀 Starting Phase 1...
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 Scenario 1/4: 유효한 로그인 성공
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-⚡ Launching parallel exploration...
-[Task(haiku) × 3 launched in parallel]
-  - Analyzing Phaser.js project patterns
-  - Checking TypeScript configuration standards
-  - Finding game loop conventions
+Given: 사용자가 등록되어 있다
+When: 유효한 이메일과 비밀번호로 로그인
+Then: 로그인 성공 + JWT 토큰 반환
 
-✅ Exploration complete (3 tasks, 8.2s)
-📋 Synthesizing results...
+⚡ [PARALLEL] 탐색 중...
+✅ 탐색 완료 (2.1s)
 
-🔨 Implementing Phase 1...
-[Task(sonnet) - Project setup]
+🔨 구현 중...
+  ✅ auth.service.ts - login() 추가
+  ✅ auth.controller.ts - POST /login
 
-✅ Phase 1 complete
-  - package.json created
-  - TypeScript configured
-  - Phaser.js installed
+🔍 검증 중...
+  ✅ Given: OK
+  ✅ When: OK
+  ✅ Then: OK
 
-🚀 Starting Phase 2...
+✅ Scenario 1 통과!
 
-⚡ Launching parallel exploration...
-[Task(haiku) × 3 launched in parallel]
-  - Analyzing game scene structure
-  - Checking physics engine patterns
-  - Finding collision detection approaches
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 Scenario 2/4: 잘못된 비밀번호 에러
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔨 구현 중...
+  ✅ auth.service.ts - 비밀번호 검증 로직
 
-✅ Exploration complete (3 tasks, 7.5s)
+🔍 검증 중...
+  ✅ Given: OK
+  ✅ When: OK
+  ❌ Then: "Invalid credentials" 에러 메시지
+     실제: "Error" 반환
 
-🔨 Implementing Phase 2...
-[Task(sonnet) - Game logic]
+🔄 자동 수정 1/3...
+  수정: auth.service.ts line 42
 
-[Implementation continues...]
+🔍 재검증...
+  ✅ Then: OK
 
-✅ All Phases complete!
-📊 Verifying Acceptance Criteria...
-  ✅ Game start/end works
-  ✅ Ball-paddle collision handling
-  ✅ Score display
-  ✅ npm run build succeeds
+✅ Scenario 2 통과! (수정 1회)
 
-🎉 Implementation complete!
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 Scenario 3/4: 이메일 형식 검증
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔨 구현 중...
+🔍 검증 중...
+✅ Scenario 3 통과!
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 Scenario 4/4: 비밀번호 찾기 링크
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔨 구현 중...
+🔍 검증 중...
+✅ Scenario 4 통과!
+
+┌─────────────────────────────────────────────────────────────────┐
+│  📊 QUALITY REPORT: login                                        │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  ✅ 시나리오: 4/4 통과                                          │
+│                                                                 │
+│  | # | Scenario              | Status | Retries |               │
+│  |---|───────────────────────|───────|─────────|               │
+│  | 1 | 유효한 로그인 성공     | ✅    | 0       |               │
+│  | 2 | 잘못된 비밀번호 에러   | ✅    | 1       |               │
+│  | 3 | 이메일 형식 검증       | ✅    | 0       |               │
+│  | 4 | 비밀번호 찾기 링크     | ✅    | 0       |               │
+│                                                                 │
+│  📈 품질 점수: 94/100                                           │
+│  빌드: ✅ | 테스트: ✅ | 타입: ✅                                │
+│                                                                 │
+│  ⏱️ 총 소요: 3m 42s                                             │
+└─────────────────────────────────────────────────────────────────┘
 
-⏱️ Total time: 4m 32s (vs ~12m sequential)
+🎉 구현 완료! 모든 시나리오 통과.
 ```
 
 ### Phase-specific Execution

package/.claude/commands/vibe.verify.md

@@ -5,7 +5,9 @@ argument-hint: "feature name"
 
 # /vibe.verify
 
-Verify implementation based on Feature scenarios.
+**품질 검증 자동화** - 비개발자도 품질을 신뢰할 수 있도록.
+
+> 모든 시나리오 통과 = 품질 보장
 
 ## Usage
 
@@ -13,72 +15,134 @@ Verify implementation based on Feature scenarios.
 /vibe.verify "feature-name"
 ```
 
-## Rules Reference
+## 핵심 원칙
 
-**Must follow `.vibe/rules/`:**
-- `quality/checklist.md` - Code quality checklist
-- `standards/complexity-metrics.md` - Complexity standards
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  비개발자가 알아야 할 것                                         │
+│                                                                 │
+│  ✅ 시나리오 4/4 통과                                           │
+│  📈 품질 점수: 94/100                                           │
+│                                                                 │
+│  이것만 보면 됨. 나머지는 시스템이 알아서.                        │
+└─────────────────────────────────────────────────────────────────┘
+```
 
 ## Process
 
 ### 1. Load Feature File
 
-Read `.vibe/features/{feature-name}.feature`
-
-### 2. Verify by Scenario
+```
+📄 .vibe/features/{feature-name}.feature → 시나리오 목록
+📄 .vibe/specs/{feature-name}.md → 검증 기준 (참조)
+```
 
-For each Scenario:
+**Feature 파일이 없으면**:
+```
+❌ Feature 파일이 없습니다.
+   먼저 /vibe.spec "{feature-name}"을 실행하세요.
+```
 
-1. **Given** (Precondition) - Check state
-2. **When** (Action) - Execute feature
-3. **Then** (Result) - Verify expected result
+### 2. Scenario-by-Scenario Verification
 
-### 3. Verification Methods
+각 시나리오별 자동 검증:
 
-**Code verification:**
-- Check if feature is implemented
-- Verify Given/When/Then steps work
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔍 Scenario 1/4: 유효한 로그인 성공
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-**Test execution (if available):**
-- Run `npm test`, `pytest`, `flutter test`, etc.
-- Check BDD test framework results
+Given: 사용자가 등록되어 있다
+  → 검증: 사용자 생성 API 존재? ✅
+  → 검증: 테스트 사용자 데이터? ✅
 
-**Manual verification:**
-- If no test code, verify via code review
-- Check if each scenario's logic is implemented
+When: 유효한 이메일과 비밀번호로 로그인
+  → 검증: POST /login 엔드포인트? ✅
+  → 검증: 요청 처리 로직? ✅
 
-### 4. Result Report
+Then: 로그인 성공 + JWT 토큰 반환
+  → 검증: 성공 응답 코드 200? ✅
+  → 검증: JWT 토큰 포함? ✅
 
-```markdown
-# Verification Report: {feature-name}
+✅ Scenario 1 통과!
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
 
-## Summary
-- **Total Scenarios**: N
-- **Passed**: N ✅
-- **Failed**: N ❌
-- **Quality Score**: XX/100
+### 3. Verification Methods (자동 선택)
 
-## Scenario Results
+| 방법 | 조건 | 검증 내용 |
+|------|------|-----------|
+| **테스트 실행** | 테스트 파일 존재 시 | `npm test`, `pytest` 등 실행 |
+| **코드 분석** | 항상 | 구현 여부, 로직 확인 |
+| **빌드 검증** | 빌드 스크립트 존재 시 | 컴파일 에러 확인 |
+| **타입 검사** | TypeScript 등 | 타입 에러 확인 |
 
-### ✅ Scenario 1: {title}
-- Given: Verified
-- When: Implemented
-- Then: Works
-- **Verification**: AC-1 satisfied
+### 4. Quality Report (자동 생성)
 
-### ❌ Scenario 2: {title}
-- Given: Verified
-- When: Implemented
-- Then: **Failed** - {reason}
-- **Fix needed**: {specific details}
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  📊 VERIFICATION REPORT: login                                   │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  ✅ 시나리오: 4/4 통과 (100%)                                   │
+│                                                                 │
+│  ┌───────────────────────────────────────────────────────────┐  │
+│  │ # │ Scenario              │ Given │ When │ Then │ Status │  │
+│  │───│───────────────────────│───────│──────│──────│────────│  │
+│  │ 1 │ 유효한 로그인 성공     │ ✅    │ ✅   │ ✅   │ ✅     │  │
+│  │ 2 │ 잘못된 비밀번호 에러   │ ✅    │ ✅   │ ✅   │ ✅     │  │
+│  │ 3 │ 이메일 형식 검증       │ ✅    │ ✅   │ ✅   │ ✅     │  │
+│  │ 4 │ 비밀번호 찾기 링크     │ ✅    │ ✅   │ ✅   │ ✅     │  │
+│  └───────────────────────────────────────────────────────────┘  │
+│                                                                 │
+│  📈 품질 점수: 94/100                                           │
+│                                                                 │
+│  ┌─────────────────────────────────────────────────────────┐    │
+│  │ 항목              │ 결과  │ 상세                        │    │
+│  │───────────────────│───────│─────────────────────────────│    │
+│  │ 빌드              │ ✅    │ 성공                        │    │
+│  │ 테스트            │ ✅    │ 12/12 통과                  │    │
+│  │ 타입 검사         │ ✅    │ 에러 0개                    │    │
+│  │ 복잡도            │ ✅    │ 모든 함수 ≤20줄            │    │
+│  │ 코드 커버리지     │ ⚠️    │ 78% (목표: 80%)             │    │
+│  └─────────────────────────────────────────────────────────┘    │
+│                                                                 │
+│  📋 권장 사항:                                                   │
+│  - 코드 커버리지 2% 추가 필요 (auth.service.ts line 45-52)      │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
 
-## Code Quality
-- Complexity: ✅ Appropriate
-- Test Coverage: XX%
-- Error Handling: ✅
+### 실패 시 리포트
 
-## Next Steps
-- {How to fix failed scenarios}
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  📊 VERIFICATION REPORT: login                                   │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  ❌ 시나리오: 3/4 통과 (75%)                                    │
+│                                                                 │
+│  ┌───────────────────────────────────────────────────────────┐  │
+│  │ # │ Scenario              │ Given │ When │ Then │ Status │  │
+│  │───│───────────────────────│───────│──────│──────│────────│  │
+│  │ 1 │ 유효한 로그인 성공     │ ✅    │ ✅   │ ✅   │ ✅     │  │
+│  │ 2 │ 잘못된 비밀번호 에러   │ ✅    │ ✅   │ ✅   │ ✅     │  │
+│  │ 3 │ 이메일 형식 검증       │ ✅    │ ✅   │ ✅   │ ✅     │  │
+│  │ 4 │ 비밀번호 찾기 링크     │ ✅    │ ❌   │ -    │ ❌     │  │
+│  └───────────────────────────────────────────────────────────┘  │
+│                                                                 │
+│  ❌ 실패 상세:                                                   │
+│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━   │
+│  Scenario 4: 비밀번호 찾기 링크                                  │
+│                                                                 │
+│  When: "비밀번호 찾기" 클릭                                      │
+│  ❌ 문제: 링크가 구현되지 않음                                   │
+│  📍 위치: LoginForm.tsx line 42                                  │
+│  💡 수정: "Forgot password" 링크 추가 필요                       │
+│                                                                 │
+│  🔧 자동 수정 실행: /vibe.run "login" --fix                      │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
 ```
 
 ## Input
@@ -99,40 +163,62 @@ For each Scenario:
 User: /vibe.verify "login"
 
 Claude:
-# Verification Report: login
-
-## Summary
-- **Total Scenarios**: 4
-- **Passed**: 3 ✅
-- **Failed**: 1 ❌
-- **Quality Score**: 85/100
-
-## Scenario Results
-
-### ✅ Scenario 1: Login with valid credentials
-- Given: User is on login page → ✅ LoginPage component exists
-- When: Enter valid email/password → ✅ handleSubmit implemented
-- Then: Redirect to dashboard → ✅ router.push('/dashboard')
-
-### ✅ Scenario 2: Login with wrong password
-- Given: Login page → ✅
-- When: Wrong password → ✅
-- Then: Show error message → ✅ "Password does not match"
-
-### ✅ Scenario 3: Email format validation
-- Given: Login page → ✅
-- When: Invalid email format → ✅
-- Then: Validation error → ✅ zod validation
-
-### ❌ Scenario 4: Forgot password link
-- Given: Login page → ✅
-- When: Click "Forgot password" → ❌ Link missing
-- Then: Navigate to forgot password page → ❌
-
-## Next Steps
-Scenario 4 fix needed:
-- Add "Forgot password" link to LoginPage
-- Implement /forgot-password route
+📄 Loading Feature: .vibe/features/login.feature
+🔍 검증 시작...
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔍 Scenario 1/4: 유효한 로그인 성공
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ✅ Given: 사용자 등록 - OK
+  ✅ When: 로그인 시도 - OK
+  ✅ Then: JWT 토큰 반환 - OK
+✅ 통과!
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔍 Scenario 2/4: 잘못된 비밀번호 에러
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ✅ Given: OK
+  ✅ When: OK
+  ✅ Then: OK
+✅ 통과!
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔍 Scenario 3/4: 이메일 형식 검증
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ✅ Given: OK
+  ✅ When: OK
+  ✅ Then: OK
+✅ 통과!
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔍 Scenario 4/4: 비밀번호 찾기 링크
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ✅ Given: OK
+  ❌ When: "비밀번호 찾기" 링크 - 없음
+  - Then: (스킵)
+❌ 실패!
+
+┌─────────────────────────────────────────────────────────────────┐
+│  📊 VERIFICATION REPORT: login                                   │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  ❌ 시나리오: 3/4 통과 (75%)                                    │
+│                                                                 │
+│  | # | Scenario              | Status |                         │
+│  |---|───────────────────────|────────|                         │
+│  | 1 | 유효한 로그인 성공     | ✅     |                         │
+│  | 2 | 잘못된 비밀번호 에러   | ✅     |                         │
+│  | 3 | 이메일 형식 검증       | ✅     |                         │
+│  | 4 | 비밀번호 찾기 링크     | ❌     |                         │
+│                                                                 │
+│  📈 품질 점수: 75/100                                           │
+│                                                                 │
+│  ❌ 수정 필요:                                                   │
+│  - Scenario 4: LoginForm.tsx에 "Forgot password" 링크 추가      │
+│                                                                 │
+│  🔧 자동 수정: /vibe.run "login" --fix                          │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
 ```
 
 ## Next Step

package/.claude/settings.json

@@ -48,68 +48,5 @@
     ],
     "deny": [],
     "ask": []
-  },
-  "hooks": {
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "type": "prompt",
-            "prompt": "Call mcp__vibe__start_session to restore previous session context."
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "matcher": "ultrawork|ulw|울트라워크",
-        "hooks": [
-          {
-            "type": "prompt",
-            "prompt": "🚀 ULTRAWORK MODE DETECTED. You MUST: (1) Use PARALLEL Task calls for ALL exploration, (2) Enable Boulder Loop - auto-continue through ALL phases without pausing, (3) Auto-retry on errors up to 3 times, (4) Run mcp__vibe__auto_save_context at 70%+ context, (5) Do NOT ask for confirmation between phases. Keep rolling until ALL acceptance criteria pass."
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "prompt",
-            "prompt": "Silently check .vibe/rules/quality/checklist.md. Fix critical issues (syntax errors, security vulnerabilities) inline. Do NOT stop to report - continue your current task."
-          }
-        ]
-      }
-    ],
-    "Notification": [
-      {
-        "matcher": "context_window_70",
-        "hooks": [
-          {
-            "type": "prompt",
-            "prompt": "Context at 70%. You still have headroom - don't rush or produce sloppy work. But start being selective about file reads. If ULTRAWORK mode: run mcp__vibe__auto_save_context now."
-          }
-        ]
-      },
-      {
-        "matcher": "context_window_85",
-        "hooks": [
-          {
-            "type": "prompt",
-            "prompt": "Context at 85%. IMMEDIATELY run mcp__vibe__auto_save_context with urgency='high'. Summarize current progress and next steps. Compress verbose outputs."
-          }
-        ]
-      },
-      {
-        "matcher": "context_window_95",
-        "hooks": [
-          {
-            "type": "prompt",
-            "prompt": "Context at 95% - CRITICAL. Run mcp__vibe__auto_save_context with urgency='critical' NOW. Save all progress, blockers, and next steps. Prepare for session transition. If in ULTRAWORK mode, the next session will auto-restore and continue."
-          }
-        ]
-      }
-    ]
   }
 }

package/.claude/settings.local.json

@@ -36,7 +36,8 @@
       "Bash(git checkout:*)",
       "Bash(git revert:*)",
       "Bash(ls:*)",
-      "Bash(npx @su-record/vibe@1.2.14 update:*)"
+      "Bash(npx @su-record/vibe@1.2.14 update:*)",
+      "Bash(npm unpublish:*)"
     ],
     "deny": [],
     "ask": []

package/README.md

@@ -2,7 +2,9 @@
 
 **SPEC-driven AI coding framework (Claude Code 전용)**
 
-SPEC 문서 하나로 AI가 바로 구현하는 2-step 워크플로우.
+SPEC 문서 하나로 AI가 바로 구현하고, **시나리오별 자동 검증**으로 품질을 보장하는 프레임워크.
+
+> **품질은 사용자가 신경 쓰는 게 아니라, 시스템이 보장하는 것.**
 
 [![npm version](https://img.shields.io/npm/v/@su-record/vibe.svg)](https://www.npmjs.com/package/@su-record/vibe)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -12,12 +14,12 @@ SPEC 문서 하나로 AI가 바로 구현하는 2-step 워크플로우.
 
 ## Features
 
-- **Claude Code 전용**: 네이티브 슬래시 커맨드 + MCP 통합
+- **시나리오 주도 개발 (SDD)**: 각 시나리오 = 구현 단위 = 검증 단위
+- **BDD 자동 검증**: Given/When/Then 단계별 자동 품질 검증
+- **품질 보장 시스템**: 비개발자도 품질을 신뢰할 수 있는 자동화
 - **ULTRAWORK Mode**: `ulw` 한 단어로 모든 최적화 자동 활성화
-- **Boulder Loop**: 모든 Phase 완료까지 자동 진행 (시지푸스처럼)
+- **Boulder Loop**: 모든 시나리오 완료까지 자동 진행
 - **병렬 서브에이전트**: Haiku 3+ 동시 탐색으로 ~3배 속도 향상
-- **PTCF 구조**: Persona, Task, Context, Format - Gemini 프롬프트 최적화
-- **코딩 규칙 내장**: `.vibe/rules/` - 품질 기준, 복잡도 제한, 안티패턴
 - **자동 컨텍스트 관리**: 70%+ 시 자동 압축/저장
 - **36개 MCP 도구**: @su-record/hi-ai 통합
 
@@ -63,19 +65,33 @@ cd my-project
 │  /vibe.spec "기능명"                                │
 │  ↓ 대화형 요구사항 수집                              │
 │  ↓ .vibe/specs/{기능명}.md (PTCF 구조)              │
-│  ↓ .vibe/features/{기능명}.feature (BDD)            │
+│  ↓ .vibe/features/{기능명}.feature (BDD 시나리오)   │
 ├─────────────────────────────────────────────────────┤
 │  /vibe.run "기능명" ultrawork                       │
-│  ↓ 🚀 ULTRAWORK: 병렬 탐색 + 자동 진행              │
-│  ↓ Boulder Loop: 모든 Phase 완료까지 자동 실행      │
-│  ↓ 에러 자동 재시도 (3회)                           │
+│  ↓ 시나리오별 구현 + 즉시 검증 (SDD)                │
+│  ↓ Scenario 1 → 구현 → ✅ → Scenario 2 → ...       │
+│  ↓ 실패 시 자동 재시도 (최대 3회)                   │
 ├─────────────────────────────────────────────────────┤
 │  /vibe.verify "기능명"                              │
-│  ↓ Acceptance Criteria 검증                        │
-│  ↓ 품질 점수 (A+ ~ F)                              │
+│  ↓ Given/When/Then 단계별 검증                     │
+│  ↓ 품질 리포트 자동 생성                            │
 └─────────────────────────────────────────────────────┘
 ```
 
+### 시나리오 주도 개발 (SDD)
+
+> **각 시나리오가 곧 구현 단위이자 검증 단위입니다.**
+
+```
+Feature 로드 → Scenario 1 [구현→검증] → Scenario 2 [구현→검증] → ... → 품질 리포트
+                    ↓                        ↓
+               ✅ 통과 시 다음         ❌ 실패 시 수정 후 재검증
+```
+
+비개발자도 시나리오 통과율만 보면 품질을 알 수 있습니다:
+- ✅ 4/4 시나리오 통과 = 품질 보장
+- 📈 품질 점수: 94/100
+
 ---
 
 ## Commands
@@ -152,27 +168,71 @@ cd my-project
 
 ### Boulder Loop
 
-시지푸스처럼 바위를 굴리듯, **모든 작업이 완료될 때까지** 자동으로 진행:
+시지푸스처럼 바위를 굴리듯, **모든 시나리오가 통과될 때까지** 자동으로 진행:
 
 ```
-Phase 1 → Phase 2 → Phase 3 → ... → Phase N
-    ↓         ↓         ↓              ↓
-[병렬탐색] [병렬탐색] [병렬탐색]    [병렬탐색]
-[구현]     [구현]     [구현]        [구현]
-[테스트]   [테스트]   [테스트]      [테스트]
-                                      ↓
-                               🎉 완료까지 자동!
+Scenario 1 → Scenario 2 → Scenario 3 → ... → Scenario N
+    ↓             ↓            ↓                 ↓
+[탐색+구현]   [탐색+구현]   [탐색+구현]      [탐색+구현]
+[즉시 검증]   [즉시 검증]   [즉시 검증]      [즉시 검증]
+    ✅            ✅            ✅               ✅
+                                                 ↓
+                                        🎉 품질 보장 완료!
 ```
 
 ### 일반 모드 vs ULTRAWORK
 
 | 항목 | 일반 모드 | ULTRAWORK |
 |------|----------|-----------|
-| Phase 전환 | 일시정지 가능 | 자동 진행 |
-| 에러 발생 | 보고 후 중단 | 자동 재시도 (3회) |
+| 시나리오 전환 | 일시정지 가능 | 자동 진행 |
+| 검증 실패 | 보고 후 중단 | 자동 재시도 (3회) |
 | 컨텍스트 70%+ | 경고만 | 자동 압축/저장 |
 | 탐색 방식 | 순차 가능 | **강제 병렬** |
-| 완료 조건 | Phase별 | 전체 완료까지 |
+| 완료 조건 | 시나리오별 | 전체 시나리오 통과까지 |
+
+---
+
+## BDD 자동 검증
+
+### 품질 리포트 예시
+
+`/vibe.verify` 실행 시 자동 생성되는 품질 리포트:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  📊 VERIFICATION REPORT: login                                   │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  ✅ 시나리오: 4/4 통과 (100%)                                   │
+│                                                                 │
+│  | # | Scenario              | Given | When | Then | Status |   │
+│  |---|───────────────────────|───────|──────|──────|────────|   │
+│  | 1 | 유효한 로그인 성공     | ✅    | ✅   | ✅   | ✅     |   │
+│  | 2 | 잘못된 비밀번호 에러   | ✅    | ✅   | ✅   | ✅     |   │
+│  | 3 | 이메일 형식 검증       | ✅    | ✅   | ✅   | ✅     |   │
+│  | 4 | 비밀번호 찾기 링크     | ✅    | ✅   | ✅   | ✅     |   │
+│                                                                 │
+│  📈 품질 점수: 94/100                                           │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### 검증 실패 시
+
+```
+❌ Scenario 4: 비밀번호 찾기 링크
+
+When: "비밀번호 찾기" 클릭
+❌ 문제: 링크가 구현되지 않음
+📍 위치: LoginForm.tsx line 42
+💡 수정: "Forgot password" 링크 추가 필요
+
+🔧 자동 수정: /vibe.run "login" --fix
+```
+
+비개발자가 알아야 할 것:
+- ✅ 시나리오 4/4 통과 → **품질 보장됨**
+- ❌ 시나리오 3/4 통과 → **수정 필요** (자동 수정 가능)
 
 ---
 
@@ -202,6 +262,31 @@ project/
 
 ---
 
+## Feature 파일 (BDD 시나리오)
+
+```gherkin
+# .vibe/features/login.feature
+
+Feature: 로그인
+
+  Scenario: 유효한 로그인 성공
+    Given 사용자가 등록되어 있다
+      # 검증: 사용자 생성 API 존재
+    When 유효한 이메일과 비밀번호로 로그인
+      # 검증: POST /login 엔드포인트
+    Then 로그인 성공 + JWT 토큰 반환
+      # 검증: 200 응답 + 토큰 포함
+
+  Scenario: 잘못된 비밀번호 에러
+    Given 사용자가 등록되어 있다
+    When 잘못된 비밀번호로 로그인
+    Then 401 에러 + "비밀번호가 틀립니다" 메시지
+```
+
+각 시나리오의 Given/When/Then이 자동 검증 포인트가 됩니다.
+
+---
+
 ## SPEC Document (PTCF Structure)
 
 ```markdown
@@ -217,16 +302,16 @@ AI의 역할과 전문성 정의
 - 배경, 목적
 - 기술 스택
 - 관련 코드
-- 디자인 레퍼런스
 </context>
 
 ## Task
 <task>
-### Phase 1: {단계명}
-1. [ ] 작업 1
-2. [ ] 작업 2
+### Scenario 1: {시나리오명}
+Given: {전제 조건}
+When: {사용자 행동}
+Then: {예상 결과}
 
-### Phase 2: {단계명}
+### Scenario 2: {시나리오명}
 ...
 </task>
 
@@ -236,17 +321,10 @@ AI의 역할과 전문성 정의
 - 에러 메시지 한글화
 </constraints>
 
-## Output Format
-<output_format>
-- 생성할 파일
-- 수정할 파일
-- 검증 명령어
-</output_format>
-
 ## Acceptance Criteria
 <acceptance>
-- [ ] 검증 기준 1
-- [ ] 검증 기준 2
+- [ ] Scenario 1 통과
+- [ ] Scenario 2 통과
 </acceptance>
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@su-record/vibe",
-  "version": "1.2.21",
+  "version": "1.3.0",
   "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework",
   "bin": {
     "vibe": "./bin/vibe"

package/templates/feature-template.md

@@ -1,6 +1,12 @@
 # Feature: {기능명}
 
+> 이 파일은 **품질 보장의 핵심**입니다. 모든 시나리오 통과 = 기능 완성.
+
 **SPEC**: `.vibe/specs/{기능명}.md`
+**Last verified**: -
+**Quality score**: -
+
+---
 
 ## User Story
 
@@ -12,59 +18,79 @@
 
 ## Scenarios
 
+> 각 시나리오가 구현 단위이자 검증 단위입니다.
+
 ### Scenario 1: {Happy Path - 정상 케이스}
 
 ```gherkin
 Scenario: {시나리오 제목}
   Given {전제 조건}
+    # 검증: {무엇을 확인하는가}
   When {사용자 행동}
+    # 검증: {어떤 기능이 실행되는가}
   Then {예상 결과}
+    # 검증: {무엇이 보이거나 반환되는가}
 ```
 
-**검증 기준**: SPEC Acceptance Criteria #1
+**SPEC AC**: #1
+**Status**: ⬜
 
 ---
 
-### Scenario 2: {Edge Case - 예외 케이스}
+### Scenario 2: {Edge Case - 에러 케이스}
 
 ```gherkin
 Scenario: {에러 시나리오 제목}
   Given {전제 조건}
-  When {잘못된 입력}
-  Then {에러 처리}
+  When {잘못된 입력 또는 예외 상황}
+  Then {에러 메시지 또는 적절한 처리}
 ```
 
-**검증 기준**: SPEC Acceptance Criteria #2
+**SPEC AC**: #2
+**Status**: ⬜
 
 ---
 
-### Scenario Outline: {파라미터화 테스트}
+### Scenario 3: {Boundary Case - 경계 케이스}
 
 ```gherkin
-Scenario Outline: {시나리오 제목}
+Scenario: {경계값 테스트}
   Given {전제 조건}
-  When I input "<input>"
-  Then I should see "<output>"
-
-Examples:
-  | input  | output  |
-  | value1 | result1 |
-  | value2 | result2 |
+  When {경계값 입력}
+  Then {적절한 처리}
 ```
 
+**SPEC AC**: #3
+**Status**: ⬜
+
 ---
 
-## Coverage
+## Coverage Summary
 
-| Scenario | SPEC Acceptance | Status |
-|----------|-----------------|--------|
-| Scenario 1 | AC-1 | ⬜ |
-| Scenario 2 | AC-2 | ⬜ |
+| # | Scenario | SPEC AC | Status | Retries |
+|---|----------|---------|--------|---------|
+| 1 | {Happy Path} | AC-1 | ⬜ | - |
+| 2 | {Edge Case} | AC-2 | ⬜ | - |
+| 3 | {Boundary Case} | AC-3 | ⬜ | - |
+
+**Total**: 0/3 통과 (0%)
 
 ---
 
-## Verification
+## Verification Commands
 
 ```bash
+# 전체 검증
 /vibe.verify "{기능명}"
+
+# 실패 시 자동 수정
+/vibe.run "{기능명}" --fix
 ```
+
+---
+
+## Notes
+
+- 시나리오 추가/수정 시 Coverage Summary도 함께 업데이트
+- Given/When/Then 각각에 검증 포인트 명시
+- 모든 시나리오 통과 시 품질 보장됨

package/templates/hooks-template.json

@@ -65,7 +65,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "echo '[CODE CHECK] Continue your task. Quick inline check: no syntax errors, no any types, no security issues, preserves existing code style.'"
+            "command": "echo '[CODE CHECK] Review for issues: unused imports, syntax errors, incomplete implementation. If any found, fix immediately in next edit. Continue with task until complete.'"
           }
         ]
       }