@su-record/vibe 2.0.0 → 2.0.2

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

@@ -1,760 +1,760 @@
----
-description: Execute implementation from SPEC
-argument-hint: "feature name" or --phase N
----
-
-# /vibe.run
-
-Execute **Scenario-Driven Implementation** with automatic quality verification.
-
-> **핵심 원칙**: 시나리오가 곧 구현 단위이자 검증 기준. 모든 시나리오 통과 = 품질 보장.
-
-## Usage
-
-```
-/vibe.run "feature-name"              # Full implementation
-/vibe.run "feature-name" --phase 1    # Specific Phase only
-/vibe.run "feature-name" ultrawork    # ULTRAWORK mode (recommended)
-/vibe.run "feature-name" ulw          # Short alias for ultrawork
-```
-
----
-
-## **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**.
-
-### What ULTRAWORK Enables
-
-When you include `ultrawork` (or `ulw`), ALL of these activate automatically:
-
-| Feature | Description |
-|---------|-------------|
-| **Parallel Exploration** | 3+ Task(haiku) agents run simultaneously |
-| **Boulder Loop** | Auto-continues until ALL phases complete |
-| **Context Compression** | Aggressive auto-save at 70%+ context |
-| **No Pause** | Doesn't wait for confirmation between phases |
-| **External LLMs** | Auto-consults GPT/Gemini if enabled |
-| **Error Recovery** | Auto-retries on failure (up to 3 times) |
-
-### Boulder Loop (Inspired by Sisyphus)
-
-Like Sisyphus rolling the boulder, ULTRAWORK **keeps going until done**:
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                    BOULDER LOOP (ultrawork)                      │
-│                                                                  │
-│   ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐  │
-│   │ Phase 1  │───→│ Phase 2  │───→│ Phase 3  │───→│ Phase N  │  │
-│   └──────────┘    └──────────┘    └──────────┘    └──────────┘  │
-│        │               │               │               │         │
-│        ↓               ↓               ↓               ↓         │
-│   [Parallel]      [Parallel]      [Parallel]      [Parallel]    │
-│   [Implement]     [Implement]     [Implement]     [Implement]   │
-│   [Test]          [Test]          [Test]          [Test]        │
-│        │               │               │               │         │
-│        └───────────────┴───────────────┴───────────────┘         │
-│                              │                                   │
-│                              ↓                                   │
-│                     ┌──────────────┐                             │
-│                     │  ALL DONE?   │                             │
-│                     └──────────────┘                             │
-│                       │         │                                │
-│                      NO        YES                               │
-│                       │         │                                │
-│                       ↓         ↓                                │
-│                   [Continue]  [🎉 Complete!]                     │
-│                                                                  │
-│   NO STOPPING until acceptance criteria met or error limit hit   │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### ULTRAWORK Example
-
-```
-User: /vibe.run "brick-game" ultrawork
-
-Claude:
-🚀 ULTRAWORK MODE ACTIVATED
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📄 SPEC: .vibe/specs/brick-game.md
-🎯 4 Phases detected
-⚡ Boulder Loop: ENABLED (will continue until all phases complete)
-🔄 Auto-retry: ON (max 3 per phase)
-💾 Context compression: AGGRESSIVE
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🏔️ BOULDER ROLLING... Phase 1/4
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-⚡ [PARALLEL] Launching 3 exploration agents...
-✅ Exploration complete (7.2s)
-🔨 Implementing...
-✅ Phase 1 complete
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🏔️ BOULDER ROLLING... Phase 2/4
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-⚡ [PARALLEL] Launching 3 exploration agents...
-✅ Exploration complete (6.8s)
-🔨 Implementing...
-❌ Test failed: collision detection
-🔄 Auto-retry 1/3...
-🔨 Fixing...
-✅ Phase 2 complete
-
-[...continues automatically...]
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎉 BOULDER REACHED THE TOP!
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-✅ All 4 phases complete
-✅ All acceptance criteria passed
-✅ Build succeeded
-✅ Tests passed
-
-⏱️ Total: 8m 24s
-📊 Retries: 2
-💾 Context saved: 3 checkpoints
-```
-
-### Normal vs ULTRAWORK Comparison
-
-| Aspect | Normal | ULTRAWORK |
-|--------|--------|-----------|
-| Phase transition | May pause | Auto-continues |
-| On error | Reports and stops | Auto-retries (3x) |
-| Context 70%+ | Warning only | Auto-compress + save |
-| Exploration | Sequential possible | FORCED parallel |
-| Completion | Phase-by-phase | Until ALL done |
-
----
-
-## Rules Reference
-
-**Must follow `.vibe/rules/`:**
-- `core/development-philosophy.md` - Surgical precision, modify only requested scope
-- `core/quick-start.md` - Korean, DRY, SRP, YAGNI
-- `standards/complexity-metrics.md` - Functions ≤20 lines, nesting ≤3 levels
-- `quality/checklist.md` - Code quality checklist
-
-## Description
-
-Read PTCF structured SPEC document and execute implementation immediately.
-
-> **PLAN, TASKS documents unnecessary** - SPEC is the executable prompt
-
-## Model Orchestration
-
-Automatically select optimal model based on task type:
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│               Opus 4.5 (Orchestrator)                       │
-│               - Coordinate overall flow                     │
-│               - Final decisions/review                      │
-└─────────────────────────┬───────────────────────────────────┘
-                          │
-    ┌─────────────────────┼─────────────────────┐
-    ↓                     ↓                     ↓
-┌─────────┐         ┌─────────┐         ┌─────────┐
-│ Haiku   │         │ Sonnet  │         │ Haiku   │
-│(Explore)│         │ (Impl)  │         │ (Test)  │
-└─────────┘         └─────────┘         └─────────┘
-```
-
-### Task Calls by Role
-
-| Task Type | Model | Task Parameter |
-|-----------|-------|----------------|
-| Codebase exploration | Haiku 4.5 | `model: "haiku"` |
-| Core implementation | Sonnet 4 | `model: "sonnet"` |
-| Test writing | Haiku 4.5 | `model: "haiku"` |
-| Architecture decisions | Opus 4.5 | Main session |
-| Final review | Opus 4.5 | Main session |
-
-### External LLM Usage (When Enabled)
-
-When external LLMs are enabled in `.vibe/config.json`:
-
-| Role | Model | Condition |
-|------|-------|-----------|
-| Architecture/Debugging | GPT 5.2 | When `vibe gpt <key>` executed |
-| UI/UX Design, Exploration | Gemini 2.5/3 | When `vibe gemini --auth` executed |
-
-When external LLM enabled, automatically called via MCP:
-- `mcp__vibe-gpt__chat` - GPT 5.2 architecture consultation
-- `mcp__vibe-gemini__gemini_chat` - Gemini 질문/상담
-- `mcp__vibe-gemini__gemini_analyze_code` - 코드 분석
-- `mcp__vibe-gemini__gemini_review_ui` - UI/UX 리뷰
-- `mcp__vibe-gemini__gemini_quick_ask` - 빠른 질문 (탐색용)
-
-### External LLM Fallback
-
-**IMPORTANT**: When Gemini/GPT MCP returns `"status": "fallback"`, Claude MUST handle the task directly:
-
-```json
-{
-  "status": "fallback",
-  "reason": "rate_limit",  // or "auth_error"
-  "message": "Gemini API 할당량 초과. Claude가 직접 처리해주세요."
-}
-```
-
-**Fallback behavior**:
-- Do NOT retry the external LLM call
-- Claude handles the task using its own capabilities
-- Continue with the implementation without interruption
-- Log the fallback but don't block progress
-
-## Semantic Code Analysis (hi-ai MCP)
-
-Use hi-ai MCP semantic tools to accurately understand codebase before implementation:
-
-| MCP Tool | Purpose | When Used |
-|----------|---------|-----------|
-| `vibe_find_symbol` | Find symbol definitions | Locate class/function |
-| `vibe_find_references` | Find references | Analyze impact scope |
-| `vibe_analyze_complexity` | Analyze complexity | Determine refactoring need |
-| `vibe_validate_code_quality` | Validate quality | Verify post-implementation quality |
-
-### Semantic Analysis Flow
-
-```
-Start Implementation
-    │
-    ├─→ find_symbol: Locate exact position of function/class to modify
-    │
-    ├─→ find_references: Check all places using that symbol
-    │
-    ├─→ analyze_complexity: Check existing code complexity
-    │
-    ↓
-Implementation (with accurate understanding of impact scope)
-    │
-    ↓
-validate_code_quality: Verify quality after implementation
-```
-
-### Context Management (Session Continuity)
-
-| MCP Tool | Purpose |
-|----------|---------|
-| `vibe_start_session` | Start session, restore previous context |
-| `vibe_auto_save_context` | Auto-save current state |
-| `vibe_restore_session_context` | Restore previous session context |
-| `vibe_save_memory` | Save important decisions/patterns |
-
-**On session start**: `vibe_start_session` auto-restores previous context
-**On session end**: Hook auto-executes `vibe_auto_save_context`
-
-## Process
-
-### 1. Load SPEC + Feature
-
-```
-📄 .vibe/specs/{feature-name}.md      → SPEC (구조, 제약, 컨텍스트)
-📄 .vibe/features/{feature-name}.feature → Feature (시나리오 = 구현 단위)
-```
-
-**Feature 파일이 없으면 에러**:
-```
-❌ Feature 파일이 없습니다.
-   먼저 /vibe.spec "{feature-name}"을 실행하세요.
-```
-
-### 2. Scenario 목록 추출
-
-Feature 파일에서 모든 Scenario 추출:
-
-```markdown
-## Scenarios to Implement
-
-| # | Scenario | Status |
-|---|----------|--------|
-| 1 | 유효한 로그인 성공 | ⬜ |
-| 2 | 잘못된 비밀번호 에러 | ⬜ |
-| 3 | 이메일 형식 검증 | ⬜ |
-| 4 | 비밀번호 찾기 링크 | ⬜ |
-
-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회)
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
-
----
-
-## **CRITICAL: Parallel Sub-Agent Execution**
-
-> **MUST USE PARALLEL TASK CALLS** - This is REQUIRED, not optional.
-> Sequential execution when parallel is possible = VIOLATION of this workflow.
-
-### Mandatory Parallel Exploration (Phase Start)
-
-**BEFORE any implementation, you MUST launch these Task calls IN PARALLEL (single message, multiple tool calls):**
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  STEP 1: PARALLEL EXPLORATION (REQUIRED)                        │
-│                                                                 │
-│  Launch ALL of these in ONE message:                            │
-│                                                                 │
-│  Task(haiku) ─┬─→ "Analyze related files in <context>"          │
-│               │                                                 │
-│  Task(haiku) ─┼─→ "Check dependencies and imports"              │
-│               │                                                 │
-│  Task(haiku) ─┴─→ "Find existing patterns and conventions"      │
-│                                                                 │
-│  [If GPT enabled] + MCP(vibe-gpt): Architecture review          │
-│  [If Gemini enabled] + MCP(vibe-gemini): UI/UX consultation     │
-└─────────────────────────────────────────────────────────────────┘
-                              │
-                              ↓ (wait for all to complete)
-┌─────────────────────────────────────────────────────────────────┐
-│  STEP 2: SYNTHESIZE (Opus)                                      │
-│  - Review all exploration results                               │
-│  - Decide implementation approach                               │
-│  - Identify files to modify/create                              │
-└─────────────────────────────────────────────────────────────────┘
-                              │
-                              ↓
-┌─────────────────────────────────────────────────────────────────┐
-│  STEP 3: IMPLEMENT (Task sonnet)                                │
-│  - Execute implementation with full context                     │
-└─────────────────────────────────────────────────────────────────┘
-                              │
-                              ↓
-┌─────────────────────────────────────────────────────────────────┐
-│  STEP 4: TEST (Task haiku)                                      │
-│  - Write tests for implemented code                             │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Parallel Task Call Pattern (MUST FOLLOW)
-
-**Correct - Single message with multiple parallel Tasks:**
-```
-<message>
-  Task(haiku, "Analyze src/components/ for existing patterns")
-  Task(haiku, "Check package.json dependencies")
-  Task(haiku, "Find usage of similar features in codebase")
-</message>
-→ All 3 run simultaneously, ~3x faster
-```
-
-**WRONG - Sequential calls (DO NOT DO THIS):**
-```
-<message>Task(haiku, "Analyze...")</message>
-<message>Task(haiku, "Check...")</message>
-<message>Task(haiku, "Find...")</message>
-→ 3x slower, wastes time
-```
-
-### Why Parallel Matters
-
-| Approach | Time | Cache Benefit |
-|----------|------|---------------|
-| Sequential (3 Tasks) | ~30s | Cache cold on each |
-| **Parallel (3 Tasks)** | **~10s** | **Cache warmed once, shared** |
-
-hi-ai ProjectCache (LRU) caches ts-morph parsing results. Parallel calls share the warmed cache.
-
-### Phase Execution Flow
-
-```
-Phase N Start
-    │
-    ├─→ [PARALLEL] Task(haiku) × 2-3: Exploration
-    │       - Related code analysis
-    │       - Dependency check
-    │       - Pattern discovery
-    │
-    ↓ (all complete)
-    │
-    ├─→ Opus: Synthesize and decide
-    │
-    ├─→ Task(sonnet): Implementation
-    │
-    ├─→ Task(haiku): Tests
-    │
-    ↓
-Phase N Complete → Next Phase
-```
-
----
-
-1. **Related code analysis**: Task(haiku) explores `<context>` related code
-2. **File creation/modification**: Task(sonnet) implements per `<output_format>`
-3. **Constraint compliance**: Check `<constraints>`
-4. **Run verification**: Execute verification commands
-
-### 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)
-- 빌드/테스트 상태
-
-**이것만 보면 품질을 신뢰할 수 있음.**
-
-### 5. Update Feature File
-
-시나리오 상태 자동 업데이트:
-
-```markdown
-## 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
-
-Follow during implementation:
-
-| Principle | Description |
-|-----------|-------------|
-| **T**est-first | Write tests first |
-| **R**eadable | Clear code |
-| **U**nified | Consistent style |
-| **S**ecured | Consider security |
-| **T**rackable | Logging, monitoring |
-
-## Input
-
-- `.vibe/specs/{feature-name}.md` (PTCF SPEC)
-- `.vibe/features/{feature-name}.feature` (BDD)
-- `CLAUDE.md` (project context)
-
-## Output
-
-- Implemented code files
-- Test files
-- Updated SPEC document (checkmarks)
-
-## Example
-
-```
-User: /vibe.run "login"
-
-Claude:
-📄 Loading SPEC: .vibe/specs/login.md
-📄 Loading Feature: .vibe/features/login.feature
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📋 Scenarios to Implement
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-| # | Scenario | Status |
-|---|----------|--------|
-| 1 | 유효한 로그인 성공 | ⬜ |
-| 2 | 잘못된 비밀번호 에러 | ⬜ |
-| 3 | 이메일 형식 검증 | ⬜ |
-| 4 | 비밀번호 찾기 링크 | ⬜ |
-
-Total: 4 scenarios
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 Scenario 1/4: 유효한 로그인 성공
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Given: 사용자가 등록되어 있다
-When: 유효한 이메일과 비밀번호로 로그인
-Then: 로그인 성공 + JWT 토큰 반환
-
-⚡ [PARALLEL] 탐색 중...
-✅ 탐색 완료 (2.1s)
-
-🔨 구현 중...
-  ✅ auth.service.ts - login() 추가
-  ✅ auth.controller.ts - POST /login
-
-🔍 검증 중...
-  ✅ Given: OK
-  ✅ When: OK
-  ✅ Then: OK
-
-✅ Scenario 1 통과!
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 Scenario 2/4: 잘못된 비밀번호 에러
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-🔨 구현 중...
-  ✅ auth.service.ts - 비밀번호 검증 로직
-
-🔍 검증 중...
-  ✅ Given: OK
-  ✅ When: OK
-  ❌ Then: "Invalid credentials" 에러 메시지
-     실제: "Error" 반환
-
-🔄 자동 수정 1/3...
-  수정: auth.service.ts line 42
-
-🔍 재검증...
-  ✅ Then: OK
-
-✅ Scenario 2 통과! (수정 1회)
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 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                                             │
-└─────────────────────────────────────────────────────────────────┘
-
-🎉 구현 완료! 모든 시나리오 통과.
-```
-
-### Phase-specific Execution
-
-```
-User: /vibe.run "brick-game" --phase 2
-
-Claude:
-📄 Reading SPEC: .vibe/specs/brick-game.md
-🎯 Executing Phase 2 only.
-
-Phase 2: Game Logic
-1. [ ] Paddle movement implementation
-2. [ ] Ball physics engine
-3. [ ] Brick collision handling
-4. [ ] Score system
-5. [ ] Game over conditions
-
-⚡ Launching parallel exploration...
-[Task(haiku) × 3 launched in parallel]
-
-🚀 Starting implementation...
-```
-
-## Error Handling
-
-On failure:
-1. Check error message
-2. Review `<constraints>`
-3. Fix code and retry
-4. If continues to fail, report to user
-
-## Next Step
-
-```
-/vibe.verify "brick-game"
-```
-
----
-
-ARGUMENTS: $ARGUMENTS
+---
+description: Execute implementation from SPEC
+argument-hint: "feature name" or --phase N
+---
+
+# /vibe.run
+
+Execute **Scenario-Driven Implementation** with automatic quality verification.
+
+> **핵심 원칙**: 시나리오가 곧 구현 단위이자 검증 기준. 모든 시나리오 통과 = 품질 보장.
+
+## Usage
+
+```
+/vibe.run "feature-name"              # Full implementation
+/vibe.run "feature-name" --phase 1    # Specific Phase only
+/vibe.run "feature-name" ultrawork    # ULTRAWORK mode (recommended)
+/vibe.run "feature-name" ulw          # Short alias for ultrawork
+```
+
+---
+
+## **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**.
+
+### What ULTRAWORK Enables
+
+When you include `ultrawork` (or `ulw`), ALL of these activate automatically:
+
+| Feature | Description |
+|---------|-------------|
+| **Parallel Exploration** | 3+ Task(haiku) agents run simultaneously |
+| **Boulder Loop** | Auto-continues until ALL phases complete |
+| **Context Compression** | Aggressive auto-save at 70%+ context |
+| **No Pause** | Doesn't wait for confirmation between phases |
+| **External LLMs** | Auto-consults GPT/Gemini if enabled |
+| **Error Recovery** | Auto-retries on failure (up to 3 times) |
+
+### Boulder Loop (Inspired by Sisyphus)
+
+Like Sisyphus rolling the boulder, ULTRAWORK **keeps going until done**:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    BOULDER LOOP (ultrawork)                      │
+│                                                                  │
+│   ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐  │
+│   │ Phase 1  │───→│ Phase 2  │───→│ Phase 3  │───→│ Phase N  │  │
+│   └──────────┘    └──────────┘    └──────────┘    └──────────┘  │
+│        │               │               │               │         │
+│        ↓               ↓               ↓               ↓         │
+│   [Parallel]      [Parallel]      [Parallel]      [Parallel]    │
+│   [Implement]     [Implement]     [Implement]     [Implement]   │
+│   [Test]          [Test]          [Test]          [Test]        │
+│        │               │               │               │         │
+│        └───────────────┴───────────────┴───────────────┘         │
+│                              │                                   │
+│                              ↓                                   │
+│                     ┌──────────────┐                             │
+│                     │  ALL DONE?   │                             │
+│                     └──────────────┘                             │
+│                       │         │                                │
+│                      NO        YES                               │
+│                       │         │                                │
+│                       ↓         ↓                                │
+│                   [Continue]  [🎉 Complete!]                     │
+│                                                                  │
+│   NO STOPPING until acceptance criteria met or error limit hit   │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### ULTRAWORK Example
+
+```
+User: /vibe.run "brick-game" ultrawork
+
+Claude:
+🚀 ULTRAWORK MODE ACTIVATED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📄 SPEC: .vibe/specs/brick-game.md
+🎯 4 Phases detected
+⚡ Boulder Loop: ENABLED (will continue until all phases complete)
+🔄 Auto-retry: ON (max 3 per phase)
+💾 Context compression: AGGRESSIVE
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🏔️ BOULDER ROLLING... Phase 1/4
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+⚡ [PARALLEL] Launching 3 exploration agents...
+✅ Exploration complete (7.2s)
+🔨 Implementing...
+✅ Phase 1 complete
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🏔️ BOULDER ROLLING... Phase 2/4
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+⚡ [PARALLEL] Launching 3 exploration agents...
+✅ Exploration complete (6.8s)
+🔨 Implementing...
+❌ Test failed: collision detection
+🔄 Auto-retry 1/3...
+🔨 Fixing...
+✅ Phase 2 complete
+
+[...continues automatically...]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎉 BOULDER REACHED THE TOP!
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+✅ All 4 phases complete
+✅ All acceptance criteria passed
+✅ Build succeeded
+✅ Tests passed
+
+⏱️ Total: 8m 24s
+📊 Retries: 2
+💾 Context saved: 3 checkpoints
+```
+
+### Normal vs ULTRAWORK Comparison
+
+| Aspect | Normal | ULTRAWORK |
+|--------|--------|-----------|
+| Phase transition | May pause | Auto-continues |
+| On error | Reports and stops | Auto-retries (3x) |
+| Context 70%+ | Warning only | Auto-compress + save |
+| Exploration | Sequential possible | FORCED parallel |
+| Completion | Phase-by-phase | Until ALL done |
+
+---
+
+## Rules Reference
+
+**Must follow `.vibe/rules/`:**
+- `core/development-philosophy.md` - Surgical precision, modify only requested scope
+- `core/quick-start.md` - Korean, DRY, SRP, YAGNI
+- `standards/complexity-metrics.md` - Functions ≤20 lines, nesting ≤3 levels
+- `quality/checklist.md` - Code quality checklist
+
+## Description
+
+Read PTCF structured SPEC document and execute implementation immediately.
+
+> **PLAN, TASKS documents unnecessary** - SPEC is the executable prompt
+
+## Model Orchestration
+
+Automatically select optimal model based on task type:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│               Opus 4.5 (Orchestrator)                       │
+│               - Coordinate overall flow                     │
+│               - Final decisions/review                      │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+    ┌─────────────────────┼─────────────────────┐
+    ↓                     ↓                     ↓
+┌─────────┐         ┌─────────┐         ┌─────────┐
+│ Haiku   │         │ Sonnet  │         │ Haiku   │
+│(Explore)│         │ (Impl)  │         │ (Test)  │
+└─────────┘         └─────────┘         └─────────┘
+```
+
+### Task Calls by Role
+
+| Task Type | Model | Task Parameter |
+|-----------|-------|----------------|
+| Codebase exploration | Haiku 4.5 | `model: "haiku"` |
+| Core implementation | Sonnet 4 | `model: "sonnet"` |
+| Test writing | Haiku 4.5 | `model: "haiku"` |
+| Architecture decisions | Opus 4.5 | Main session |
+| Final review | Opus 4.5 | Main session |
+
+### External LLM Usage (When Enabled)
+
+When external LLMs are enabled in `.vibe/config.json`:
+
+| Role | Model | Condition |
+|------|-------|-----------|
+| Architecture/Debugging | GPT 5.2 | When `vibe gpt <key>` executed |
+| UI/UX Design, Exploration | Gemini 2.5/3 | When `vibe gemini --auth` executed |
+
+When external LLM enabled, automatically called via MCP:
+- `mcp__vibe-gpt__chat` - GPT 5.2 architecture consultation
+- `mcp__vibe-gemini__gemini_chat` - Gemini 질문/상담
+- `mcp__vibe-gemini__gemini_analyze_code` - 코드 분석
+- `mcp__vibe-gemini__gemini_review_ui` - UI/UX 리뷰
+- `mcp__vibe-gemini__gemini_quick_ask` - 빠른 질문 (탐색용)
+
+### External LLM Fallback
+
+**IMPORTANT**: When Gemini/GPT MCP returns `"status": "fallback"`, Claude MUST handle the task directly:
+
+```json
+{
+  "status": "fallback",
+  "reason": "rate_limit",  // or "auth_error"
+  "message": "Gemini API 할당량 초과. Claude가 직접 처리해주세요."
+}
+```
+
+**Fallback behavior**:
+- Do NOT retry the external LLM call
+- Claude handles the task using its own capabilities
+- Continue with the implementation without interruption
+- Log the fallback but don't block progress
+
+## Semantic Code Analysis (hi-ai MCP)
+
+Use hi-ai MCP semantic tools to accurately understand codebase before implementation:
+
+| MCP Tool | Purpose | When Used |
+|----------|---------|-----------|
+| `vibe_find_symbol` | Find symbol definitions | Locate class/function |
+| `vibe_find_references` | Find references | Analyze impact scope |
+| `vibe_analyze_complexity` | Analyze complexity | Determine refactoring need |
+| `vibe_validate_code_quality` | Validate quality | Verify post-implementation quality |
+
+### Semantic Analysis Flow
+
+```
+Start Implementation
+    │
+    ├─→ find_symbol: Locate exact position of function/class to modify
+    │
+    ├─→ find_references: Check all places using that symbol
+    │
+    ├─→ analyze_complexity: Check existing code complexity
+    │
+    ↓
+Implementation (with accurate understanding of impact scope)
+    │
+    ↓
+validate_code_quality: Verify quality after implementation
+```
+
+### Context Management (Session Continuity)
+
+| MCP Tool | Purpose |
+|----------|---------|
+| `vibe_start_session` | Start session, restore previous context |
+| `vibe_auto_save_context` | Auto-save current state |
+| `vibe_restore_session_context` | Restore previous session context |
+| `vibe_save_memory` | Save important decisions/patterns |
+
+**On session start**: `vibe_start_session` auto-restores previous context
+**On session end**: Hook auto-executes `vibe_auto_save_context`
+
+## Process
+
+### 1. Load SPEC + Feature
+
+```
+📄 .vibe/specs/{feature-name}.md      → SPEC (구조, 제약, 컨텍스트)
+📄 .vibe/features/{feature-name}.feature → Feature (시나리오 = 구현 단위)
+```
+
+**Feature 파일이 없으면 에러**:
+```
+❌ Feature 파일이 없습니다.
+   먼저 /vibe.spec "{feature-name}"을 실행하세요.
+```
+
+### 2. Scenario 목록 추출
+
+Feature 파일에서 모든 Scenario 추출:
+
+```markdown
+## Scenarios to Implement
+
+| # | Scenario | Status |
+|---|----------|--------|
+| 1 | 유효한 로그인 성공 | ⬜ |
+| 2 | 잘못된 비밀번호 에러 | ⬜ |
+| 3 | 이메일 형식 검증 | ⬜ |
+| 4 | 비밀번호 찾기 링크 | ⬜ |
+
+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회)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## **CRITICAL: Parallel Sub-Agent Execution**
+
+> **MUST USE PARALLEL TASK CALLS** - This is REQUIRED, not optional.
+> Sequential execution when parallel is possible = VIOLATION of this workflow.
+
+### Mandatory Parallel Exploration (Phase Start)
+
+**BEFORE any implementation, you MUST launch these Task calls IN PARALLEL (single message, multiple tool calls):**
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  STEP 1: PARALLEL EXPLORATION (REQUIRED)                        │
+│                                                                 │
+│  Launch ALL of these in ONE message:                            │
+│                                                                 │
+│  Task(haiku) ─┬─→ "Analyze related files in <context>"          │
+│               │                                                 │
+│  Task(haiku) ─┼─→ "Check dependencies and imports"              │
+│               │                                                 │
+│  Task(haiku) ─┴─→ "Find existing patterns and conventions"      │
+│                                                                 │
+│  [If GPT enabled] + MCP(vibe-gpt): Architecture review          │
+│  [If Gemini enabled] + MCP(vibe-gemini): UI/UX consultation     │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+                              ↓ (wait for all to complete)
+┌─────────────────────────────────────────────────────────────────┐
+│  STEP 2: SYNTHESIZE (Opus)                                      │
+│  - Review all exploration results                               │
+│  - Decide implementation approach                               │
+│  - Identify files to modify/create                              │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│  STEP 3: IMPLEMENT (Task sonnet)                                │
+│  - Execute implementation with full context                     │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│  STEP 4: TEST (Task haiku)                                      │
+│  - Write tests for implemented code                             │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### Parallel Task Call Pattern (MUST FOLLOW)
+
+**Correct - Single message with multiple parallel Tasks:**
+```
+<message>
+  Task(haiku, "Analyze src/components/ for existing patterns")
+  Task(haiku, "Check package.json dependencies")
+  Task(haiku, "Find usage of similar features in codebase")
+</message>
+→ All 3 run simultaneously, ~3x faster
+```
+
+**WRONG - Sequential calls (DO NOT DO THIS):**
+```
+<message>Task(haiku, "Analyze...")</message>
+<message>Task(haiku, "Check...")</message>
+<message>Task(haiku, "Find...")</message>
+→ 3x slower, wastes time
+```
+
+### Why Parallel Matters
+
+| Approach | Time | Cache Benefit |
+|----------|------|---------------|
+| Sequential (3 Tasks) | ~30s | Cache cold on each |
+| **Parallel (3 Tasks)** | **~10s** | **Cache warmed once, shared** |
+
+hi-ai ProjectCache (LRU) caches ts-morph parsing results. Parallel calls share the warmed cache.
+
+### Phase Execution Flow
+
+```
+Phase N Start
+    │
+    ├─→ [PARALLEL] Task(haiku) × 2-3: Exploration
+    │       - Related code analysis
+    │       - Dependency check
+    │       - Pattern discovery
+    │
+    ↓ (all complete)
+    │
+    ├─→ Opus: Synthesize and decide
+    │
+    ├─→ Task(sonnet): Implementation
+    │
+    ├─→ Task(haiku): Tests
+    │
+    ↓
+Phase N Complete → Next Phase
+```
+
+---
+
+1. **Related code analysis**: Task(haiku) explores `<context>` related code
+2. **File creation/modification**: Task(sonnet) implements per `<output_format>`
+3. **Constraint compliance**: Check `<constraints>`
+4. **Run verification**: Execute verification commands
+
+### 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)
+- 빌드/테스트 상태
+
+**이것만 보면 품질을 신뢰할 수 있음.**
+
+### 5. Update Feature File
+
+시나리오 상태 자동 업데이트:
+
+```markdown
+## 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
+
+Follow during implementation:
+
+| Principle | Description |
+|-----------|-------------|
+| **T**est-first | Write tests first |
+| **R**eadable | Clear code |
+| **U**nified | Consistent style |
+| **S**ecured | Consider security |
+| **T**rackable | Logging, monitoring |
+
+## Input
+
+- `.vibe/specs/{feature-name}.md` (PTCF SPEC)
+- `.vibe/features/{feature-name}.feature` (BDD)
+- `CLAUDE.md` (project context)
+
+## Output
+
+- Implemented code files
+- Test files
+- Updated SPEC document (checkmarks)
+
+## Example
+
+```
+User: /vibe.run "login"
+
+Claude:
+📄 Loading SPEC: .vibe/specs/login.md
+📄 Loading Feature: .vibe/features/login.feature
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 Scenarios to Implement
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+| # | Scenario | Status |
+|---|----------|--------|
+| 1 | 유효한 로그인 성공 | ⬜ |
+| 2 | 잘못된 비밀번호 에러 | ⬜ |
+| 3 | 이메일 형식 검증 | ⬜ |
+| 4 | 비밀번호 찾기 링크 | ⬜ |
+
+Total: 4 scenarios
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 Scenario 1/4: 유효한 로그인 성공
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Given: 사용자가 등록되어 있다
+When: 유효한 이메일과 비밀번호로 로그인
+Then: 로그인 성공 + JWT 토큰 반환
+
+⚡ [PARALLEL] 탐색 중...
+✅ 탐색 완료 (2.1s)
+
+🔨 구현 중...
+  ✅ auth.service.ts - login() 추가
+  ✅ auth.controller.ts - POST /login
+
+🔍 검증 중...
+  ✅ Given: OK
+  ✅ When: OK
+  ✅ Then: OK
+
+✅ Scenario 1 통과!
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 Scenario 2/4: 잘못된 비밀번호 에러
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔨 구현 중...
+  ✅ auth.service.ts - 비밀번호 검증 로직
+
+🔍 검증 중...
+  ✅ Given: OK
+  ✅ When: OK
+  ❌ Then: "Invalid credentials" 에러 메시지
+     실제: "Error" 반환
+
+🔄 자동 수정 1/3...
+  수정: auth.service.ts line 42
+
+🔍 재검증...
+  ✅ Then: OK
+
+✅ Scenario 2 통과! (수정 1회)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 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                                             │
+└─────────────────────────────────────────────────────────────────┘
+
+🎉 구현 완료! 모든 시나리오 통과.
+```
+
+### Phase-specific Execution
+
+```
+User: /vibe.run "brick-game" --phase 2
+
+Claude:
+📄 Reading SPEC: .vibe/specs/brick-game.md
+🎯 Executing Phase 2 only.
+
+Phase 2: Game Logic
+1. [ ] Paddle movement implementation
+2. [ ] Ball physics engine
+3. [ ] Brick collision handling
+4. [ ] Score system
+5. [ ] Game over conditions
+
+⚡ Launching parallel exploration...
+[Task(haiku) × 3 launched in parallel]
+
+🚀 Starting implementation...
+```
+
+## Error Handling
+
+On failure:
+1. Check error message
+2. Review `<constraints>`
+3. Fix code and retry
+4. If continues to fail, report to user
+
+## Next Step
+
+```
+/vibe.verify "brick-game"
+```
+
+---
+
+ARGUMENTS: $ARGUMENTS