@su-record/vibe 2.0.11 → 2.2.1

package/.claude/settings.json

@@ -10,7 +10,7 @@
       "Bash(git push:*)",
       "Bash(npm pack)",
       "Bash(npm install:*)",
-      "Read(//private/tmp/test-vibe-bdd/.vibe/**)",
+      "Read(//private/tmp/test-vibe-bdd/.claude/vibe/**)",
       "Read(//private/tmp/test-vibe-bdd/.claude/commands/**)",
       "Bash(npm view:*)",
       "Bash(gh release create:*)",

package/.claude/settings.local.json

@@ -14,7 +14,11 @@
       "Bash(claude mcp list:*)",
       "Bash(C:Usersendba.localbinclaude.exe --version)",
       "Bash(\"C:\\\\Users\\\\endba\\\\.local\\\\bin\\\\claude.exe\" --version)",
-      "Bash(npm cache clean:*)"
+      "Bash(npm cache clean:*)",
+      "Bash(git status:*)",
+      "Bash(gh pr create --repo anthropics/claude-plugins-official --title \"feat: add vibe plugin - SPEC-driven AI coding framework\" --body \"$\\(cat <<''EOF''\n## Plugin: vibe\n\nSPEC-driven AI coding framework for Claude Code with parallel agents, BDD verification, and quality assurance.\n\n### Features\n\n- **12 Slash Commands**: `/vibe.spec`, `/vibe.run`, `/vibe.verify`, `/vibe.review`, `/vibe.reason`, `/vibe.diagram`, and more\n- **16 Specialist Agents**: Security, performance, architecture reviewers + language-specific reviewers \\(Python, TypeScript, React, Rails\\)\n- **ULTRAWORK Pipeline**: Parallel execution with ~50% speed improvement through background agents and phase pipelining\n- **BDD Verification**: Behavior-driven development testing against SPEC requirements\n- **Context7 Integration**: Built-in support for up-to-date documentation lookup\n\n### Workflow\n\n```\n/vibe.spec \"feature\" → /vibe.run \"feature\" → /vibe.verify \"feature\"\n```\n\n### Repository\n\nhttps://github.com/su-record/vibe\n\n### License\n\nMIT\nEOF\n\\)\")",
+      "Bash(git rev-parse:*)",
+      "Bash(claude plugin:*)"
     ]
   }
 }

package/{.vibe → .claude/vibe}/rules/quality/bdd-contract-testing.md

@@ -216,7 +216,7 @@ def test_login_contract():
 
 ```bash
 vibe feature "user login"
-# → .vibe/features/user-login.feature 생성
+# → .claude/vibe/features/user-login.feature 생성
 ```
 
 ### Contract 테스트 생성

package/{.vibe → .claude/vibe}/setup.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 # Vibe 협업자 자동 설치 스크립트
-# 사용법: ./.vibe/setup.sh
+# 사용법: ./.claude/vibe/setup.sh
 
 set -e
 

package/CLAUDE.md

@@ -4,7 +4,7 @@ SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
 
 ## 코드 품질 기준 (필수)
 
-모든 코드 작성 시 아래 기준을 준수합니다. 상세 규칙은 `.vibe/rules/` 참조.
+모든 코드 작성 시 아래 기준을 준수합니다. 상세 규칙은 `.claude/vibe/rules/` 참조.
 
 ### 핵심 원칙
 - **요청 범위만 수정** - 관련 없는 코드 건드리지 않음
@@ -47,11 +47,21 @@ SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
 
 **활성화 기능:**
 - 병렬 서브에이전트 탐색 (3+ 동시)
+- **백그라운드 에이전트** - 구현 중 다음 Phase 준비
+- **Phase 파이프라이닝** - Phase 간 대기 시간 제거
 - Boulder Loop (모든 Phase 완료까지 자동 진행)
 - 에러 자동 재시도 (최대 3회)
 - 컨텍스트 70%+ 시 자동 압축/저장
 - Phase 간 확인 없이 연속 실행
 
+**속도 비교:**
+
+| Mode | Phase당 | 5 Phase |
+|------|---------|---------|
+| Sequential | ~2분 | ~10분 |
+| Parallel Exploration | ~1.5분 | ~7.5분 |
+| **ULTRAWORK Pipeline** | **~1분** | **~5분** |
+
 ## Commands
 
 | 명령어 | 설명 |
@@ -97,7 +107,7 @@ SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
 해결한 문제를 자동 문서화:
 
 ```
-.vibe/solutions/
+.claude/vibe/solutions/
 ├── security/           # 보안 해결책
 ├── performance/        # 성능 최적화
 ├── database/           # DB 관련
@@ -203,7 +213,7 @@ git worktree remove ../review-123
 
 ### Priority Todos
 ```
-.vibe/todos/
+.claude/vibe/todos/
 ├── P1-security-sql-injection.md   # 🔴 머지 차단
 ├── P2-perf-n1-query.md            # 🟡 수정 권장
 └── P3-style-extract-helper.md     # 🔵 백로그
@@ -265,12 +275,12 @@ vibe는 자체 메모리 시스템으로 세션 간 컨텍스트를 유지합니
 
 **반드시 포함:**
 - `.claude/` 폴더 전체 (commands, agents, skills, settings.json)
-- `.vibe/rules/`, `.vibe/specs/`, `.vibe/features/`, `.vibe/solutions/`, `.vibe/todos/`
+- `.claude/vibe/rules/`, `.claude/vibe/specs/`, `.claude/vibe/features/`, `.claude/vibe/solutions/`, `.claude/vibe/todos/`
 - `CLAUDE.md`
 
 **제외:**
 - `.claude/settings.local.json` (개인 설정, 자동 제외)
-- `.vibe/mcp/` (node_modules, 자동 제외)
+- `.claude/vibe/mcp/` (node_modules, 자동 제외)
 
 ## Getting Started
 
@@ -307,7 +317,7 @@ vibe init
 │     └── Playwright E2E 테스트                                   │
 │                                                                 │
 │  6. /vibe.compound                                              │
-│     └── 해결책 문서화 → .vibe/solutions/                        │
+│     └── 해결책 문서화 → .claude/vibe/solutions/                        │
 │                                                                 │
 └─────────────────────────────────────────────────────────────────┘
 ```

package/README.md

@@ -24,11 +24,16 @@ SPEC 문서 하나로 AI가 바로 구현하고, **시나리오별 자동 검증
 - **자동 컨텍스트 관리**: 80%+ 시 자동 저장, 세션 자동 복원
 - **36개 내장 도구**: 코드 분석, 품질 검증, 세션 메모리 (MCP 오버헤드 제거)
 
-### v2.1.0 신규 기능
+### v2.2.0 신규 기능
+
+- **⚡ ULTRAWORK Pipeline**: 구현 중 백그라운드 에이전트로 다음 Phase 준비
+- **🔄 Phase 파이프라이닝**: Phase 간 대기 시간 제거 (~50% 속도 향상)
+
+### v2.1.0 기능
 
 - **🔍 병렬 코드 리뷰**: 13+ 전문 에이전트가 동시 리뷰 (P1/P2/P3 우선순위)
 - **🎭 E2E 테스트**: Playwright 기반 브라우저 자동화 (시각적 회귀, 비디오 녹화)
-- **📚 지식 복리**: 해결책 자동 문서화 → `.vibe/solutions/`
+- **📚 지식 복리**: 해결책 자동 문서화 → `.claude/vibe/solutions/`
 - **🔬 병렬 리서치**: 요구사항 확정 후 4개 에이전트 동시 조사
 
 ---
@@ -37,25 +42,38 @@ SPEC 문서 하나로 AI가 바로 구현하고, **시나리오별 자동 검증
 
 ```bash
 npm install -g @su-record/vibe
+vibe init
+```
+
+**생성되는 구조:**
+
+```text
+.claude/
+├── commands/          # 슬래시 커맨드 (7개)
+├── agents/            # 서브에이전트
+├── settings.json      # Hooks 설정
+└── vibe/
+    ├── rules/         # 코딩 규칙
+    ├── specs/         # SPEC 문서
+    ├── features/      # BDD Feature 파일
+    └── config.json    # 프로젝트 설정
 ```
 
 ---
 
 ## Quick Start
 
-### 1. 프로젝트 초기화 (터미널)
-
 ```bash
 # 기존 프로젝트에서
 vibe init
-# → 내장 도구 활성화 + MCP 서버 등록 (vibe-gemini, vibe-gpt, context7)
+# → 커맨드/에이전트 설치 + MCP 서버 등록 (context7, vibe-gemini, vibe-gpt)
 
 # 새 프로젝트 생성
 vibe init my-project
 cd my-project
 ```
 
-### 2. 슬래시 커맨드 사용 (Claude Code)
+### 슬래시 커맨드 사용 (Claude Code)
 
 ```
 /vibe.spec "로그인 기능"              # SPEC 작성 (대화형)
@@ -73,7 +91,7 @@ cd my-project
 │  /vibe.spec "기능명"                                │
 │  ↓ 대화형 요구사항 수집                              │
 │  ↓ 요구사항 확정 후 4개 병렬 리서치 (v2.1.0)        │
-│  ↓ .vibe/specs/{기능명}.md + .feature              │
+│  ↓ .claude/vibe/specs/{기능명}.md + .feature              │
 ├─────────────────────────────────────────────────────┤
 │  /vibe.run "기능명" ultrawork                       │
 │  ↓ 시나리오별 구현 + 즉시 검증 (SDD)                │
@@ -89,7 +107,7 @@ cd my-project
 │  ↓ Playwright E2E 테스트                           │
 ├─────────────────────────────────────────────────────┤
 │  /vibe.compound                  ← NEW (v2.1.0)    │
-│  ↓ 해결책 문서화 → .vibe/solutions/                │
+│  ↓ 해결책 문서화 → .claude/vibe/solutions/                │
 └─────────────────────────────────────────────────────┘
 ```
 
@@ -305,7 +323,7 @@ Playwright 기반 브라우저 자동화 테스트:
 해결한 문제를 자동 문서화하여 지식 축적:
 
 ```
-.vibe/solutions/
+.claude/vibe/solutions/
 ├── security/           # 보안 해결책
 ├── performance/        # 성능 최적화
 ├── database/           # DB 관련
@@ -371,7 +389,7 @@ project/
 │   ├── skills/               # 스킬 (2개)             ← NEW
 │   ├── settings.json         # Hooks 설정
 │   └── settings.local.json   # 개인 설정               ← git 제외 (자동)
-└── .vibe/
+└── .claude/vibe/
     ├── config.json           # 프로젝트 설정           ← git 공유
     ├── constitution.md       # 프로젝트 원칙           ← git 공유
     ├── rules/                # 코딩 규칙               ← git 공유
@@ -389,7 +407,7 @@ project/
 ## Feature 파일 (BDD 시나리오)
 
 ```gherkin
-# .vibe/features/login.feature
+# .claude/vibe/features/login.feature
 
 Feature: 로그인
 
@@ -454,7 +472,7 @@ Then: {예상 결과}
 
 ---
 
-## Coding Rules (.vibe/rules/)
+## Coding Rules (.claude/vibe/rules/)
 
 ### 언어별 규칙 자동 적용
 
@@ -651,8 +669,8 @@ User: 1
 [대화 계속...]
 
 ✅ SPEC 문서 작성 완료!
-📄 .vibe/specs/brick-game.md
-📄 .vibe/features/brick-game.feature
+📄 .claude/vibe/specs/brick-game.md
+📄 .claude/vibe/features/brick-game.feature
 
 다음 단계: /vibe.run "벽돌게임"
 ```
@@ -693,7 +711,7 @@ npm install -g @su-record/vibe
 vibe update
 
 # 또는 setup 스크립트 실행
-./.vibe/setup.sh
+./.claude/vibe/setup.sh
 ```
 
 ### 사용법

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AA4yEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,qBAAqB,IAAI,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAErF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAy1EH,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,qBAAqB,IAAI,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAErF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/cli/index.js

@@ -300,7 +300,7 @@ function getLLMAuthStatus() {
     // GPT API 키 확인 (프로젝트 config)
     if (!status.gpt) {
         try {
-            const configPath = path.join(process.cwd(), '.vibe', 'config.json');
+            const configPath = path.join(process.cwd(), '.claude', 'vibe', 'config.json');
             if (fs.existsSync(configPath)) {
                 const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
                 if (config.models?.gpt?.enabled) {
@@ -334,7 +334,7 @@ function getLLMAuthStatus() {
     // Gemini API 키 확인 (프로젝트 config)
     if (!status.gemini) {
         try {
-            const configPath = path.join(process.cwd(), '.vibe', 'config.json');
+            const configPath = path.join(process.cwd(), '.claude', 'vibe', 'config.json');
             if (fs.existsSync(configPath)) {
                 const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
                 if (config.models?.gemini?.enabled) {
@@ -641,7 +641,7 @@ function detectTechStacks(projectRoot) {
 // ============================================================================
 function setupCollaboratorAutoInstall(projectRoot) {
     const packageJsonPath = path.join(projectRoot, 'package.json');
-    const vibeDir = path.join(projectRoot, '.vibe');
+    const vibeDir = path.join(projectRoot, '.claude', 'vibe');
     const vibeVersion = getPackageJson().version;
     // 1. Node.js 프로젝트: package.json 정리
     if (fs.existsSync(packageJsonPath)) {
@@ -687,12 +687,15 @@ function setupCollaboratorAutoInstall(projectRoot) {
             log('   ⚠️  package.json 수정 실패: ' + e.message + '\n');
         }
     }
-    // 2. .vibe/setup.sh 생성
+    // 2. .claude/vibe/setup.sh 생성
     const setupShPath = path.join(vibeDir, 'setup.sh');
+    if (!fs.existsSync(vibeDir)) {
+        fs.mkdirSync(vibeDir, { recursive: true });
+    }
     if (!fs.existsSync(setupShPath)) {
         const setupScript = `#!/bin/bash
 # Vibe 협업자 자동 설치 스크립트
-# 사용법: ./.vibe/setup.sh
+# 사용법: ./.claude/vibe/setup.sh
 
 set -e
 
@@ -724,7 +727,7 @@ echo "  /vibe.run \\"기능명\\"     구현 실행"
 `;
         fs.writeFileSync(setupShPath, setupScript);
         fs.chmodSync(setupShPath, '755');
-        log('   ✅ 협업자 설치 스크립트 생성 (.vibe/setup.sh)\n');
+        log('   ✅ 협업자 설치 스크립트 생성 (.claude/vibe/setup.sh)\n');
     }
     // 3. README.md에 협업자 안내 추가
     const readmePath = path.join(projectRoot, 'README.md');
@@ -741,7 +744,7 @@ npm install -g @su-record/vibe
 vibe update
 
 # 또는 setup 스크립트 실행
-./.vibe/setup.sh
+./.claude/vibe/setup.sh
 \`\`\`
 
 ### 사용법
@@ -869,9 +872,9 @@ async function init(projectName) {
             fs.mkdirSync(projectRoot, { recursive: true });
             isNewProject = true;
         }
-        const vibeDir = path.join(projectRoot, '.vibe');
+        const vibeDir = path.join(projectRoot, '.claude', 'vibe');
         if (fs.existsSync(vibeDir)) {
-            log('❌ .vibe/ 폴더가 이미 존재합니다.');
+            log('❌ .claude/vibe/ 폴더가 이미 존재합니다.');
             return;
         }
         ensureDir(vibeDir);
@@ -918,25 +921,33 @@ async function init(projectName) {
                 log('   ⚠️  Context7 MCP 수동 등록 필요\n');
             }
         }
-        // .vibe 폴더 구조 생성
+        // .claude/vibe 폴더 구조 생성
         ['specs', 'features'].forEach(dir => {
             ensureDir(path.join(vibeDir, dir));
         });
-        // 기존 .vibe/mcp/ 폴더 정리
-        const oldMcpDir = path.join(vibeDir, 'mcp');
-        if (fs.existsSync(oldMcpDir)) {
-            log('   🧹 기존 .vibe/mcp/ 폴더 정리 중...\n');
+        // 기존 .vibe/ 폴더 마이그레이션 (레거시)
+        const legacyVibeDir = path.join(projectRoot, '.vibe');
+        if (fs.existsSync(legacyVibeDir)) {
+            log('   🔄 레거시 .vibe/ 폴더 마이그레이션 중...\n');
             try {
-                removeDirRecursive(oldMcpDir);
-                log('   ✅ .vibe/mcp/ 폴더 삭제 완료\n');
+                // specs, features 등 데이터 폴더 이동
+                ['specs', 'features', 'solutions', 'todos', 'memory'].forEach(dir => {
+                    const legacySrc = path.join(legacyVibeDir, dir);
+                    const newDest = path.join(vibeDir, dir);
+                    if (fs.existsSync(legacySrc) && !fs.existsSync(newDest)) {
+                        copyDirRecursive(legacySrc, newDest);
+                    }
+                });
+                removeDirRecursive(legacyVibeDir);
+                log('   ✅ .vibe/ → .claude/vibe/ 마이그레이션 완료\n');
             }
             catch (e) {
-                log('   ⚠️  .vibe/mcp/ 폴더 수동 삭제 필요\n');
+                log('   ⚠️  마이그레이션 실패 - .vibe/ 폴더 수동 삭제 필요\n');
             }
         }
         // .gitignore 업데이트
         const gitignorePath = path.join(projectRoot, '.gitignore');
-        const mcpIgnore = '.vibe/mcp/';
+        const mcpIgnore = '.claude/vibe/mcp/';
         if (fs.existsSync(gitignorePath)) {
             let gitignore = fs.readFileSync(gitignorePath, 'utf-8');
             if (!gitignore.includes(mcpIgnore)) {
@@ -1026,8 +1037,8 @@ async function init(projectName) {
             fs.writeFileSync(projectClaudeMd, vibeContent);
             log('   ✅ CLAUDE.md 생성\n');
         }
-        // .vibe/rules/ 복사
-        const rulesSource = path.join(__dirname, '../../.vibe/rules');
+        // .claude/vibe/rules/ 복사
+        const rulesSource = path.join(__dirname, '../../.claude/vibe/rules');
         const rulesTarget = path.join(vibeDir, 'rules');
         const coreDirs = ['core', 'quality', 'standards', 'tools'];
         coreDirs.forEach(dir => {
@@ -1050,7 +1061,7 @@ async function init(projectName) {
                 }
             });
         }
-        log('   ✅ 코딩 규칙 설치 완료 (.vibe/rules/)\n');
+        log('   ✅ 코딩 규칙 설치 완료 (.claude/vibe/rules/)\n');
         // .claude/agents/ 복사
         const agentsDir = path.join(claudeDir, 'agents');
         ensureDir(agentsDir);
@@ -1097,17 +1108,17 @@ ${isNewProject ? `프로젝트 위치:
   .claude/
   ├── commands/                  # 슬래시 커맨드 (7개)
   ├── agents/                    # 서브에이전트 (simplifier)
-  └── settings.json              # Hooks 설정 (저장소 공유)
-  .vibe/
-  ├── config.json                # 프로젝트 설정
-  ├── constitution.md            # 프로젝트 원칙
-  ├── setup.sh                   # 협업자 설치 스크립트
-  ├── rules/                     # 코딩 규칙
-  │   ├── core/                  # 핵심 원칙
-  │   ├── quality/               # 품질 체크리스트
-  │   └── languages/             # 언어별 규칙
-  ├── specs/                     # SPEC 문서들
-  └── features/                  # BDD Feature 파일들
+  ├── settings.json              # Hooks 설정 (저장소 공유)
+  └── vibe/
+      ├── config.json            # 프로젝트 설정
+      ├── constitution.md        # 프로젝트 원칙
+      ├── setup.sh               # 협업자 설치 스크립트
+      ├── rules/                 # 코딩 규칙
+      │   ├── core/              # 핵심 원칙
+      │   ├── quality/           # 품질 체크리스트
+      │   └── languages/         # 언어별 규칙
+      ├── specs/                 # SPEC 문서들
+      └── features/              # BDD Feature 파일들
 
 내장 도구: ✓ (35+)
 협업자 자동 설치: ✓
@@ -1164,18 +1175,45 @@ async function checkAndUpgradeVibe() {
 async function update() {
     try {
         const projectRoot = process.cwd();
-        const vibeDir = path.join(projectRoot, '.vibe');
+        const vibeDir = path.join(projectRoot, '.claude', 'vibe');
         const claudeDir = path.join(projectRoot, '.claude');
+        const legacyVibeDir = path.join(projectRoot, '.vibe');
         // CI/프로덕션 환경에서는 스킵
         if (process.env.NODE_ENV === 'production' || process.env.CI === 'true') {
             return;
         }
-        if (!fs.existsSync(vibeDir)) {
+        // 레거시 .vibe/ 폴더가 있으면 마이그레이션
+        if (fs.existsSync(legacyVibeDir) && !fs.existsSync(vibeDir)) {
+            log('🔄 .vibe/ → .claude/vibe/ 마이그레이션 중...\n');
+            ensureDir(vibeDir);
+            ['specs', 'features', 'solutions', 'todos', 'memory', 'rules', 'config.json', 'constitution.md'].forEach(item => {
+                const src = path.join(legacyVibeDir, item);
+                const dst = path.join(vibeDir, item);
+                if (fs.existsSync(src) && !fs.existsSync(dst)) {
+                    if (fs.statSync(src).isDirectory()) {
+                        copyDirRecursive(src, dst);
+                    }
+                    else {
+                        fs.copyFileSync(src, dst);
+                    }
+                }
+            });
+            try {
+                removeDirRecursive(legacyVibeDir);
+                log('   ✅ 마이그레이션 완료\n');
+            }
+            catch (e) {
+                log('   ⚠️  .vibe/ 폴더 수동 삭제 필요\n');
+            }
+        }
+        if (!fs.existsSync(vibeDir) && !fs.existsSync(legacyVibeDir)) {
             if (!options.silent) {
                 console.log('❌ vibe 프로젝트가 아닙니다. 먼저 vibe init을 실행하세요.');
             }
             return;
         }
+        // vibeDir이 없으면 생성
+        ensureDir(vibeDir);
         log('🔄 vibe 업데이트 중...\n');
         // 최신 버전 확인
         if (!options.silent) {
@@ -1183,11 +1221,11 @@ async function update() {
             if (wasUpgraded)
                 return;
         }
-        // 마이그레이션: .agent/rules/ → .vibe/rules/
+        // 마이그레이션: .agent/rules/ → .claude/vibe/rules/
         const oldRulesDir = path.join(projectRoot, '.agent/rules');
         const oldAgentDir = path.join(projectRoot, '.agent');
         if (fs.existsSync(oldRulesDir)) {
-            log('   🔄 마이그레이션: .agent/rules/ → .vibe/rules/\n');
+            log('   🔄 마이그레이션: .agent/rules/ → .claude/vibe/rules/\n');
             removeDirRecursive(oldRulesDir);
             if (fs.existsSync(oldAgentDir) && fs.readdirSync(oldAgentDir).length === 0) {
                 fs.rmdirSync(oldAgentDir);
@@ -1283,8 +1321,8 @@ async function update() {
                 log('   ✅ CLAUDE.md 생성\n');
             }
         }
-        // .vibe/rules/ 업데이트
-        const rulesSource = path.join(__dirname, '../../.vibe/rules');
+        // .claude/vibe/rules/ 업데이트
+        const rulesSource = path.join(__dirname, '../../.claude/vibe/rules');
         const rulesTarget = path.join(vibeDir, 'rules');
         const coreDirs = ['core', 'quality', 'standards', 'tools'];
         coreDirs.forEach(dir => {
@@ -1313,7 +1351,7 @@ async function update() {
         if (detectedStacks.length > 0) {
             log(`   🔍 감지된 기술 스택: ${detectedTypes.join(', ')}\n`);
         }
-        log('   ✅ 코딩 규칙 업데이트 완료 (.vibe/rules/)\n');
+        log('   ✅ 코딩 규칙 업데이트 완료 (.claude/vibe/rules/)\n');
         // .claude/agents/ 업데이트
         const agentsDir = path.join(claudeDir, 'agents');
         ensureDir(agentsDir);
@@ -1452,16 +1490,16 @@ async function update() {
         catch (e) {
             log('   ⚠️  MCP 등록 실패\n');
         }
-        // 기존 .vibe/mcp/ 폴더 정리
+        // 기존 mcp/ 폴더 정리 (레거시)
         const oldMcpDir = path.join(vibeDir, 'mcp');
         if (fs.existsSync(oldMcpDir)) {
-            log('   🧹 기존 .vibe/mcp/ 폴더 정리 중...\n');
+            log('   🧹 기존 mcp/ 폴더 정리 중...\n');
             try {
                 removeDirRecursive(oldMcpDir);
-                log('   ✅ .vibe/mcp/ 폴더 삭제 완료\n');
+                log('   ✅ mcp/ 폴더 삭제 완료\n');
             }
             catch (e) {
-                log('   ⚠️  .vibe/mcp/ 폴더 수동 삭제 필요\n');
+                log('   ⚠️  mcp/ 폴더 수동 삭제 필요\n');
             }
         }
         const packageJson = getPackageJson();
@@ -1470,7 +1508,7 @@ async function update() {
 
 업데이트된 항목:
   - 슬래시 커맨드 (7개)
-  - 코딩 규칙 (.vibe/rules/)
+  - 코딩 규칙 (.claude/vibe/rules/)
   - 서브에이전트 (.claude/agents/)
   - Hooks 설정
 
@@ -1484,9 +1522,10 @@ ${formatLLMStatus()}
 }
 function remove() {
     const projectRoot = process.cwd();
-    const vibeDir = path.join(projectRoot, '.vibe');
+    const vibeDir = path.join(projectRoot, '.claude', 'vibe');
+    const legacyVibeDir = path.join(projectRoot, '.vibe');
     const claudeDir = path.join(projectRoot, '.claude');
-    if (!fs.existsSync(vibeDir)) {
+    if (!fs.existsSync(vibeDir) && !fs.existsSync(legacyVibeDir)) {
         console.log('❌ vibe 프로젝트가 아닙니다.');
         return;
     }
@@ -1497,10 +1536,15 @@ function remove() {
     unregisterMcp('vibe-gpt');
     unregisterMcp('context7');
     console.log('   ✅ MCP 서버 제거 완료\n');
-    // .vibe 폴더 제거
+    // .claude/vibe 폴더 제거
     if (fs.existsSync(vibeDir)) {
         removeDirRecursive(vibeDir);
-        console.log('   ✅ .vibe/ 폴더 제거 완료\n');
+        console.log('   ✅ .claude/vibe/ 폴더 제거 완료\n');
+    }
+    // 레거시 .vibe 폴더도 제거
+    if (fs.existsSync(legacyVibeDir)) {
+        removeDirRecursive(legacyVibeDir);
+        console.log('   ✅ .vibe/ 폴더 제거 완료 (레거시)\n');
     }
     // .claude/commands 제거
     const commandsDir = path.join(claudeDir, 'commands');
@@ -1544,7 +1588,7 @@ function remove() {
 
 제거된 항목:
   - MCP 서버 (vibe, context7)
-  - .vibe/ 폴더
+  - .claude/vibe/ 폴더
   - 슬래시 커맨드 (7개)
   - 서브에이전트 (5개)
   - Hooks 설정
@@ -1568,7 +1612,7 @@ ${llmType === 'gpt' ? 'OpenAI API 키: https://platform.openai.com/api-keys' : '
         return;
     }
     const projectRoot = process.cwd();
-    const vibeDir = path.join(projectRoot, '.vibe');
+    const vibeDir = path.join(projectRoot, '.claude', 'vibe');
     const configPath = path.join(vibeDir, 'config.json');
     if (!fs.existsSync(vibeDir)) {
         console.log('❌ vibe 프로젝트가 아닙니다. 먼저 vibe init을 실행하세요.');
@@ -1615,7 +1659,7 @@ MCP: ${llmConfig.name}
 }
 function removeExternalLLM(llmType) {
     const projectRoot = process.cwd();
-    const vibeDir = path.join(projectRoot, '.vibe');
+    const vibeDir = path.join(projectRoot, '.claude', 'vibe');
     const configPath = path.join(vibeDir, 'config.json');
     if (!fs.existsSync(vibeDir)) {
         console.log('❌ vibe 프로젝트가 아닙니다.');
@@ -1670,7 +1714,7 @@ ChatGPT Plus 또는 Pro 구독이 있으면 Codex API를 사용할 수 있습니
     `);
         // config.json 업데이트
         const projectRoot = process.cwd();
-        const vibeDir = path.join(projectRoot, '.vibe');
+        const vibeDir = path.join(projectRoot, '.claude', 'vibe');
         const configPath = path.join(vibeDir, 'config.json');
         if (fs.existsSync(configPath)) {
             try {
@@ -1773,7 +1817,7 @@ ${activeAccount.email} 계정이 제거되었습니다.
     `);
         // config.json 업데이트
         const projectRoot = process.cwd();
-        const vibeDir = path.join(projectRoot, '.vibe');
+        const vibeDir = path.join(projectRoot, '.claude', 'vibe');
         const configPath = path.join(vibeDir, 'config.json');
         if (fs.existsSync(configPath)) {
             try {
@@ -1857,7 +1901,7 @@ Gemini Advanced 구독이 있으면 추가 비용 없이 사용할 수 있습니
     `);
         // config.json 업데이트
         const projectRoot = process.cwd();
-        const vibeDir = path.join(projectRoot, '.vibe');
+        const vibeDir = path.join(projectRoot, '.claude', 'vibe');
         const configPath = path.join(vibeDir, 'config.json');
         if (fs.existsSync(configPath)) {
             try {
@@ -1967,7 +2011,7 @@ ${activeAccount.email} 계정이 제거되었습니다.
     `);
         // config.json 업데이트
         const projectRoot = process.cwd();
-        const vibeDir = path.join(projectRoot, '.vibe');
+        const vibeDir = path.join(projectRoot, '.claude', 'vibe');
         const configPath = path.join(vibeDir, 'config.json');
         if (fs.existsSync(configPath)) {
             try {
@@ -2042,7 +2086,7 @@ Workflow:
 }
 function showStatus() {
     const projectRoot = process.cwd();
-    const vibeDir = path.join(projectRoot, '.vibe');
+    const vibeDir = path.join(projectRoot, '.claude', 'vibe');
     const configPath = path.join(vibeDir, 'config.json');
     if (!fs.existsSync(vibeDir)) {
         console.log('❌ vibe 프로젝트가 아닙니다. 먼저 vibe init을 실행하세요.');