@su-record/vibe 2.0.10 → 2.0.11

package/.claude/skills/priority-todos.md

@@ -0,0 +1,236 @@
+# Priority-Based Todo Management Skill
+
+우선순위 기반 TODO 관리 시스템
+
+## Overview
+
+P1/P2/P3 우선순위로 태스크를 분류하여 중요한 것 먼저 처리
+
+## Priority Levels
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  Priority Levels                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  🔴 P1 (Critical)                                               │
+│  ├── 보안 취약점                                                 │
+│  ├── 데이터 손실 위험                                            │
+│  ├── 프로덕션 장애                                               │
+│  └── 머지 차단 이슈                                              │
+│                                                                 │
+│  🟡 P2 (Important)                                              │
+│  ├── 성능 문제                                                   │
+│  ├── 테스트 누락                                                 │
+│  ├── 아키텍처 위반                                               │
+│  └── 기술 부채                                                   │
+│                                                                 │
+│  🔵 P3 (Nice-to-have)                                           │
+│  ├── 코드 스타일                                                 │
+│  ├── 리팩토링 제안                                               │
+│  ├── 문서화                                                      │
+│  └── 최적화 기회                                                 │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## File-Based Todo System
+
+### Directory Structure
+
+```
+.vibe/todos/
+├── P1-security-sql-injection.md
+├── P1-data-transaction-missing.md
+├── P2-perf-n1-query.md
+├── P2-test-missing-edge-case.md
+├── P2-arch-circular-dependency.md
+├── P3-style-extract-helper.md
+├── P3-docs-add-readme.md
+└── index.md
+```
+
+### Todo File Format
+
+```markdown
+# [P1] SQL Injection Vulnerability
+
+## Summary
+User input directly concatenated in SQL query without sanitization.
+
+## Priority Justification
+- 🔴 P1 (Critical)
+- Category: Security
+- Impact: High (data breach risk)
+- Effort: Low (simple fix)
+
+## Location
+- **File**: src/api/users.py
+- **Line**: 42-45
+- **Function**: `get_user_by_email()`
+
+## Current Code
+```python
+def get_user_by_email(email: str):
+    query = f"SELECT * FROM users WHERE email = '{email}'"
+    return db.execute(query)
+```
+
+## Suggested Fix
+```python
+def get_user_by_email(email: str):
+    query = "SELECT * FROM users WHERE email = %s"
+    return db.execute(query, (email,))
+```
+
+## Checklist
+- [ ] Fix implemented
+- [ ] Unit test added
+- [ ] Security test added
+- [ ] Code reviewed
+- [ ] Merged
+
+## References
+- OWASP SQL Injection: https://owasp.org/www-community/attacks/SQL_Injection
+- Project Security Guide: docs/security.md
+
+## Metadata
+- Created: 2026-01-11
+- Author: Claude
+- Review: /vibe.review PR#123
+```
+
+### Index File
+
+```markdown
+# Todo Index
+
+## Summary
+| Priority | Count | Status |
+|----------|-------|--------|
+| 🔴 P1 | 2 | 🚨 Blocks merge |
+| 🟡 P2 | 5 | ⚠️ Should fix |
+| 🔵 P3 | 3 | 💡 Backlog |
+
+## 🔴 P1 Critical (Blocks Merge)
+
+| # | Title | Location | Status |
+|---|-------|----------|--------|
+| 1 | SQL Injection | users.py:42 | ❌ Open |
+| 2 | Missing Rollback | payment.py:128 | ❌ Open |
+
+## 🟡 P2 Important
+
+| # | Title | Location | Status |
+|---|-------|----------|--------|
+| 3 | N+1 Query | orders.py:78 | ❌ Open |
+| 4 | Missing Tests | auth.py | ❌ Open |
+| 5 | Circular Dep | services/ | ❌ Open |
+
+## 🔵 P3 Nice-to-have
+
+| # | Title | Location | Status |
+|---|-------|----------|--------|
+| 6 | Extract Helper | utils.py:45 | 💤 Backlog |
+| 7 | Add README | /payment | 💤 Backlog |
+
+---
+
+Last updated: 2026-01-11 10:30
+```
+
+## Workflow Commands
+
+### Create Todo
+
+```bash
+# /vibe.review 결과에서 자동 생성
+/vibe.review PR#123
+# → .vibe/todos/ 에 파일 생성
+
+# 수동 생성
+vibe todo add "SQL Injection in users.py" --priority P1 --category security
+```
+
+### List Todos
+
+```bash
+# 전체 목록
+vibe todo list
+
+# 우선순위별
+vibe todo list --priority P1
+vibe todo list --priority P2
+
+# 카테고리별
+vibe todo list --category security
+vibe todo list --category performance
+```
+
+### Complete Todo
+
+```bash
+# 완료 처리
+vibe todo done P1-security-sql-injection
+
+# 파일에 체크 표시 + index 업데이트
+```
+
+### Clean Up
+
+```bash
+# 완료된 항목 아카이브
+vibe todo archive
+
+# 결과:
+# .vibe/todos/P1-security-sql-injection.md
+# → .vibe/todos/done/2026-01-11-P1-security-sql-injection.md
+```
+
+## Integration with TodoWrite
+
+기존 TodoWrite 도구와 연동:
+
+```javascript
+TodoWrite({
+  todos: [
+    {
+      content: "[P1] Fix SQL injection in users.py:42",
+      status: "in_progress",
+      activeForm: "Fixing SQL injection vulnerability",
+      priority: "P1",  // 확장 필드
+      category: "security"  // 확장 필드
+    },
+    {
+      content: "[P2] Add missing tests for auth",
+      status: "pending",
+      activeForm: "Adding auth tests",
+      priority: "P2",
+      category: "testing"
+    }
+  ]
+})
+```
+
+## Auto-Blocking Rules
+
+```yaml
+# .vibe/config.yaml
+merge_blocking:
+  P1: true   # P1 있으면 머지 차단
+  P2: false  # P2는 경고만
+  P3: false  # P3는 무시
+
+notifications:
+  P1: immediate  # 즉시 알림
+  P2: daily      # 일일 요약
+  P3: weekly     # 주간 요약
+```
+
+## Best Practices
+
+1. **P1은 즉시 처리**: 다른 작업 중단하고 수정
+2. **P2는 PR 전 처리**: 머지 전 해결 권장
+3. **P3는 백로그**: 시간 날 때 처리
+4. **정기 정리**: 주 1회 todo 리뷰
+5. **완료 기록**: 해결 방법 문서화

package/CLAUDE.md

@@ -33,7 +33,7 @@ SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
 ## Workflow
 
 ```
-/vibe.spec → /vibe.run → /vibe.verify
+/vibe.spec → /vibe.run → /vibe.verify → /vibe.compound
 ```
 
 ## ULTRAWORK Mode (권장)
@@ -56,16 +56,83 @@ SPEC 주도 AI 코딩 프레임워크 (Claude Code 전용)
 
 | 명령어 | 설명 |
 |--------|------|
-| `/vibe.spec "기능명"` | SPEC 작성 (PTCF 구조) |
+| `/vibe.spec "기능명"` | SPEC 작성 (PTCF 구조) + 병렬 리서치 |
 | `/vibe.run "기능명"` | 구현 실행 |
 | `/vibe.run "기능명" ultrawork` | **최대 성능 모드** |
 | `/vibe.verify "기능명"` | 검증 |
+| `/vibe.review` | **병렬 코드 리뷰** (13+ 에이전트) |
+| `/vibe.compound` | **지식 문서화** (해결책 아카이브) |
+| `/vibe.e2e` | **E2E 테스트** (Playwright) |
 | `/vibe.reason "문제"` | 체계적 추론 |
 | `/vibe.analyze` | 프로젝트 분석 |
 | `/vibe.diagram` | 다이어그램 생성 |
 | `/vibe.ui "설명"` | UI 미리보기 |
 | `/vibe.continue` | **세션 복원** (이전 컨텍스트 로드) |
 
+## 새로운 기능 (v2.1.0)
+
+### 병렬 코드 리뷰 (/vibe.review)
+
+13+ 전문 에이전트가 동시에 코드 리뷰:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  🚀 PARALLEL REVIEW AGENTS                                       │
+├─────────────────────────────────────────────────────────────────┤
+│  Security          │ security-reviewer, data-integrity-reviewer │
+│  Performance       │ performance-reviewer, complexity-reviewer  │
+│  Architecture      │ architecture-reviewer, simplicity-reviewer │
+│  Language-Specific │ python, typescript, rails, react reviewers │
+│  Context           │ git-history, test-coverage reviewers       │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+**우선순위 시스템:**
+- 🔴 P1 (Critical): 머지 차단
+- 🟡 P2 (Important): 수정 권장
+- 🔵 P3 (Nice-to-have): 백로그
+
+### 지식 복리 (/vibe.compound)
+
+해결한 문제를 자동 문서화:
+
+```
+.vibe/solutions/
+├── security/           # 보안 해결책
+├── performance/        # 성능 최적화
+├── database/           # DB 관련
+└── integration/        # 외부 연동
+```
+
+트리거: "it's fixed", "해결됨", PR 머지 후
+
+### E2E 테스트 (/vibe.e2e)
+
+Playwright 기반 자동화 테스트:
+
+```bash
+/vibe.e2e "login flow"        # 시나리오 테스트
+/vibe.e2e --visual            # 시각적 회귀 테스트
+/vibe.e2e --record            # 비디오 녹화
+```
+
+### 리서치 에이전트 강화
+
+`/vibe.spec` 실행 시 **요구사항 확정 후** 4개 병렬 리서치:
+
+```
+문답으로 요구사항 확정 → 병렬 리서치 실행 → SPEC 작성
+```
+
+| 에이전트 | 역할 |
+|----------|------|
+| best-practices-agent | 확정된 기능+스택 베스트 프랙티스 |
+| framework-docs-agent | 확정된 스택 최신 문서 (context7) |
+| codebase-patterns-agent | 기존 유사 패턴 분석 |
+| security-advisory-agent | 확정된 기능 보안 권고 |
+
+**⚠️ 리서치는 요구사항 확정 후 실행** (VIBE 원칙: 요구사항 먼저)
+
 ## PTCF Structure
 
 SPEC 문서는 AI가 바로 실행 가능한 프롬프트 형태:
@@ -96,6 +163,52 @@ SPEC 문서는 AI가 바로 실행 가능한 프롬프트 형태:
 | `vibe_auto_save_context` | 현재 상태 저장 |
 | `vibe_save_memory` | 중요 결정사항 저장 |
 
+## 에이전트
+
+### Review 에이전트 (12개)
+```
+.claude/agents/review/
+├── security-reviewer.md        # 보안 취약점
+├── performance-reviewer.md     # 성능 병목
+├── architecture-reviewer.md    # 아키텍처 위반
+├── complexity-reviewer.md      # 복잡도 초과
+├── simplicity-reviewer.md      # 과도한 추상화
+├── data-integrity-reviewer.md  # 데이터 무결성
+├── test-coverage-reviewer.md   # 테스트 누락
+├── git-history-reviewer.md     # 위험 패턴
+├── python-reviewer.md          # Python 전문
+├── typescript-reviewer.md      # TypeScript 전문
+├── rails-reviewer.md           # Rails 전문
+└── react-reviewer.md           # React 전문
+```
+
+### Research 에이전트 (4개)
+```
+.claude/agents/research/
+├── best-practices-agent.md     # 베스트 프랙티스
+├── framework-docs-agent.md     # 프레임워크 문서
+├── codebase-patterns-agent.md  # 코드 패턴 분석
+└── security-advisory-agent.md  # 보안 권고
+```
+
+## 스킬
+
+### Git Worktree
+```bash
+# PR 리뷰용 격리 환경
+git worktree add ../review-123 origin/pr/123
+cd ../review-123 && npm test
+git worktree remove ../review-123
+```
+
+### Priority Todos
+```
+.vibe/todos/
+├── P1-security-sql-injection.md   # 🔴 머지 차단
+├── P2-perf-n1-query.md            # 🟡 수정 권장
+└── P3-style-extract-helper.md     # 🔵 백로그
+```
+
 ## 컨텍스트 관리 전략
 
 ### 모델 선택
@@ -151,8 +264,8 @@ vibe는 자체 메모리 시스템으로 세션 간 컨텍스트를 유지합니
 ## Git Commit 규칙
 
 **반드시 포함:**
-- `.claude/` 폴더 전체 (commands, agents, settings.json)
-- `.vibe/rules/`, `.vibe/specs/`, `.vibe/features/`
+- `.claude/` 폴더 전체 (commands, agents, skills, settings.json)
+- `.vibe/rules/`, `.vibe/specs/`, `.vibe/features/`, `.vibe/solutions/`, `.vibe/todos/`
 - `CLAUDE.md`
 
 **제외:**
@@ -165,3 +278,36 @@ vibe는 자체 메모리 시스템으로 세션 간 컨텍스트를 유지합니
 vibe init
 /vibe.spec "로그인 기능"
 ```
+
+## 전체 워크플로우
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  VIBE Complete Workflow                                          │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. /vibe.spec "기능명"                                         │
+│     ├── 문답으로 요구사항 수집                                   │
+│     ├── 요구사항 확정 후 4개 병렬 리서치                         │
+│     └── SPEC 문서 생성                                          │
+│                                                                 │
+│  2. /vibe.run "기능명" ultrawork                                │
+│     ├── 구현                                                    │
+│     ├── 테스트                                                  │
+│     └── 자동 진행                                               │
+│                                                                 │
+│  3. /vibe.verify "기능명"                                       │
+│     └── BDD 시나리오 검증                                       │
+│                                                                 │
+│  4. /vibe.review                                                │
+│     ├── 13+ 병렬 리뷰 에이전트                                  │
+│     └── P1/P2/P3 우선순위 분류                                  │
+│                                                                 │
+│  5. /vibe.e2e                                                   │
+│     └── Playwright E2E 테스트                                   │
+│                                                                 │
+│  6. /vibe.compound                                              │
+│     └── 해결책 문서화 → .vibe/solutions/                        │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```

package/README.md

@@ -24,6 +24,13 @@ SPEC 문서 하나로 AI가 바로 구현하고, **시나리오별 자동 검증
 - **자동 컨텍스트 관리**: 80%+ 시 자동 저장, 세션 자동 복원
 - **36개 내장 도구**: 코드 분석, 품질 검증, 세션 메모리 (MCP 오버헤드 제거)
 
+### v2.1.0 신규 기능
+
+- **🔍 병렬 코드 리뷰**: 13+ 전문 에이전트가 동시 리뷰 (P1/P2/P3 우선순위)
+- **🎭 E2E 테스트**: Playwright 기반 브라우저 자동화 (시각적 회귀, 비디오 녹화)
+- **📚 지식 복리**: 해결책 자동 문서화 → `.vibe/solutions/`
+- **🔬 병렬 리서치**: 요구사항 확정 후 4개 에이전트 동시 조사
+
 ---
 
 ## Installation
@@ -65,17 +72,24 @@ cd my-project
 ┌─────────────────────────────────────────────────────┐
 │  /vibe.spec "기능명"                                │
 │  ↓ 대화형 요구사항 수집                              │
-│  ↓ .vibe/specs/{기능명}.md (PTCF 구조)              │
-│  ↓ .vibe/features/{기능명}.feature (BDD 시나리오)   │
+│  ↓ 요구사항 확정 후 4개 병렬 리서치 (v2.1.0)        │
+│  ↓ .vibe/specs/{기능명}.md + .feature              │
 ├─────────────────────────────────────────────────────┤
 │  /vibe.run "기능명" ultrawork                       │
 │  ↓ 시나리오별 구현 + 즉시 검증 (SDD)                │
-│  ↓ Scenario 1 → 구현 → ✅ → Scenario 2 → ...       │
-│  ↓ 실패 시 자동 재시도 (최대 3회)                   │
+│  ↓ Scenario 1 → ✅ → Scenario 2 → ...             │
 ├─────────────────────────────────────────────────────┤
 │  /vibe.verify "기능명"                              │
 │  ↓ Given/When/Then 단계별 검증                     │
-│  ↓ 품질 리포트 자동 생성                            │
+├─────────────────────────────────────────────────────┤
+│  /vibe.review                    ← NEW (v2.1.0)    │
+│  ↓ 13+ 병렬 리뷰 에이전트 (P1/P2/P3)               │
+├─────────────────────────────────────────────────────┤
+│  /vibe.e2e                       ← NEW (v2.1.0)    │
+│  ↓ Playwright E2E 테스트                           │
+├─────────────────────────────────────────────────────┤
+│  /vibe.compound                  ← NEW (v2.1.0)    │
+│  ↓ 해결책 문서화 → .vibe/solutions/                │
 └─────────────────────────────────────────────────────┘
 ```
 
@@ -129,12 +143,16 @@ Feature 로드 → Scenario 1 [구현→검증] → Scenario 2 [구현→검증]
 
 | 명령어 | 설명 |
 |--------|------|
-| `/vibe.spec "기능명"` | SPEC 작성 (PTCF 구조) |
+| `/vibe.spec "기능명"` | SPEC 작성 (PTCF 구조) + 병렬 리서치 |
 | `/vibe.run "기능명"` | 구현 실행 |
 | `/vibe.run "기능명" ultrawork` | 🚀 **최대 성능 모드** (권장) |
 | `/vibe.run "기능명" ulw` | ultrawork 단축어 |
 | `/vibe.run "기능명" --phase N` | 특정 Phase만 실행 |
 | `/vibe.verify "기능명"` | 검증 |
+| `/vibe.review` | 🆕 **병렬 코드 리뷰** (13+ 에이전트) |
+| `/vibe.e2e` | 🆕 **E2E 테스트** (Playwright) |
+| `/vibe.compound` | 🆕 **지식 문서화** (해결책 아카이브) |
+| `/vibe.continue` | 🆕 **세션 복원** (이전 컨텍스트 로드) |
 
 #### 분석 & 도구
 
@@ -243,6 +261,101 @@ When: "비밀번호 찾기" 클릭
 
 ---
 
+## New in v2.1.0
+
+### 병렬 코드 리뷰 (/vibe.review)
+
+13+ 전문 에이전트가 동시에 코드 리뷰:
+
+```
+┌─────────────────────────────────────────────────────┐
+│  🚀 PARALLEL REVIEW AGENTS                          │
+├─────────────────────────────────────────────────────┤
+│  Security      │ OWASP Top 10, SQL injection, XSS  │
+│  Performance   │ N+1 queries, memory leaks         │
+│  Architecture  │ SOLID violations, layer breaches  │
+│  Language      │ Python, TypeScript, Rails, React  │
+│  Quality       │ Complexity, test coverage, git    │
+└─────────────────────────────────────────────────────┘
+```
+
+**우선순위 시스템:**
+- 🔴 **P1 (Critical)**: 머지 차단 - 보안 취약점, 데이터 손실
+- 🟡 **P2 (Important)**: 수정 권장 - 성능 문제, 테스트 누락
+- 🔵 **P3 (Nice-to-have)**: 백로그 - 코드 스타일, 리팩토링
+
+### E2E 테스트 (/vibe.e2e)
+
+Playwright 기반 브라우저 자동화 테스트:
+
+```bash
+/vibe.e2e "login flow"        # 시나리오 테스트
+/vibe.e2e --visual            # 시각적 회귀 테스트
+/vibe.e2e --record            # 비디오 녹화
+```
+
+**기능:**
+- 스크린샷 캡처 및 비교
+- 콘솔 에러 자동 수집
+- 접근성(a11y) 검사
+- 버그 재현 자동화
+
+### 지식 복리 (/vibe.compound)
+
+해결한 문제를 자동 문서화하여 지식 축적:
+
+```
+.vibe/solutions/
+├── security/           # 보안 해결책
+├── performance/        # 성능 최적화
+├── database/           # DB 관련
+└── integration/        # 외부 연동
+```
+
+**트리거**: "버그 해결됨", "bug fixed", "PR merged" 등
+
+### 리서치 에이전트 강화
+
+`/vibe.spec` 실행 시 **요구사항 확정 후** 4개 병렬 리서치:
+
+```
+문답으로 요구사항 확정 → 병렬 리서치 → SPEC 작성
+```
+
+| 에이전트 | 역할 | 외부 LLM 강화 |
+|----------|------|--------------|
+| best-practices-agent | 확정된 기능+스택 베스트 프랙티스 | - |
+| framework-docs-agent | 확정된 스택 최신 문서 (context7) | Gemini (웹 검색) |
+| codebase-patterns-agent | 기존 유사 패턴 분석 | - |
+| security-advisory-agent | 확정된 기능 보안 권고 | GPT (CVE 지식) |
+
+> ⚠️ **리서치는 요구사항 확정 후 실행** (VIBE 원칙: 요구사항 먼저)
+
+### 외부 LLM 통합 (선택적)
+
+GPT/Gemini가 활성화되어 있으면 특정 에이전트가 자동으로 활용합니다:
+
+| 에이전트 | 외부 LLM | 용도 |
+|----------|----------|------|
+| framework-docs-agent | Gemini | context7 문서 부재 시 웹 검색으로 최신 문서 보강 |
+| security-advisory-agent | GPT | CVE/보안 취약점 DB 지식 보강 |
+| python-reviewer | GPT Codex | Python 코드 리뷰 2nd opinion |
+
+**동작 방식:**
+```
+Primary: Task(Haiku) 실행
+      ↓
+[외부 LLM 활성화?]
+      ↓ YES
+외부 LLM 호출 → 결과 병합
+      ↓ NO
+Primary 결과만 사용
+```
+
+> **후방 호환성**: GPT/Gemini가 설정되지 않아도 Primary(Haiku)만으로 정상 작동합니다.
+
+---
+
 ## Project Structure
 
 `vibe init` 실행 후 생성되는 구조:
@@ -251,16 +364,21 @@ When: "비밀번호 찾기" 클릭
 project/
 ├── CLAUDE.md                 # 프로젝트 컨텍스트        ← git 공유
 ├── .claude/                  # ⚠️ 반드시 git에 커밋    ← git 공유
-│   ├── commands/             # 슬래시 커맨드 (7개)
+│   ├── commands/             # 슬래시 커맨드 (12개)
 │   ├── agents/               # 서브에이전트
+│   │   ├── review/           # 리뷰 에이전트 (12개)   ← NEW
+│   │   └── research/         # 리서치 에이전트 (4개)  ← NEW
+│   ├── skills/               # 스킬 (2개)             ← NEW
 │   ├── settings.json         # Hooks 설정
 │   └── settings.local.json   # 개인 설정               ← git 제외 (자동)
 └── .vibe/
     ├── config.json           # 프로젝트 설정           ← git 공유
     ├── constitution.md       # 프로젝트 원칙           ← git 공유
-    ├── rules/                 # 코딩 규칙              ← git 공유
-    ├── specs/                 # SPEC 문서들            ← git 공유
-    └── features/              # BDD Feature 파일들     ← git 공유
+    ├── rules/                # 코딩 규칙               ← git 공유
+    ├── specs/                # SPEC 문서들             ← git 공유
+    ├── features/             # BDD Feature 파일들      ← git 공유
+    ├── solutions/            # 해결책 아카이브         ← NEW
+    └── todos/                # 우선순위 TODO           ← NEW
 ```
 
 > **⚠️ 중요**: `.claude/` 폴더는 팀과 공유해야 합니다. 커밋 시 제외하지 마세요.

package/package.json

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