@su-record/vibe 3.2.64 → 4.0.0

package/skills/vibe.video-production/SKILL.md

@@ -1,72 +0,0 @@
----
-name: vibe.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, subtitle, thumbnail, hls, video encoding, media processing]
-priority: 60
----
-
-# Video Production
-
-## Pre-check (K1)
-
-> Are you processing video files programmatically? If just embedding a YouTube/Vimeo player, this skill is not needed.
-
-## Prerequisite — FFmpeg
-
-이 스킬의 모든 명령은 FFmpeg 에 의존한다. **작업 전에 존재를 먼저 확인한다:**
-
-```bash
-ffmpeg -version && ffprobe -version
-```
-
-없으면 설치를 안내하고 멈춘다 — 뒤로 갈수록 실패가 비싸진다.
-
-| 환경 | 설치 |
-|---|---|
-| macOS | `brew install ffmpeg` |
-| Debian/Ubuntu | `sudo apt install ffmpeg` |
-| 그 외 | https://ffmpeg.org/download.html |
-
-> 코덱까지 갖춰졌는지는 별개다 — 아래 Gotchas 의 "Assuming codec availability" 참조.
-> 빌드마다 포함 코덱이 다르므로 인코딩 전에 `ffmpeg -codecs` 로 확인한다.
-
-## Gotchas
-
-| Gotcha | Consequence | Prevention |
-|--------|-------------|------------|
-| Direct CLI string concatenation | Command injection risk | Always use wrapper library (fluent-ffmpeg for TS, ffmpeg-python for Python) |
-| No input validation | Crash on corrupted files | Always `ffprobe` input before processing — check codec, resolution, duration |
-| No temp file cleanup | Disk fills up silently | `try/finally` or cleanup handler — never leave partial outputs |
-| No progress callback | Long encoding appears frozen | Implement progress events for any operation >10s |
-| Memory loading large files | OOM on 4K+ video | Use streaming I/O, never read entire file into memory |
-| Assuming codec availability | Fails on different FFmpeg builds | Check `ffmpeg -codecs` at runtime before encoding |
-| Fixed bitrate encoding | Inconsistent quality | Use CRF-based quality (18-28 for H.264) instead |
-| No timeout | Encoding hangs forever | Set timeout + kill process on expiry |
-
-## Codec Quick Reference
-
-| Use Case | Codec | Note |
-|----------|-------|------|
-| Maximum compatibility | H.264 (libx264) | CRF 23 default |
-| Smaller files | H.265 (libx265) | 50% smaller, slower, licensing issues |
-| Open source | VP9 (libvpx-vp9) | Good for WebM |
-| Best compression | AV1 (libaom-av1) | Very slow encoding |
-
-## Resolution Presets
-
-| Preset | Resolution | Bitrate (H.264) |
-|--------|-----------|-----------------|
-| 360p | 640x360 | 800 kbps |
-| 720p | 1280x720 | 3 Mbps |
-| 1080p | 1920x1080 | 6 Mbps |
-| 4K | 3840x2160 | 15 Mbps |
-
-## Done Criteria (K4)
-
-- [ ] All FFmpeg calls go through wrapper library (no raw CLI strings)
-- [ ] Input files validated with ffprobe before processing
-- [ ] Temp files cleaned up in all paths (success + error)
-- [ ] Progress reporting for long operations
-- [ ] Codec availability checked at runtime

package/skills/vibe.video-production/rubrics/quality-checklist.md

@@ -1,58 +0,0 @@
-# Video Quality Checklist
-
-## Pre-Processing
-
-- [ ] Input file exists and is readable before pipeline starts
-- [ ] `ffprobe` run on input — codec, resolution, duration, bitrate logged
-- [ ] Corrupted/truncated files rejected with clear error (not crash)
-- [ ] Input resolution within supported range (min 360p, max 4K)
-- [ ] Audio stream present — handle gracefully if missing
-
-## Encoding
-
-- [ ] CRF-based encoding used (not fixed bitrate) for consistent visual quality
-- [ ] Target codec available in current FFmpeg build (`ffmpeg -codecs` check)
-- [ ] Encoding runs through wrapper library — no raw CLI string concatenation
-- [ ] `-movflags +faststart` set for MP4 (enables streaming before full download)
-- [ ] Audio normalized: loudness target -16 LUFS (streaming standard)
-- [ ] Aspect ratio preserved — no unintended stretching
-
-## Progress & Monitoring
-
-- [ ] Progress events emitted for any operation exceeding 10 seconds
-- [ ] Encoding timeout configured — process killed on expiry
-- [ ] Estimated time remaining shown in progress (based on bitrate processed)
-
-## Output Validation
-
-- [ ] Output file exists after encoding completes
-- [ ] Output duration verified: within ±2 seconds of input
-- [ ] Output codec matches requested codec (re-run ffprobe on output)
-- [ ] Output file size within acceptable range (flag if >3x input size)
-- [ ] Thumbnail: correct dimensions, not blank/corrupted
-
-## Subtitles (if applicable)
-
-- [ ] Subtitle file encoding is UTF-8 (convert if needed)
-- [ ] Subtitle timing verified — first/last cue in range of video duration
-- [ ] Burn-in subtitles visually tested on dark and light scenes
-
-## HLS / DASH Streaming (if applicable)
-
-- [ ] `.m3u8` manifest references correct segment file names
-- [ ] All segment files present in output directory
-- [ ] Segment duration consistent (target ±1 second of configured value)
-- [ ] CORS headers configured on media server
-
-## Storage & Cleanup
-
-- [ ] Temp directory cleaned in `finally` block — both success and error paths
-- [ ] No partial output files left on disk after failure
-- [ ] Output written to separate directory from temp files
-- [ ] Disk space checked before processing large files (minimum 3x input size free)
-
-## Security
-
-- [ ] Input file path sanitized — no directory traversal (`../`)
-- [ ] FFmpeg invoked via array arguments (not shell string) to prevent injection
-- [ ] Max file size limit enforced before processing begins

package/skills/vibe.video-production/templates/production-plan.md

@@ -1,104 +0,0 @@
-# Video Production Plan Template
-
-## Project Overview
-
-| Field | Value |
-|-------|-------|
-| Project Name | {{PROJECT_NAME}} |
-| Output Format | {{FORMAT}} (e.g., HLS, MP4, WebM) |
-| Target Resolution | {{RESOLUTION}} (e.g., 1080p) |
-| Target Codec | {{CODEC}} (e.g., H.264 / libx264) |
-| Duration (approx.) | {{DURATION}} |
-| Deadline | {{DEADLINE}} |
-
-## Input Sources
-
-| Source File | Format | Resolution | Duration | Notes |
-|-------------|--------|------------|----------|-------|
-| {{INPUT_FILE_1}} | {{FORMAT}} | {{RES}} | {{DUR}} | {{NOTES}} |
-
-Run `ffprobe -v quiet -print_format json -show_streams {{INPUT_FILE}}` to populate this table.
-
-## Processing Pipeline
-
-```
-Input Validation (ffprobe)
-  ↓
-Pre-processing (trim / deinterlace / normalize audio)
-  ↓
-Transcoding ({{CODEC}}, CRF {{CRF_VALUE}})
-  ↓
-Post-processing (subtitles / thumbnail extraction / HLS segmentation)
-  ↓
-Output Validation (verify duration, codec, bitrate)
-  ↓
-Cleanup (remove temp files)
-```
-
-## Encoding Parameters
-
-```bash
-# Replace placeholders before running
-ffmpeg \
-  -i "{{INPUT_FILE}}" \
-  -c:v {{VIDEO_CODEC}} \
-  -crf {{CRF_VALUE}} \
-  -preset {{PRESET}} \
-  -c:a aac -b:a 128k \
-  -movflags +faststart \
-  -progress pipe:1 \
-  "{{OUTPUT_FILE}}"
-```
-
-| Parameter | Value | Rationale |
-|-----------|-------|-----------|
-| Codec | {{VIDEO_CODEC}} | {{CODEC_RATIONALE}} |
-| CRF | {{CRF_VALUE}} | 18-23 = high quality, 24-28 = balanced |
-| Preset | {{PRESET}} | `slow` = better compression, `fast` = faster encoding |
-| Audio | AAC 128k | Universal compatibility |
-
-## Subtitles
-
-- [ ] Subtitle file: `{{SUBTITLE_FILE}}` (SRT / VTT)
-- [ ] Burn-in (hardcoded) or soft subtitle track: {{SUBTITLE_TYPE}}
-- [ ] Language code: `{{LANG_CODE}}`
-
-## Thumbnail Extraction
-
-```bash
-# Extract frame at {{TIMESTAMP}} seconds
-ffmpeg -i "{{INPUT_FILE}}" -ss {{TIMESTAMP}} -frames:v 1 "{{THUMBNAIL_OUTPUT}}"
-```
-
-## HLS Output (if streaming)
-
-```bash
-ffmpeg -i "{{INPUT_FILE}}" \
-  -codec: copy \
-  -start_number 0 \
-  -hls_time 10 \
-  -hls_list_size 0 \
-  -f hls \
-  "{{HLS_OUTPUT_DIR}}/stream.m3u8"
-```
-
-## Quality Gates
-
-- [ ] Input validated with ffprobe before processing starts
-- [ ] Progress callback implemented (log every 10 seconds)
-- [ ] Timeout set: {{TIMEOUT_SECONDS}}s
-- [ ] Output file size within expected range: {{MIN_SIZE}}–{{MAX_SIZE}} MB
-- [ ] Output duration matches input: ±2 seconds tolerance
-- [ ] Temp files cleaned on success AND error
-
-## Temp File Management
-
-```
-temp/
-├── {{JOB_ID}}_input_validated.{{EXT}}
-├── {{JOB_ID}}_preprocessed.{{EXT}}
-└── (cleaned up in finally block)
-
-output/
-└── {{JOB_ID}}_final.{{EXT}}
-```

package/vibe/config.json

@@ -1,30 +0,0 @@
-{
-  "models": {
-    "gpt": {
-      "enabled": false,
-      "authType": "codex-cli",
-      "role": "architecture",
-      "description": "Architecture/Debugging/Coding (GPT 5.4)"
-    },
-    "gemini": {
-      "enabled": false,
-      "authType": "apikey",
-      "role": "exploration",
-      "description": "Gemini 3.1 Pro / 3.1 Flash-Lite (Exploration, UI/UX)"
-    }
-  },
-  "stacks": [
-    {
-      "type": "typescript-node",
-      "path": ""
-    }
-  ],
-  "details": {
-    "databases": [
-      "SQLite"
-    ],
-    "stateManagement": [],
-    "hosting": [],
-    "cicd": []
-  }
-}

package/vibe/constitution.md

@@ -1,254 +0,0 @@
-# Project Constitution
-
-This document defines the core principles and coding standards for the project.
-
----
-
-## Conversation Language
-
-**Response Language**: Auto-detected from OS (en/ko)
-
-This setting controls **conversation language with user only**.
-All generated documents (SPEC, Feature, etc.) are **always in English**.
-
-To change, modify in `.vibe/config.json`:
-
-```json
-{
-  "language": "ko"  // "en" | "ko" - conversation language only
-}
-```
-
----
-
-## Document References
-
-All reference documents are stored globally and specified in `.vibe/config.json`:
-
-```json
-{
-  "references": {
-    "rules": [
-      "~/.claude/vibe/rules/principles/quick-start.md",
-      "~/.claude/vibe/rules/principles/development-philosophy.md",
-      "~/.claude/vibe/rules/principles/communication-guide.md",
-      "~/.claude/vibe/rules/quality/checklist.md",
-      "~/.claude/vibe/rules/quality/bdd-contract-testing.md",
-      "~/.claude/vibe/rules/quality/testing-strategy.md",
-      "~/.claude/vibe/rules/standards/anti-patterns.md",
-      "~/.claude/vibe/rules/standards/code-structure.md",
-      "~/.claude/vibe/rules/standards/complexity-metrics.md",
-      "~/.claude/vibe/rules/standards/naming-conventions.md"
-    ],
-    "languages": [
-      "~/.claude/vibe/languages/{detected-stack}.md"
-    ],
-    "templates": [
-      "~/.claude/vibe/templates/spec-template.md",
-      "~/.claude/vibe/templates/feature-template.md",
-      "~/.claude/vibe/templates/constitution-template.md",
-      "~/.claude/vibe/templates/contract-backend-template.md",
-      "~/.claude/vibe/templates/contract-frontend-template.md"
-    ]
-  }
-}
-```
-
-- **rules**: Core principles, quality standards, coding conventions (10 documents)
-- **languages**: Stack-specific coding standards (auto-detected from package.json)
-- **templates**: Document templates for SPEC, Feature, Contract tests (5 documents)
-
----
-
-## 1. Project Principles
-
-### Values
-1. **User-Centric**: User experience first
-2. **Quality**: Correct over fast
-3. **Simplicity**: Simple over complex
-4. **Collaboration**: Team over individual
-
-### Decision Criteria
-1. Security > Performance > Convenience
-2. Clarity > Cleverness
-3. Testable > Abstract Design
-
----
-
-## 2. Coding Standards
-
-### Common Principles
-- **DRY**: Don't Repeat Yourself
-- **SRP**: Single Responsibility Principle
-- **YAGNI**: You Aren't Gonna Need It
-- **Functions ≤50 lines** (SSOT: `CLAUDE.md` Complexity Limits)
-- **Cyclomatic Complexity ≤10**
-- **Cognitive Complexity ≤15**
-
-### Naming Rules
-- Variables: nouns (`userData`, `userList`)
-- Functions: verb+noun (`fetchData`, `updateUser`)
-- Boolean: `is/has/can` (`isLoading`, `hasError`)
-- Constants: `UPPER_SNAKE_CASE` (`MAX_RETRY_COUNT`)
-
----
-
-## 3. Quality Standards (TRUST 5)
-
-### T - Test-first
-- ✅ Contract Testing (highest priority)
-- ✅ Integration Testing (70%+ coverage)
-- 🔵 Unit Testing (pure functions only)
-
-### R - Readable
-- Clear comments and docstrings
-- Descriptive variable names
-- Comments for complex logic
-
-### U - Unified
-- Consistent coding style
-- Same patterns across project
-
-### S - Secured
-- SQL Injection prevention
-- XSS prevention
-- Sensitive info via environment variables
-
-### T - Trackable
-- Clear git commit messages
-- Use TODO/FIXME comments
-- Document important decisions
-- **수치에는 출처를 붙인다** — 아래 참조
-
----
-
-## 3.5 수치 출처 규율 (Numbers Need Provenance)
-
-문서·SPEC·커밋 메시지에 쓰는 **모든 수치는 출처가 있어야 한다.** 출처는 셋 중 하나다:
-
-| 종류 | 표기 | 예 |
-|---|---|---|
-| **실측** | 무엇을 어떻게 쟀는지 함께 | "세션 로그 60개 실측: `Agent` 13회 / `Task` 0회" |
-| **1차 문서** | 공급자 공식 문서·명세 링크 | "동시 상한 min(16, cores-2) — Workflow 도구 명세" |
-| **추정** | **추정임을 명시**하고 계산 근거를 남긴다 | "시나리오 상수 × 횟수 (추정)" |
-
-출처가 없으면 **숫자를 쓰지 않는다.** "더 빠르다", "줄어든다" 로 방향만 적는 것이
-틀린 배수를 적는 것보다 낫다.
-
-**금지**
-- 측정하지 않은 배수·퍼센트 (`3x faster`, `70% 절감`)
-- 모델·환경에 따라 달라지는 값의 절대 하드코딩 (`80–100k 토큰` — 컨텍스트 창이
-  200k 인지 1M 인지에 따라 뜻이 달라진다. 하네스가 주는 임계 신호를 쓴다)
-- 출처 없이 인용된 제3자 수치 — **인용 자체가 1차 출처의 대체물이 아니다**
-
-**WHY**: 근거 없는 수치는 반증되기 전까지 사실처럼 유통되고, 그 위에서 내린 결정은
-되돌리기 어렵다. 널리 퍼진 "AI 코딩 비용의 90%는 불필요한 컨텍스트" 인용문은 1차
-출처가 확인되지 않았고, 함께 돌던 "린트에 최상위 모델 = 30배" 는 공식 가격표 기준
-최대 10배, "배치 70~90% 절감" 은 공식 할인율 50% 였다. 방향은 맞아도 숫자는
-근거가 없었다. vibe 는 완료를 자기보고가 아니라 결정론적 게이트로 판정한다 —
-같은 기준을 **문서의 수치**에도 적용한다.
-
-## 4. Tech Stack
-
-### Backend
-- Language: TypeScript/Node.js
-- Framework: Express/Fastify
-- Database: SQLite
-
-### Frontend
-- Framework: {Flutter / React / etc.}
-- State Management: (configure per project)
-
-### Infrastructure
-- Hosting: (configure per project)
-- CI/CD: (configure per project)
-
----
-
-## 5. Git Workflow
-
-### Branch Strategy
-- `main`: Production
-- `develop`: Development (default branch)
-- `feature/{feature-name}`: New features
-- `fix/{bug-name}`: Bug fixes
-
-### Commit Message Rules
-```
-feat: Add new feature
-fix: Fix bug
-docs: Update documentation
-refactor: Refactoring
-test: Add/modify tests
-chore: Build, config changes
-```
-
-### PR Rules
-1. SPEC-based development
-2. Code review required
-3. Tests must pass
-4. SPEC verification complete
-
----
-
-## 6. Code Review Criteria
-
-### Required Checks
-- [ ] SPEC requirements met
-- [ ] TRUST 5 compliant
-- [ ] Tests written and passing
-- [ ] Documentation complete
-- [ ] No security issues
-
-### Recommendations
-- [ ] Performance optimization considered
-- [ ] Scalability considered
-- [ ] Error handling complete
-
----
-
-## 7. Documentation Rules
-
-### Code Comments
-- All functions: docstrings
-- Complex logic: inline comments
-- TODO/FIXME: include issue number
-
-### API Documentation
-- OpenAPI (Swagger) auto-generated
-- Include example Request/Response
-
-### README
-- Project overview
-- Installation and run instructions
-- Main features description
-
----
-
-## 8. Security Policy
-
-### Authentication
-- JWT-based authentication
-- Refresh token usage
-
-### Authorization
-- Role-based Access Control
-- Least privilege principle
-
-### Data Protection
-- Encrypt personal information
-- HTTPS required
-- Manage secrets via environment variables
-
----
-
-## 9. Performance Goals
-
-### Response Time
-- API: P95 < 500ms
-- Web page: FCP < 1.5s
-
-### Availability
-- Uptime: 99.9%
-- RTO: 1 hour
-- RPO: 15 minutes