@su-record/vibe 2.4.70 → 2.4.72

package/commands/vibe.spec.md

@@ -305,6 +305,54 @@ node -e "import('@su-record/vibe/orchestrator').then(o => o.research('passkey au
 
 ### 4. Write SPEC Document (PTCF Structure)
 
+#### 4.0 Large Scope Detection & Auto-Split (MANDATORY)
+
+**🚨 CRITICAL: Automatically split SPEC when scope is large**
+
+**❌ DO NOT ask user for confirmation - auto-split silently**
+
+**Detection criteria (ANY triggers split):**
+
+| Criteria | Threshold |
+|----------|-----------|
+| Phases | 5+ phases |
+| Files to create | 15+ files |
+| Platforms | 2+ platforms |
+| Major features | 4+ distinct features |
+
+**Auto-split output:**
+
+```
+.claude/vibe/specs/{feature-name}/
+├── _index.md           # Master SPEC
+├── phase-1-setup.md
+├── phase-2-core.md
+└── ...
+```
+
+**Master SPEC (`_index.md`):**
+
+```markdown
+# SPEC: {feature-name} (Master)
+
+## Overview
+- Total phases: N
+- Dependencies: [list]
+
+## Sub-SPECs
+
+| Order | SPEC File | Status |
+|-------|-----------|--------|
+| 1 | phase-1-setup.md | ⬜ |
+| 2 | phase-2-core.md | ⬜ |
+
+## Shared Context
+- Tech Stack: [all phases]
+- Constraints: [all phases]
+```
+
+**Small scope (default):**
+
 Create `.claude/vibe/specs/{feature-name}.md`:
 
 ```markdown
@@ -517,41 +565,46 @@ Self-evaluate against `~/.claude/vibe/rules/quality/checklist.md` (0-100 score)
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-**MUST: SPEC 리뷰 (필수)**
+**MUST: SPEC 리뷰 (필수) - GPT + Gemini 병렬 실행**
 
-Gemini 또는 GPT가 활성화된 경우, **반드시** Bash로 훅 스크립트 호출:
+🚨 **품질보장을 위해 GPT와 Gemini를 병렬로 실행하여 교차 검증**
 
-**GPT로 리뷰 (우선):**
+**병렬 실행 (2개의 Bash 호출을 동시에):**
 
 ```bash
-# Windows
+# GPT 리뷰 (코드 패턴, 아키텍처 관점)
 node "$APPDATA/vibe/hooks/scripts/llm-orchestrate.js" gpt orchestrate-json "Review SPEC for [기능명]. Stack: [스택]. Summary: [요약]. Check: completeness, error handling, security, edge cases."
 
-# macOS/Linux
-node ~/.config/vibe/hooks/scripts/llm-orchestrate.js gpt orchestrate-json "Review SPEC for [기능명]. Stack: [스택]. Summary: [요약]. Check: completeness, error handling, security, edge cases."
-
-# 커스텀 시스템 프롬프트 사용 시
-node "$APPDATA/vibe/hooks/scripts/llm-orchestrate.js" gpt orchestrate-json "You are a SPEC reviewer" "[질문]"
+# Gemini 리뷰 (최신 문서, 베스트 프랙티스 관점)
+node "$APPDATA/vibe/hooks/scripts/llm-orchestrate.js" gemini orchestrate-json "Review SPEC for [기능명]. Stack: [스택]. Summary: [요약]. Check: completeness, error handling, security, edge cases."
 ```
 
-**Gemini로 리뷰 (GPT 실패 시):**
+**macOS/Linux:**
 
 ```bash
-# Windows
-node "$APPDATA/vibe/hooks/scripts/llm-orchestrate.js" gemini orchestrate-json "Review SPEC for [기능명]. Stack: [스택]. Summary: [요약]. Check: completeness, error handling, security, edge cases."
+# GPT 리뷰
+node ~/.config/vibe/hooks/scripts/llm-orchestrate.js gpt orchestrate-json "Review SPEC for [기능명]. Stack: [스택]. Summary: [요약]. Check: completeness, error handling, security, edge cases."
 
-# macOS/Linux
+# Gemini 리뷰
 node ~/.config/vibe/hooks/scripts/llm-orchestrate.js gemini orchestrate-json "Review SPEC for [기능명]. Stack: [스택]. Summary: [요약]. Check: completeness, error handling, security, edge cases."
 ```
 
 **중요:**
 
-- Windows: `$APPDATA/vibe/hooks/scripts/` (Git Bash/PowerShell)
-- macOS/Linux: `~/.config/vibe/hooks/scripts/`
+- **반드시 GPT와 Gemini 둘 다 호출** (병렬 실행)
+- 두 모델의 피드백을 병합하여 SPEC에 반영
+- 한 모델 실패 시 나머지 결과만 반영
 - SPEC 전체를 보내지 말고 **핵심 요약**만 전송 (토큰 절약)
 - JSON 응답을 파싱하여 SPEC에 자동 반영
 
-**우선순위:** GPT 먼저 시도 → 실패 시 Gemini 시도 → 둘 다 실패 시 스킵
+**병렬 실행 이유:**
+
+| 모델 | 강점 |
+|------|------|
+| GPT | 코드 패턴, 아키텍처, 로직 검증 |
+| Gemini | 최신 웹 정보, 문서 검색, 베스트 프랙티스 |
+
+**결과 병합:** 두 모델의 피드백을 합쳐서 더 철저한 리뷰
 
 **리뷰 항목:**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@su-record/vibe",
-  "version": "2.4.70",
+  "version": "2.4.72",
   "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework with 35+ integrated tools",
   "type": "module",
   "main": "dist/cli/index.js",