@su-record/vibe 2.6.53 → 2.7.0

package/README.md

@@ -1,16 +1,14 @@
-# Vibe
+# VIBE — AI Coding Framework for Claude Code
 
-### Personalized AI Agent for Claude Code
-
-[![npm downloads](https://img.shields.io/npm/dt/@su-record/vibe.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@su-record/vibe)
 [![npm version](https://img.shields.io/npm/v/@su-record/vibe)](https://www.npmjs.com/package/@su-record/vibe)
+[![npm downloads](https://img.shields.io/npm/dt/@su-record/vibe.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@su-record/vibe)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18.0.0-green)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.5+-blue)](https://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**설치 한 줄로 Claude Code에 46개 에이전트, 41+ 도구, 4개 LLM을 더합니다.**
+**설치 한 줄로 Claude Code에 49개 에이전트, 41+ 도구, 멀티 LLM을 더합니다.**
 
-46개 에이전트 · 41+ 내장 도구 · 34개 스킬 · 4개 LLM 오케스트레이션 · 25개 프레임워크 지원
+49개 에이전트 · 41+ 내장 도구 · 멀티 LLM 오케스트레이션 · 25개 프레임워크 지원
 
 ---
 
@@ -35,11 +33,11 @@ vibe init
 - [훅 시스템](#훅-시스템)
 - [슬래시 명령어](#슬래시-명령어)
 - [41+ 내장 도구](#41-내장-도구)
-- [34개 스킬](#34개-스킬)
+- [스킬](#스킬)
 - [25개 프레임워크 지원](#25개-프레임워크-지원)
 - [품질 보장 시스템](#품질-보장-시스템)
 - [CLI 명령어](#cli-명령어)
-- [인증 동기화 (vibe sync)](#인증-동기화-vibe-sync)
+- [설정](#설정)
 - [매직 키워드](#매직-키워드)
 - [프로젝트 구조](#프로젝트-구조)
 - [시스템 아키텍처](#시스템-아키텍처)
@@ -95,69 +93,50 @@ flowchart LR
 
 ## 모듈 서브패스 Export
 
-`@su-record/vibe`는 런타임 모듈을 서브패스 export로 제공합니다. 필요한 모듈만 선택적으로 import할 수 있습니다.
-
-### 사용 가능한 서브패스
+`@su-record/vibe`는 런타임 모듈을 서브패스 export로 제공합니다.
 
 | 서브패스 | 설명 | 주요 export |
 |---------|------|------------|
 | `@su-record/vibe/agent` | 에이전트 시스템 | Agent 관련 클래스 및 타입 |
-| `@su-record/vibe/memory` | 메모리 시스템 (Storage, KnowledgeGraph, Session RAG) | `MemoryStorage`, `KnowledgeGraph`, `SessionRAGStore` 등 7개 클래스 + 18개 타입 |
-| `@su-record/vibe/orchestrator` | 오케스트레이터 (Swarm, Pipeline, Background) | `SwarmOrchestrator`, `PhasePipeline`, `BackgroundManager` |
+| `@su-record/vibe/memory` | 메모리 시스템 | `MemoryStorage`, `KnowledgeGraph`, `SessionRAGStore` 등 |
+| `@su-record/vibe/orchestrator` | 오케스트레이터 | `SwarmOrchestrator`, `PhasePipeline`, `BackgroundManager` |
 | `@su-record/vibe/tools` | 41+ 내장 도구 | `findSymbol`, `validateCodeQuality`, `saveMemory` 등 |
-| `@su-record/vibe/tools/*` | 개별 도구 서브패스 | 특정 도구만 import |
-
-### 사용 예시
 
 ```typescript
-// 메모리 시스템
 import { MemoryStorage, SessionRAGStore } from '@su-record/vibe/memory';
-import type { Decision, Goal, Evidence } from '@su-record/vibe/memory';
-
-// 오케스트레이터
 import { SwarmOrchestrator, PhasePipeline } from '@su-record/vibe/orchestrator';
-
-// 도구
 import { findSymbol, validateCodeQuality } from '@su-record/vibe/tools';
 ```
 
-### LLM Provider API
-
-```typescript
-import gptApi from '@su-record/vibe/lib/gpt';
-import geminiApi from '@su-record/vibe/lib/gemini';
-```
-
 ---
 
 ## 멀티 LLM 오케스트레이션
 
 복수의 LLM 프로바이더를 통합하여 작업 유형별 최적의 모델에 자동 라우팅합니다.
 
-### 지원 모델
+| 프로바이더 | 역할 | 인증 |
+|-----------|------|------|
+| **Claude** | 오케스트레이션, 코드 생성 | 내장 (Claude Code) |
+| **GPT** | 아키텍처, 디버깅, 교차 리뷰 | OAuth / API Key |
+| **Gemini** | UI/UX, 웹 검색, 음성, 리서치 | OAuth / API Key |
 
-| 프로바이더 | 모델 | 역할 | 인증 |
-|-----------|------|------|------|
-| **Claude** | Opus / Sonnet / Haiku | 오케스트레이션, 코드 생성 | 내장 |
-| **GPT** | GPT (Responses API) | 아키텍처, 디버깅 | OAuth / API 키 |
-| **Gemini** | Gemini Flash / Pro | UI/UX, 웹 검색, 음성 | OAuth / API 키 |
+```bash
+vibe gpt auth          # GPT OAuth (Plus/Pro)
+vibe gemini auth       # Gemini OAuth
+```
 
 ### SmartRouter — 작업 유형별 자동 라우팅
 
 | 작업 유형 | 우선순위 (폴백 체인) |
 |----------|---------------------|
-| 코드 분석, 리뷰, 추론 | GPT → Gemini → Claude |
-| 아키텍처, 디버깅 | GPT → Gemini → Claude |
+| 코드 분석, 리뷰, 추론, 아키텍처 | GPT → Gemini → Claude |
 | UI/UX, 웹 검색 | Gemini → GPT → Claude |
-| 코드 생성, 일반 | GPT → Claude |
 
 - 프로바이더별 30초 타임아웃, 최대 3회 재시도 (지수 백오프)
 - 5분 가용성 캐시 — 실패한 프로바이더는 5분간 스킵
 
 ### LLMCluster — 병렬 멀티 LLM 호출
 
-복수의 LLM에 동시에 쿼리하여 교차 검증합니다.
-
 ```mermaid
 flowchart TD
     A["사용자 요청"] --> B["LLMCluster.multiQuery"]
@@ -170,7 +149,7 @@ flowchart TD
 
 ### ReviewRace — 병렬 코드 리뷰
 
-GPT/Gemini가 동시에 코드를 리뷰하고, 결과를 교차 검증하여 우선순위를 산출합니다.
+GPT/Gemini가 동시에 코드를 리뷰하고, Jaccard 유사도로 교차 검증하여 우선순위를 산출합니다.
 
 | 우선순위 | 조건 |
 |----------|------|
@@ -184,9 +163,9 @@ P1/P2 이슈는 자동으로 수정됩니다.
 
 ## 에이전트 시스템
 
-46개 전문 에이전트가 각자의 역할에 맞게 작업을 수행합니다.
+49개 전문 에이전트가 각자의 역할에 맞게 작업을 수행합니다.
 
-### 메인 에이전트 (18)
+### 메인 에이전트 (19)
 
 | 에이전트 | 등급 | 역할 |
 |----------|------|------|
@@ -218,13 +197,9 @@ P1/P2 이슈는 자동으로 수정됩니다.
 | Git History Reviewer | 커밋 히스토리 위험 패턴 |
 | TypeScript/Python/Rails/React | 언어/프레임워크별 전문 리뷰 |
 
-### 리서치 에이전트 (4)
-
-Best Practices, Framework Docs, Codebase Patterns, Security Advisory
-
 ### UI/UX 에이전트 (8)
 
-CSV 데이터 기반 디자인 인텔리전스. BM25 검색 엔진으로 24개 CSV에서 산업별 디자인 전략을 자동 생성합니다.
+CSV 데이터 기반 디자인 인텔리전스. 24개 CSV에서 산업별 디자인 전략을 자동 생성합니다.
 
 | 단계 | 에이전트 | 역할 |
 |------|---------|------|
@@ -237,19 +212,29 @@ CSV 데이터 기반 디자인 인텔리전스. BM25 검색 엔진으로 24개 C
 | REVIEW | ui-a11y-auditor | WCAG 2.1 AA 접근성 감사 |
 | REVIEW | ui-antipattern-detector | UI 안티패턴 검출 |
 
+### 리서치 에이전트 (4)
+
+Best Practices, Framework Docs, Codebase Patterns, Security Advisory
+
 ### QA & 기획 에이전트 (6)
 
 Requirements Analyst, UX Advisor, Acceptance Tester, Edge Case Finder, API Documenter, Changelog Writer
 
-### 에이전트 팀 (Experimental)
+### 에이전트 팀 (9팀)
 
-에이전트들이 팀을 구성하여 공유 태스크 리스트로 협업하고 상호 피드백합니다.
+에이전트들이 팀을 구성하여 공유 태스크 리스트로 협업합니다.
 
-| 팀 | 워크플로우 | 역할 |
+| 팀 | 워크플로우 | 멤버 |
 |-----|-----------|------|
-| Research Team | `/vibe.spec` | 리서치 결과 교차 검증 + 통합 |
-| Review Debate Team | `/vibe.review` | P1/P2 교차 검증 + 오탐 제거 |
-| Implementation Team | `/vibe.run` ULTRAWORK | 실시간 협업 구현 + 즉시 피드백 |
+| Lite | `/vibe.run` 일반 | architect, implementer, tester |
+| Dev | `/vibe.run` ULTRAWORK | + security-reviewer |
+| Research | `/vibe.spec` | 4개 리서치 에이전트 |
+| Review Debate | `/vibe.review` | security, architecture, performance, simplicity |
+| SPEC Debate | `/vibe.spec.review` | 동일 |
+| Debug | `/vibe.run` 실패 | architect, implementer, tester |
+| Security | `/vibe.run` 보안 | security, data-integrity, security-advisory, tester |
+| Migration | `/vibe.run` 마이그레이션 | + build-error-resolver |
+| Fullstack | `/vibe.run` 풀스택 | frontend + backend implementer |
 
 ---
 
@@ -257,8 +242,6 @@ Requirements Analyst, UX Advisor, Acceptance Tester, Edge Case Finder, API Docum
 
 ### SwarmOrchestrator — 자동 작업 분해
 
-복잡한 요청을 자동으로 서브태스크로 분해하여 병렬 실행합니다.
-
 ```mermaid
 flowchart TD
     A["인증 시스템 구현해줘"] --> B{"복잡도 분석"}
@@ -273,72 +256,60 @@ flowchart TD
     G --> H
 ```
 
-- 최대 깊이 2단계, 동시 실행 5개, 기본 타임아웃 5분
-- 복잡도 산정: 프롬프트 길이 + 키워드 가중치 + 파일 멘션 수 + 리스트 항목 수
+최대 깊이 2단계, 동시 실행 5개, 기본 타임아웃 5분
 
 ### PhasePipeline — 단계별 실행
 
-각 Phase는 `prepare()` → `execute()` → `cleanup()` 생명주기를 가집니다.
-
-ULTRAWORK 모드에서는 현재 Phase 실행 중에 다음 Phase의 `prepare()`를 백그라운드로 미리 실행하여 Phase 간 대기 시간을 제거합니다.
+각 Phase는 `prepare()` → `execute()` → `cleanup()` 생명주기. ULTRAWORK 모드에서는 다음 Phase의 `prepare()`를 병렬 실행합니다.
 
 ### BackgroundManager — 비동기 에이전트 실행
 
 - 모델별/프로바이더별 동시 실행 제한
-- 바운디드 큐 (오버플로 방지)
-- 태스크 생명주기: `pending → running → completed/failed/cancelled`
 - 타임아웃 시 kill이 아닌 retry (최대 3회, 지수 백오프)
 - 24시간 이상 된 완료 태스크 자동 정리
 
 ### AgentRegistry — 실행 추적
 
-SQLite WAL 모드 기반 에이전트 실행 추적. 고아 프로세스 감지, 통계 조회, 24시간 TTL 자동 정리.
+SQLite WAL 모드 기반. 고아 프로세스 감지, 통계 조회, 24시간 TTL 자동 정리.
 
 ---
 
 ## Session RAG — 세션 간 컨텍스트 유지
 
-SQLite + FTS5 하이브리드 검색으로 세션 간 결정사항, 목표, 제약조건을 저장하고 복원합니다.
+SQLite + FTS5 하이브리드 검색으로 세션 간 결정사항, 목표, 제약조건을 유지합니다.
 
 ### 4가지 엔티티
 
 | 엔티티 | 설명 | 주요 필드 |
 |--------|------|-----------|
 | **Decision** | 사용자가 확인한 결정사항 | title, rationale, alternatives, priority |
-| **Constraint** | 명시적 제약조건 | title, type(technical/business/resource/quality), severity |
-| **Goal** | 현재 목표 (계층 지원) | title, status, priority, progressPercent, parentId |
-| **Evidence** | 검증/테스트 결과 | title, type(test/build/lint/coverage), status, metrics |
+| **Constraint** | 명시적 제약조건 | type(technical/business/resource/quality), severity |
+| **Goal** | 현재 목표 (계층 지원) | status, priority, progressPercent, parentId |
+| **Evidence** | 검증/테스트 결과 | type(test/build/lint/coverage), status, metrics |
 
-### 하이브리드 검색 알고리즘
+### 하이브리드 검색
 
 ```
-최종 점수 = BM25 점수 × 0.4 + 최신성 점수 × 0.3 + 우선순위 점수 × 0.3
+최종 점수 = BM25 × 0.4 + 최신성 × 0.3 + 우선순위 × 0.3
 ```
 
-- **BM25 (40%)** — FTS5 전문 검색, BM25 랭크 정규화
-- **최신성 (30%)** — 지수 감쇠: `exp(-age × ln(2) / 7일)` (7일 반감기)
-- **우선순위 (30%)** — 엔티티 유형별 가중치
-
-세션 시작 시 활성 Goals, 중요 Constraints, 최근 Decisions가 자동으로 컨텍스트에 주입됩니다.
+세션 시작 시 활성 Goals, 중요 Constraints, 최근 Decisions 자동 주입.
 
 ---
 
 ## 훅 시스템
 
-Claude Code의 이벤트에 자동으로 반응하는 훅 스크립트입니다.
-
 | 이벤트 | 스크립트 | 역할 |
 |--------|---------|------|
 | **SessionStart** | `session-start.js` | 세션 컨텍스트 복원, 메모리 로드 |
 | **PreToolUse** | `pre-tool-guard.js` | 파괴적 명령어 차단, 스코프 보호 |
-| **PostToolUse** | `code-check.js` | 린트, 타입 체크, 품질 검증 |
+| **PostToolUse** | `code-check.js` | 타입 안전성/복잡도 검증 |
 | **PostToolUse** | `post-edit.js` | Git 인덱스 업데이트 |
 | **UserPromptSubmit** | `prompt-dispatcher.js` | 명령어 라우팅 |
-| **UserPromptSubmit** | `skill-injector.js` | 스킬 자동 주입 |
 | **UserPromptSubmit** | `keyword-detector.js` | 매직 키워드 감지 |
-| **Notification** | `context-save.js` | 컨텍스트 80/90/95% 도달 시 자동 저장 |
+| **Notification** | `context-save.js` | 컨텍스트 80/90/95% 자동 저장 |
 
-추가 훅: `code-review.js`, `llm-orchestrate.js`, `recall.js`, `complexity.js`, `compound.js`
+추가 훅: `llm-orchestrate.js`, `code-review.js`, `recall.js`, `complexity.js`, `compound.js`, `stop-notify.js`
 
 ---
 
@@ -372,17 +343,6 @@ flowchart TD
     H --> I
 ```
 
-### SPEC 문서 구조 (PTCF)
-
-| 섹션 | 설명 |
-|------|------|
-| `<role>` | AI 역할 정의 |
-| `<context>` | 프로젝트 컨텍스트 |
-| `<task>` | 구현 작업 |
-| `<constraints>` | 제약조건 |
-| `<output_format>` | 출력 형식 |
-| `<acceptance>` | 인수 기준 |
-
 ---
 
 ## 41+ 내장 도구
@@ -396,102 +356,48 @@ flowchart TD
 | `manage_goals` | Goal 생명주기 관리 |
 | `core_save_memory` | 중요 결정사항 메모리 저장 |
 | `core_recall_memory` | 저장된 메모리 회상 |
-| `core_list_memories` | 전체 메모리 목록 |
 | `core_search_memories` | 메모리 검색 |
-| `core_search_memories_advanced` | 고급 메모리 검색 |
-| `core_link_memories` | 관련 메모리 연결 |
-| `core_get_memory_graph` | 메모리 그래프 시각화 |
-| `core_create_memory_timeline` | 메모리 타임라인 생성 |
 | `core_start_session` | 이전 세션 컨텍스트 복원 |
 | `core_auto_save_context` | 현재 상태 자동 저장 |
-| `core_restore_session_context` | 세션 컨텍스트 복원 |
-| `core_prioritize_memory` | 메모리 우선순위 지정 |
-| `core_add_observation` | 관찰 기록 추가 |
-| `core_search_observations` | 관찰 기록 검색 |
-| `core_update_memory` | 메모리 업데이트 |
-| `core_delete_memory` | 메모리 삭제 |
-| `core_get_session_context` | 현재 세션 컨텍스트 조회 |
-| `core_ask_user` | 사용자 질문 |
+| 그 외 12개 | 메모리 그래프, 타임라인, 우선순위, 관찰 기록 등 |
 
 ### 코드 품질 & 분석 (8)
 
-| 도구 | 역할 |
-|------|------|
-| `core_find_symbol` | 심볼 정의 검색 |
-| `core_find_references` | 참조 검색 |
-| `core_analyze_dependency_graph` | 의존성 그래프 분석 |
-| `core_analyze_complexity` | 순환 복잡도 분석 |
-| `core_validate_code_quality` | 품질 검증 (`any`, `@ts-ignore` 차단) |
-| `core_check_coupling_cohesion` | 커플링/응집도 체크 |
-| `core_suggest_improvements` | 개선 제안 |
-| `core_apply_quality_rules` | 품질 규칙 적용 |
+`core_find_symbol`, `core_find_references`, `core_analyze_dependency_graph`, `core_analyze_complexity`, `core_validate_code_quality`, `core_check_coupling_cohesion`, `core_suggest_improvements`, `core_apply_quality_rules`
 
 ### SPEC & 테스트 (9)
 
-| 도구 | 역할 |
-|------|------|
-| `core_spec_generator` | SPEC 문서 생성 (PTCF 형식) |
-| `core_prd_parser` | PRD 문서 파싱 |
-| `core_traceability_matrix` | 추적성 매트릭스 생성 |
-| `core_e2e_test_generator` | E2E 테스트 생성 |
-| `core_spec_versioning` | SPEC 버전 관리 |
-| `core_requirement_id` | 요구사항 ID 생성 |
-| `core_preview_ui_ascii` | ASCII UI 미리보기 |
-| `core_get_current_time` | 현재 시간 (소요 시간 추적) |
-| `core_ask_user` | 사용자 상호작용 |
+`core_spec_generator`, `core_prd_parser`, `core_traceability_matrix`, `core_e2e_test_generator`, `core_preview_ui_ascii`, `core_get_current_time` 등
 
 ### UI/UX 도구 (4)
 
-| 도구 | 역할 |
-|------|------|
-| `core_ui_search` | BM25 기반 UI 데이터 검색 |
-| `core_ui_stack_search` | 프레임워크별 UI 패턴 검색 |
-| `core_ui_generate_design_system` | 디자인 시스템 자동 생성 |
-| `core_ui_persist_design_system` | 디자인 시스템 저장 |
+`core_ui_search`, `core_ui_stack_search`, `core_ui_generate_design_system`, `core_ui_persist_design_system`
 
 ---
 
-## 34개 스킬
+## 스킬
 
 에이전트가 특정 도메인 지식을 활용할 수 있는 스킬 모듈입니다.
 
-### 코어 스킬 (18)
-
-Brand Assets, Commerce Patterns, Commit Push PR, Context7 Usage, Core Capabilities, E2E Commerce, Frontend Design, Git Worktree, Handoff, Multi-LLM Orchestration, Parallel Research, Priority Todos, SEO Checklist, Tech Debt, Tool Fallback, TypeScript Advanced Types, Vercel React, Vibe Capabilities
+**코어**: Brand Assets, Commerce Patterns, Commit Push PR, Context7, Core/Vibe Capabilities, E2E Commerce, Frontend Design, Git Worktree, Handoff, Parallel Research, Priority Todos, SEO Checklist, Tech Debt, Tool Fallback, TypeScript Advanced Types, Vercel React Best Practices, UI/UX Pro Max
 
-### 도메인별 스킬
+**언어별**: TypeScript-Next.js, TypeScript-React, TypeScript-React Native, Python-FastAPI, Dart-Flutter
 
-| 카테고리 | 스킬 |
-|----------|------|
-| **핵심 (3)** | Communication Guide, Development Philosophy, Quick Start |
-| **언어별 (5)** | TypeScript-Next.js, TypeScript-React, TypeScript-React Native, Python-FastAPI, Dart-Flutter |
-| **품질 (2)** | Checklist, Testing Strategy |
-| **표준 (4)** | Anti-Patterns, Code Structure, Complexity Metrics, Naming Conventions |
-| **도구 (2)** | MCP Hi-AI Guide, MCP Workflow |
+**품질/표준**: Checklist, Testing Strategy, Anti-Patterns, Code Structure, Complexity Metrics, Naming Conventions
 
 ---
 
 ## 25개 프레임워크 지원
 
-프로젝트의 기술 스택을 자동 감지하고, 해당 프레임워크의 코딩 규칙을 적용합니다.
-모노레포도 지원합니다 (pnpm-workspace, npm workspaces, Lerna, Nx, Turborepo).
-
-**TypeScript (12)** — Next.js, React, Angular, Vue, Svelte, Nuxt, NestJS, Node, Electron, Tauri, React Native, Astro
-
-**Python (2)** — Django, FastAPI
-
-**Java/Kotlin (4)** — Spring Boot, Java, Android, Kotlin
+프로젝트의 기술 스택을 자동 감지하고 프레임워크별 코딩 규칙을 적용합니다.
+모노레포 지원 (pnpm-workspace, npm workspaces, Lerna, Nx, Turborepo).
 
-**기타 (7)** — Rails, Go, Rust, Swift (iOS), Unity (C#), Flutter (Dart), Godot (GDScript)
+- **TypeScript (12)** — Next.js, React, Angular, Vue, Svelte, Nuxt, NestJS, Node, Electron, Tauri, React Native, Astro
+- **Python (2)** — Django, FastAPI
+- **Java/Kotlin (2)** — Spring Boot, Android
+- **기타** — Rails, Go, Rust, Swift (iOS), Unity (C#), Flutter (Dart), Godot (GDScript)
 
-### 자동 감지 대상
-
-| 카테고리 | 감지 항목 |
-|----------|----------|
-| **데이터베이스** | PostgreSQL, MySQL, MongoDB, Redis, SQLite, Prisma, Drizzle, Sequelize, TypeORM |
-| **상태 관리** | Redux, Zustand, Jotai, Recoil, MobX, React Query, SWR, Pinia, Vuex, Riverpod, BLoC |
-| **CI/CD** | GitHub Actions, GitLab CI, Jenkins, CircleCI |
-| **호스팅** | Vercel, Netlify, Google Cloud, Docker, Fly.io, Railway |
+자동 감지: DB (PostgreSQL, MySQL, MongoDB, Redis, Prisma, Drizzle 등), 상태 관리 (Redux, Zustand, Jotai 등), CI/CD (GitHub Actions 등), 호스팅 (Vercel, Docker 등)
 
 ---
 
@@ -500,14 +406,12 @@ Brand Assets, Commerce Patterns, Commit Push PR, Context7 Usage, Core Capabiliti
 | 가드레일 | 메커니즘 |
 |----------|---------|
 | **타입 안전성** | Quality Gate — `any`, `@ts-ignore` 차단 |
-| **코드 리뷰** | ReviewRace — GPT + Gemini 병렬 교차 검증 |
+| **코드 리뷰** | ReviewRace — GPT + Gemini 교차 검증 |
 | **완성도** | Ralph Loop — 100%까지 반복 (범위 축소 없음) |
-| **멀티 LLM** | LLMCluster — 교차 검증 |
 | **스코프 보호** | pre-tool-guard — 요청 범위 외 수정 방지 |
-| **컨텍스트 보호** | context-save — 80/90/95%에서 자동 저장 |
-| **합리화 방지** | Anti-Rationalization — AI 변명 패턴 6개 카테고리 차단 |
+| **컨텍스트 보호** | context-save — 80/90/95% 자동 저장 |
+| **합리화 방지** | Anti-Rationalization — AI 변명 패턴 차단 |
 | **증거 게이트** | Evidence Gate — 증거 없는 완료 주장 금지 |
-| **3-수정 규칙** | 동일 실패 3회 → 아키텍처 질문 전환 |
 
 ### 코드 복잡도 제한
 
@@ -524,7 +428,7 @@ Brand Assets, Commerce Patterns, Commit Push PR, Context7 Usage, Core Capabiliti
 
 ```bash
 # 셋업
-vibe setup                # 셋업 위자드 (인증, 채널, 설정 한번에)
+vibe setup                # 셋업 위자드 (인증, 채널, 설정)
 vibe init [project]       # 프로젝트 초기화
 vibe update               # 설정 업데이트
 vibe upgrade              # 최신 버전으로 업그레이드
@@ -534,16 +438,14 @@ vibe remove               # 제거
 # LLM 인증
 vibe gpt auth / key / status / logout
 vibe gemini auth / key / status / logout
-vibe claude status        # Claude Code 상태 확인
-
-# 인증 동기화
-vibe sync login / push / pull / status / logout
+vibe claude key / status / logout
 
 # 외부 채널
 vibe telegram setup / chat / status
 vibe slack setup / channel / status
 
-# 정보
+# 기타
+vibe env import [path]    # .env → config.json 마이그레이션
 vibe help                 # 도움말
 vibe version              # 버전
 ```
@@ -557,30 +459,32 @@ vibe version              # 버전
 
 ---
 
-## 인증 동기화 (vibe sync)
-
-작업 환경이 바뀔 때마다 인증을 반복하는 문제를 해결합니다.
-Google Drive AppData에 암호화된 인증 정보를 저장하고, 새 환경에서 한 줄로 복원합니다.
-
-```bash
-vibe sync login          # Google 계정 연결 (1회)
-vibe sync push           # 인증/메모리 업로드
-vibe sync pull           # 새 환경에서 복원
+## 설정
+
+### 전역: `~/.vibe/config.json`
+
+모든 인증, 채널, 모델 설정을 하나의 파일에 통합 관리합니다 (파일 권한 0o600).
+
+```json
+{
+  "credentials": {
+    "gpt": { "apiKey": "sk-...", "oauthRefreshToken": "..." },
+    "gemini": { "apiKey": "AIza...", "oauthRefreshToken": "..." }
+  },
+  "channels": {
+    "telegram": { "botToken": "123:ABC", "allowedChatIds": ["-100..."] },
+    "slack": { "botToken": "xoxb-...", "appToken": "xapp-...", "allowedChannelIds": ["C01..."] }
+  },
+  "models": {
+    "gpt": "gpt-5.2",
+    "gemini": "gemini-3-pro-preview"
+  }
+}
 ```
 
-### 동기화 대상
+### 프로젝트: `.claude/vibe/config.json`
 
-| 카테고리 | 내용 |
-|----------|------|
-| **인증** | GPT/Gemini 토큰 및 API 키 |
-| **메모리** | Session RAG DB, 저장된 메모리 |
-
-### 보안
-
-- AES-256-GCM 암호화 (Drive에 암호문만 저장)
-- Google Drive AppData 스코프만 사용 (사용자 Drive 파일 접근 불가)
-- PKCE + localhost 콜백 OAuth 플로우
-- 파일 권한 0o600
+프로젝트별 설정 (language, quality, stacks, details, references).
 
 ---
 
@@ -602,28 +506,32 @@ vibe sync pull           # 새 환경에서 복원
 your-project/
 ├── .claude/
 │   └── vibe/
-│       ├── config.json        # 모델 설정, 스택 감지 결과
+│       ├── config.json        # 프로젝트 설정 (모델, 스택)
 │       ├── constitution.md    # 프로젝트 원칙
 │       ├── specs/             # SPEC 문서
 │       ├── features/          # 기능 추적
 │       ├── todos/             # 이슈 추적 (P1/P2/P3)
-│       ├── reports/           # 리뷰 및 분석 리포트
-│       └── agents/
-│           └── registry.db    # 에이전트 실행 추적
+│       └── reports/           # 리뷰 리포트
 ├── CLAUDE.md                  # 프로젝트 가이드 (자동 생성)
 └── ...
 ```
 
 전역 설정:
 ```
-~/.config/vibe/                # LLM 인증 토큰/키
-~/.claude/vibe/
+~/.vibe/
+├── config.json                # 전역 설정 (인증, 채널, 모델)
+├── hooks/scripts/             # 훅 스크립트
+└── node_modules/@su-record/vibe/  # 패키지 복사본
+
+~/.claude/
+├── vibe/
 │   ├── rules/                 # 코딩 규칙
+│   ├── skills/                # 스킬 정의
+│   ├── ui-ux-data/            # UI/UX CSV 데이터
 │   ├── session-rag.db         # Session RAG (SQLite + FTS5)
 │   └── memories.json          # 저장된 메모리
-~/.claude/commands/            # 슬래시 명령어 (10개)
-~/.claude/agents/              # 에이전트 정의 (46개)
-~/.claude/skills/              # 스킬 정의 (34개)
+├── commands/                  # 슬래시 명령어 (10개)
+└── agents/                    # 에이전트 정의 (49개)
 ```
 
 ---
@@ -651,12 +559,11 @@ flowchart TD
     J1 --> K["교차 검증 → P1/P2/P3"]
     J2 --> K
 
-    L["Session RAG"] -.-> |"저장"| M["Decision/Constraint/Goal/Evidence"]
-    L -.-> |"검색"| N["BM25 × 0.4 + 최신성 × 0.3 + 우선순위 × 0.3"]
+    L["Session RAG"] -.-> M["Decision/Constraint/Goal/Evidence"]
+    L -.-> N["BM25 × 0.4 + 최신성 × 0.3 + 우선순위 × 0.3"]
 
     O["품질 게이트"] -.-> P["pre-tool-guard → 차단"]
     O -.-> Q["code-check → 검증"]
-    O -.-> R["post-edit → Git 동기화"]
 ```
 
 ---
@@ -668,18 +575,6 @@ flowchart TD
 - GPT, Gemini는 선택사항 (멀티 LLM 기능용)
 - sox는 선택사항 (`/vibe.voice` 음성 입력용)
 
-### 주요 의존성
-
-| 패키지 | 용도 |
-|--------|------|
-| `@anthropic-ai/claude-agent-sdk` | Claude Agent SDK |
-| `better-sqlite3` | Session RAG, AgentRegistry |
-| `ts-morph` | TypeScript AST 조작 |
-| `zod` | 스키마 검증 |
-| `playwright` | E2E 테스트, 브라우저 자동화 |
-| `chalk` | 터미널 색상 |
-| `glob` | 파일 패턴 매칭 |
-
 ## 라이선스
 
 MIT License - Copyright (c) 2025 Su

package/dist/cli/collaborator.js

@@ -96,7 +96,7 @@ echo "  /vibe.run \\"feature\\"     Implement"
     const coreSetupSection = `
 ## Core Setup (AI Coding)
 
-This project uses [Core](https://github.com/su-record/core) AI coding framework.
+This project uses [VIBE](https://github.com/su-record/vibe) AI coding framework.
 
 ### Collaborator Install
 

package/dist/cli/commands/info.js

@@ -42,7 +42,7 @@ Slash Commands (Claude Code):
   /vibe.utils             유틸리티 (--e2e, --diagram, --continue)
   /vibe.voice             음성 코딩 (Gemini + sox)
 
-Docs: https://github.com/su-record/core
+Docs: https://github.com/su-record/vibe
   `);
 }
 /**

package/dist/cli/setup/GlobalInstaller.d.ts

@@ -10,13 +10,6 @@ export declare const getCoreConfigDir: typeof getGlobalConfigDir;
  * 전역 core 패키지 설치
  */
 export declare function installGlobalCorePackage(isUpdate?: boolean): void;
-/**
- * npm 전역 prefix를 file:// URL로 변환 (크로스 플랫폼)
- * postinstall에서 저장한 캐시 파일 → npm prefix -g fallback
- * - Windows: file:///C:/Users/.../npm
- * - macOS/Linux: file:///usr/local (또는 nvm 경로)
- */
-export declare function getCorePathUrl(): string;
 /**
  * ~/.claude/ 전역 assets 설치 (commands, agents, skills)
  */

package/dist/cli/setup/GlobalInstaller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalInstaller.d.ts","sourceRoot":"","sources":["../../../src/cli/setup/GlobalInstaller.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAK/E;;GAEG;AACH,eAAO,MAAM,gBAAgB,2BAAqB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,UAAQ,GAAG,IAAI,CAmD/D;AA4BD;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAUvC;AAyBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,UAAQ,GAAG,IAAI,CA2B1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,UAAQ,GAAG,IAAI,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAsBjD"}
+{"version":3,"file":"GlobalInstaller.d.ts","sourceRoot":"","sources":["../../../src/cli/setup/GlobalInstaller.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAK/E;;GAEG;AACH,eAAO,MAAM,gBAAgB,2BAAqB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,UAAQ,GAAG,IAAI,CA+C/D;AAqDD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,UAAQ,GAAG,IAAI,CA2B1D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,UAAQ,GAAG,IAAI,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAsBjD"}