@su-record/vibe 2.16.4 → 3.1.0

package/skills/video-production/SKILL.md

@@ -3,7 +3,7 @@ name: video-production
 invocation: [auto]
 tier: standard
 description: "Video processing gotchas — FFmpeg commands, transcoding pipelines, HLS/DASH streaming setup, subtitle embedding (SRT/VTT), and thumbnail extraction. Use when the project involves any video manipulation, media processing, or streaming infrastructure. Covers codec selection, bitrate optimization, and common FFmpeg pitfalls. Must use this skill when user works with video files, mentions FFmpeg, or needs media processing — even for simple tasks like 'generate a thumbnail'."
-triggers: [video, ffmpeg, transcode, encode, stream, media, subtitle, thumbnail, hls, dash]
+triggers: [video, ffmpeg, transcode, subtitle, thumbnail, hls, video encoding, media processing]
 priority: 60
 ---
 

package/vibe/rules/orchestrator-contract.md

@@ -4,7 +4,7 @@
 > **구조·스키마·네이밍 규칙**의 유일한 정의다. 각 orchestrator.md 는 이 스키마를 따르되
 > **내용(phase·실패모드·에이전트)은 스킬별로 고유**하다 — 내용을 공유 파일로 병합하지 않는다.
 >
-> 대상: `skills/{techdebt,parallel-research,exec-plan,design-audit,create-prd}/orchestrator.md`
+> 대상: `skills/{techdebt,parallel-research,exec-plan,design-review,create-prd}/orchestrator.md`
 
 ## Frontmatter
 
@@ -48,9 +48,10 @@ skill-local 에이전트는 접두사를 붙인다:
 |-------|--------|-----|
 | techdebt | `techdebt` | `techdebt-scanner` |
 | exec-plan | `plan` | `plan-decomposer` |
-| design-audit | `design` | `design-a11y-auditor` |
+| design-review | `design` | `design-a11y-auditor` |
 | parallel-research | `research` | `research-best-practices` |
 | create-prd | `prd` | `prd-requirements-writer` |
 
-> WHY: `edge-case-finder`, `reviewer`, `researcher` 등은 전역 에이전트/리뷰어와 basename 이
-> 겹친다. 접두사가 없으면 조율 LLM 이 전역 에이전트와 skill-local 에이전트를 혼동한다.
+> WHY: `reviewer`, `scorer`, `a11y-auditor` 등은 전역 에이전트/리뷰어(code-reviewer,
+> design-reviewer 등)와 basename 이 겹치거나 혼동된다. 접두사가 없으면 조율 LLM 이
+> 전역 에이전트와 skill-local 에이전트를 혼동한다.

package/vibe/rules/quality/performance.md

@@ -233,4 +233,4 @@ function findDuplicates(arr: string[]): string[] {
 - [ ] 대량 데이터 처리 시 스트리밍/청크 처리 적용
 - [ ] 메모리 누수 점검 (이벤트 리스너 해제, 타이머 정리)
 
-> **vibe 도구 연계**: `core_analyze_complexity`로 함수 복잡도 측정, `/vibe.review`의 performance-reviewer 에이전트로 자동 성능 리뷰
+> **vibe 도구 연계**: `core_analyze_complexity`로 함수 복잡도 측정, `/vibe.review`의 code-reviewer(focus: performance) 에이전트로 자동 성능 리뷰

package/vibe/templates/claudemd-template.md

@@ -68,7 +68,7 @@ At 85%+ context: `save_memory` → `/new` → `/vibe.utils --continue` (raised f
 
 ## Git Commit Rules
 
-**Include:** `.vibe/plans/`, `.vibe/specs/`, `.vibe/features/`, `.vibe/config.json`, `CLAUDE.md`
+**Include:** `.vibe/specs/`, `.vibe/features/`, `.vibe/config.json`, `CLAUDE.md` (legacy `.vibe/plans/` 는 있으면 유지)
 **Exclude:** `~/.claude/vibe/rules/`, `~/.claude/commands/`, `~/.claude/agents/`, `~/.claude/skills/`, `.claude/settings.local.json`
 
 <!-- VIBE:END -->

package/vibe/templates/spec-template.md

@@ -1,221 +1,71 @@
 # SPEC: {Feature Name}
 
-## Metadata
-
 - **Created**: {YYYY-MM-DD}
-- **Author**: {Name}
-- **Status**: DRAFT
-- **Priority**: {HIGH | MEDIUM | LOW}
-- **Language**: {en | ko}
-- **Assigned Agent**: {Agent Name}
-- **Tech Stack**: {Project Tech Stack Summary}
+- **Status**: DRAFT | APPROVED
+- **Tech Stack**: {Project tech stack summary}
 
 ---
 
-## 1. Feature Overview
-
-{1-2 sentence summary}
-
-### Background
-
-{Why is this feature needed}
-
-### Goals
-
-- Goal 1
-- Goal 2
-
-### Non-Goals
-
-- What we won't do this time 1
-- What we won't do this time 2
+## 1. Overview / Goal
 
-### Tech Stack Context
+{What and why — 1-3 sentences.}
 
-**Existing Technology:**
+### Assumptions
 
-- Backend: {FastAPI, Django, Express, etc.}
-- Frontend: {React, Flutter, Vue, etc.}
-- Database: {PostgreSQL, MySQL, MongoDB, etc.}
-- Infrastructure: {GCP, AWS, Azure, etc.}
-
-**New Technology Required for This Feature:**
-
-- {New library/service 1} - {Reason}
-- {New library/service 2} - {Reason}
-
-**External API/Service Integration:**
-
-- {Service name} - {Purpose}
-
-**Constraints:**
-
-- Cost limit: {Amount}
-- Performance requirements: {Target response time, throughput, etc.}
+- {Default adopted without asking — e.g., session expiry 24h}
 
 ---
 
-## 2. User Stories
-
-### Story 1: {Story Title}
-
-**As a** {User role}
-**I want** {Desired functionality}
-**So that** {Reason/Value}
+## 2. Done Criteria (deterministic gates)
 
-#### Acceptance Criteria
+> Each criterion must be judgeable by a command or observable behavior — never by self-report.
+> These are the JUDGE inputs of the loop (`vibe/rules/loop-contract.md`); `/vibe.verify` records the result in `.vibe/metrics/run-ledger.json`.
 
-- [ ] {Verifiable condition 1}
-- [ ] {Verifiable condition 2}
+| # | Criterion | Verified by |
+|---|-----------|-------------|
+| D1 | {e.g., all scenarios in the feature file pass} | {e.g., `npx vitest run` exit 0} |
+| D2 | {e.g., build succeeds with no type errors} | {e.g., `npm run build` exit 0} |
 
 ---
 
-## 3. Requirements (EARS Format)
+## 3. Scenarios
 
-### REQ-001: {Requirement Title}
+> Mirrored to `.vibe/features/{feature}.feature` (gherkin). Every scenario maps to a Done criterion.
 
-**WHEN** {Specific condition}
-**THEN** {System behavior} (SHALL | SHOULD | MAY)
-
-#### Acceptance Criteria
-
-- [ ] {Testable criterion 1}
-- [ ] {Testable criterion 2}
-
-#### Example
-
-```text
-Input: {...}
-Output: {...}
+```gherkin
+Scenario: {Happy path title}          # → D1
+  Given {precondition}
+  When {action}
+  Then {expected result}
+
+Scenario: {Edge case title}           # → D1
+  Given {precondition}
+  When {action}
+  Then {expected result}
 ```
 
 ---
 
-## 4. Non-Functional Requirements
-
-### Performance
-
-- Response time: {Target}
-- Throughput: {Target}
-
-### Security
-
-- Authentication: {Method}
-- Authorization: {Rules}
-
-### Scalability
-
-- Expected growth rate: {Value}
-
----
-
-## 5. Data Model (Draft)
-
-### Entity: {Name}
+## 4. Out of Scope
 
-```json
-{
-  "field1": "type",
-  "field2": "type"
-}
-```
+- {Explicitly not doing this time — must not be empty}
 
 ---
 
-## 6. API Contract (Draft)
+## 5. API Contract (only if the feature exposes an API)
 
-### Endpoint: {Name}
+> Presence of this section enables `/vibe.contract` drift detection.
 
 ```text
-POST /api/v1/resource
+POST /api/v1/{resource}
 Request: {...}
-Response: {...}
-```
-
----
-
-## 7. Test Strategy
-
-### BDD Scenarios (Gherkin)
-
-**Generate Command**: `vibe feature "{feature name}"`
-
-```gherkin
-Scenario: {Scenario title}
-  Given {Precondition}
-  When {User action}
-  Then {Expected result}
-```
-
-**Mapping**:
-
-- REQ-001 → Scenario 1, 2
-- REQ-002 → Scenario 3
-
-### Contract Tests (API Schema)
-
-**Generate Command**: `vibe contract "{feature name}"`
-
-**Backend Contract**:
-
-```json
-{
-  "request": {
-    "method": "POST",
-    "path": "/api/v1/{resource}",
-    "schema": {JSON Schema}
-  },
-  "response": {
-    "status": 201,
-    "schema": {JSON Schema}
-  }
-}
+Response: 201 {...}
 ```
 
-**Frontend Contract**:
-
-- Independent testing with mock server
-- Response schema validation (Zod, JSON Schema)
-
-### Test Coverage Goals
-
-- [ ] BDD: Cover all Acceptance Criteria
-- [ ] Contract: Cover all API endpoints
-- [ ] Unit: 70%+ coverage
-- [ ] Integration: Cover critical paths
-
----
-
-## 8. Out of Scope
-
-- ❌ {Excluded item 1}
-- ❌ {Excluded item 2}
-
 ---
 
-## 9. Verification Checklist
-
-### Requirements
-
-- [ ] Are all requirements testable?
-- [ ] Is SHALL/SHOULD/MAY clear?
-- [ ] Are Acceptance Criteria specific?
-- [ ] Are performance goals measurable?
-
-### Testing
-
-- [ ] BDD Feature file generation complete?
-- [ ] Contract tests defined?
-- [ ] Step Definitions written?
-- [ ] Test coverage goal achieved?
-
----
-
-## 10. Approval
-
-- [ ] User approval
-- [ ] Technical review complete
-- [ ] Test plan approved
+## 6. Verification
 
-Approval Date: ____________
-Approver: ____________
+- `/vibe.run "{feature}"` implements scenario-by-scenario, verifying each immediately.
+- `/vibe.verify "{feature}"` judges the Done Criteria and sets `verifyPassed` in the run-ledger.
+- Gate = all Done Criteria pass (exit codes / observed behavior) — loop continues until gates pass, stuck, or max iterations.

package/agents/architect-low.md

@@ -1,41 +0,0 @@
-# Architect Agent - Low Tier (Haiku)
-
-Quick architecture queries and pattern matching.
-
-## Role
-
-- Architecture pattern lookup
-- Quick structure analysis
-- Simple design questions
-
-## Model
-
-**Haiku** — Fast pattern matching
-
-## When to Use
-
-- "What pattern does this use?"
-- "Where is X defined?"
-- Simple structural questions
-
-## Usage
-
-```
-Task(model: "haiku", subagent_type: "general-purpose", prompt: "What architecture pattern does this service use?")
-```
-
-## Process
-
-1. Quick codebase scan
-2. Pattern identification
-3. Return finding
-
-## Output
-
-```markdown
-## Architecture Query Result
-
-Pattern: Repository Pattern
-Location: src/repositories/
-Evidence: UserRepository, ProductRepository classes
-```

package/agents/architect-medium.md

@@ -1,59 +0,0 @@
-# Architect Agent - Medium Tier (Sonnet)
-
-Module-level architecture and design.
-
-## Role
-
-- Module architecture
-- Component design
-- API design
-- Local optimization
-
-## Model
-
-**Sonnet** — Balanced for module-level decisions
-
-## When to Use
-
-- Single module design
-- API endpoint design
-- Component hierarchy
-- Local refactoring decisions
-
-## Usage
-
-```
-Task(model: "sonnet", subagent_type: "general-purpose", prompt: "Design the user service module")
-```
-
-## Process
-
-1. Understand module requirements
-2. Review existing patterns
-3. Design component structure
-4. Define interfaces
-5. Document decision
-
-## Output
-
-```markdown
-## Module Design
-
-### Structure
-```
-src/user/
-├── index.ts (exports)
-├── service.ts (business logic)
-├── repository.ts (data access)
-├── types.ts (type definitions)
-└── __tests__/
-```
-
-### Interfaces
-- UserService: create, read, update, delete
-- UserRepository: find, save, remove
-
-### Dependencies
-- Depends on: auth, database
-- Used by: profile, settings
-```

package/agents/compounder.md

@@ -1,265 +0,0 @@
----
-description: Auto-document solutions for knowledge compounding
-argument-hint: "solution description (optional)"
----
-
-# /vibe.compound
-
-**Knowledge Compounding** - Auto-document solved problems to boost future productivity
-
-> "Each solution documented makes future problems easier to solve."
-
-## Model
-
-**Sonnet** — Balanced reasoning and quality
-
-## Usage
-
-```
-/vibe.compound                           # Auto-detect recent solutions
-/vibe.compound "Redis cache invalidation" # Document specific solution
-```
-
-## Auto-Triggers
-
-Automatically suggested when these patterns detected:
-- "it's fixed", "fixed", "solved", "resolved"
-- After PR merge
-- After `/vibe.verify` passes
-
-## Process
-
-### Phase 1: Solution Extraction
-
-Parallel agents analyze the solution:
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  🔍 PARALLEL SOLUTION ANALYSIS                                   │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│  Task 1: problem-analyzer                                       │
-│  ├── Identify original problem                                  │
-│  ├── Symptoms and error messages                                │
-│  └── Impact scope                                               │
-│                                                                 │
-│  Task 2: solution-extractor                                     │
-│  ├── Applied fixes                                              │
-│  ├── Key code changes                                           │
-│  └── Configuration changes                                      │
-│                                                                 │
-│  Task 3: root-cause-analyzer                                    │
-│  ├── Root cause identification                                  │
-│  ├── Why it happened                                            │
-│  └── Prevention methods                                         │
-│                                                                 │
-│  Task 4: pattern-recognizer                                     │
-│  ├── Similar problem patterns                                   │
-│  ├── Related tech stack                                         │
-│  └── Search keywords                                            │
-│                                                                 │
-│  Task 5: category-classifier                                    │
-│  ├── Category classification                                    │
-│  ├── Tag generation                                             │
-│  └── Related doc links                                          │
-│                                                                 │
-│  Task 6: code-snippet-extractor                                 │
-│  ├── Before/After code                                          │
-│  ├── Key change highlights                                      │
-│  └── Copy-paste snippets                                        │
-│                                                                 │
-│  Task 7: prevention-advisor                                     │
-│  ├── Prevention checklist                                       │
-│  ├── Suggested linter rules                                     │
-│  └── Test case suggestions                                      │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-### Phase 2: Category Classification
-
-```
-.vibe/solutions/
-├── security/           # Security related
-│   ├── sql-injection-prevention.md
-│   └── xss-sanitization.md
-├── performance/        # Performance optimization
-│   ├── n1-query-fix.md
-│   └── redis-cache-invalidation.md
-├── database/           # Database related
-│   ├── migration-rollback.md
-│   └── deadlock-resolution.md
-├── integration/        # External integrations
-│   ├── stripe-webhook-retry.md
-│   └── aws-s3-timeout.md
-├── frontend/           # Frontend issues
-│   ├── react-hydration-mismatch.md
-│   └── infinite-scroll-memory.md
-├── testing/            # Testing related
-│   ├── flaky-test-fix.md
-│   └── mock-timezone.md
-└── deployment/         # Deployment issues
-    ├── docker-layer-cache.md
-    └── k8s-rolling-update.md
-```
-
-### Phase 3: Document Generation
-
-```markdown
-# [Solution] Redis Cache Invalidation
-
-## TL;DR
-Added version suffix to Redis cache key to fix invalidation issue
-
-## Problem
-### Symptoms
-- User profile shows stale data after update
-- Refresh doesn't fix the issue
-
-### Error/Logs
-```
-Cache hit: user:123 (stale data)
-```
-
-### Impact Scope
-- User profile page
-- API: GET /api/users/:id
-
-## Root Cause
-Cache key only used user_id, not invalidated on update
-
-```python
-# Before
-cache_key = f"user:{user_id}"  # No version
-```
-
-## Solution
-### Key Change
-Add updated_at timestamp to cache key
-
-```python
-# After
-cache_key = f"user:{user_id}:v{updated_at.timestamp()}"
-```
-
-### Changed Files
-- src/services/cache.py:42
-- src/api/users.py:78
-
-## Prevention
-- [ ] Always include version/timestamp in cache keys
-- [ ] Add cache invalidation tests
-- [ ] Linter rule: cache_key pattern check
-
-## Related
-- Similar issue: #234 (Session cache)
-- Docs: docs/caching-strategy.md
-- Tags: #redis #cache #invalidation
-
-## Metadata
-- Resolved: 2026-01-11
-- Time spent: 2 hours
-- Difficulty: Medium
-- Reusability: High
-```
-
-### Phase 4: Index Update
-
-Auto-update `.vibe/solutions/index.md`:
-
-```markdown
-# Solution Index
-
-## Recently Added
-| Date | Category | Title | Tags |
-|------|----------|-------|------|
-| 2026-01-11 | performance | Redis cache invalidation | #redis #cache |
-| 2026-01-10 | security | SQL Injection prevention | #sql #security |
-
-## By Category
-- **Security** (5 solutions)
-- **Performance** (8 solutions)
-- **Database** (4 solutions)
-...
-
-## Search Keywords
-- redis → performance/redis-cache-invalidation.md
-- n+1 → performance/n1-query-fix.md
-- sql injection → security/sql-injection-prevention.md
-```
-
-## Auto-Suggestion
-
-When similar problem detected:
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  💡 Similar Solution Found!                                      │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│  You're working on: "Cache not updating"                        │
-│                                                                 │
-│  Related solution (85% match):                                  │
-│  📄 .vibe/solutions/performance/redis-cache-invalidation.md     │
-│                                                                 │
-│  Key insight: Add version suffix to cache key                   │
-│                                                                 │
-│  Apply this solution? [Y/n]                                     │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-## Output
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  📚 SOLUTION DOCUMENTED                                          │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│  ✅ Created: .vibe/solutions/performance/redis-cache-invalid... │
-│                                                                 │
-│  📊 Knowledge Base Stats:                                        │
-│  ├── Total Solutions: 42                                        │
-│  ├── This Month: 8                                              │
-│  └── Most Used Category: performance                            │
-│                                                                 │
-│  🔗 Similar solutions linked: 2                                  │
-│  🏷️ Tags: #redis #cache #invalidation #performance              │
-│                                                                 │
-│  💡 Prevention rules added to ~/.claude/vibe/rules/                     │
-│                                                                 │
-│  "This solution will help future you (or teammates) save hours" │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-## Integration with Memory
-
-Auto-invoke `core_save_memory`:
-
-```json
-{
-  "type": "solution",
-  "category": "performance",
-  "title": "Redis cache invalidation",
-  "keywords": ["redis", "cache", "invalidation"],
-  "file": ".vibe/solutions/performance/redis-cache-invalidation.md"
-}
-```
-
-## Workflow Integration
-
-```
-/vibe.spec → /vibe.run → /vibe.verify → /vibe.compound
-                                              │
-                                              ▼
-                                    .vibe/solutions/
-                                              │
-                                              ▼
-                                    Future problem?
-                                    Auto-suggest!
-```
-
----
-
-ARGUMENTS: $ARGUMENTS