@su-record/vibe 2.9.40 → 2.10.2

package/{commands/vibe.regress.md → skills/vibe.regress/SKILL.md}

@@ -1,6 +1,8 @@
 ---
+name: vibe.regress
 description: Regression test auto-evolution — register bugs, generate preventive tests, cluster patterns
 argument-hint: "register | generate | list | import | cluster [args]"
+user-invocable: true
 ---
 
 # /vibe.regress
@@ -26,11 +28,11 @@ argument-hint: "register | generate | list | import | cluster [args]"
 
 ## Process
 
-Load skill `vibe-regress` with subcommand: `$ARGUMENTS`
+Load skill `regress` with subcommand: `$ARGUMENTS`
 
-The `vibe-regress` skill performs registration, generation, and clustering.
+The `regress` skill performs registration, generation, and clustering.
 
-**Core steps** (see `skills/vibe-regress/SKILL.md` for details):
+**Core steps** (see `skills/regress/SKILL.md` for details):
 
 1. Parse subcommand
 2. Read/write `.vibe/regressions/<slug>.md` (frontmatter schema enforced)

package/{commands/vibe.review.md → skills/vibe.review/SKILL.md}

@@ -1,6 +1,8 @@
 ---
+name: vibe.review
 description: Multi-agent parallel code review with priority-based findings
 argument-hint: "PR number, branch name, or file path"
+user-invocable: true
 ---
 
 # /vibe.review

package/{commands/vibe.run.md → skills/vibe.run/SKILL.md}

@@ -1,6 +1,8 @@
 ---
+name: vibe.run
 description: Execute implementation from SPEC
 argument-hint: "feature name" or --phase N
+user-invocable: true
 ---
 
 # /vibe.run
@@ -57,7 +59,7 @@ Execute **Scenario-Driven Implementation** with automatic quality verification.
 Run immediately after start:
 
 ```
-Load skill `vibe-regress` with: list --feature "{feature-name}"
+Load skill `regress` with: list --feature "{feature-name}"
 ```
 
 - If any open regressions exist:
@@ -122,6 +124,8 @@ Scenario 3 → Implement → Verify ❌ → Fix → ✅
 All pass = Quality guaranteed
 ```
 
+> **하네스-안전 증분 (Dual-Harness Doctrine)**: 시나리오는 **가장 작은 검증 단위**다. 한 시나리오 구현 → 즉시 검증 → 다음. 여러 시나리오를 묶어 빅뱅으로 구현하지 않는다 — Codex(직역) 에서 성공률이 급락하고 CC 에서도 디버깅 비용만 늘린다. `ultrawork` 모드라도 이 단위는 무너뜨리지 않는다 (병렬은 시나리오 간, 검증은 시나리오별). 전문: `vibe/rules/principles/dual-harness-doctrine.md`.
+
 ### Automated Verification (Closed Loop)
 
 **자율적 AI 코딩 = 구현 + 검증 + 반복. 검증을 AI에게 맡기는 순간 루프가 닫힌다.**

package/{commands/vibe.scaffold.md → skills/vibe.scaffold/SKILL.md}

@@ -1,6 +1,8 @@
 ---
+name: vibe.scaffold
 description: Generate or audit project folder structure optimized for AI-assisted development
 argument-hint: --check (audit existing) or project-type
+user-invocable: true
 ---
 
 # /vibe.scaffold

package/{commands/vibe.spec.md → skills/vibe.spec/SKILL.md}

@@ -1,6 +1,8 @@
 ---
+name: vibe.spec
 description: 프로젝트 명세 통합 진입점 — interview → plan → spec → review → run/figma 전체 워크플로 오케스트레이션
 argument-hint: "(선택) feature name, plan/interview file path, or idea"
+user-invocable: true
 ---
 
 # /vibe.spec
@@ -25,7 +27,7 @@ argument-hint: "(선택) feature name, plan/interview file path, or idea"
 
 - **단일 진입점**: `/vibe.spec` 하나로 전체 워크플로 시작. 다른 `/vibe.*` 커맨드 이름 외울 필요 없음.
 - **Smart resume**: 기존 interview/plan/spec 파일 존재 여부로 어느 단계부터 시작할지 자동 판단.
-- **자동 체이닝**: 스킬 `chain-next` 메타데이터 따라 vibe-interview → vibe-plan → vibe-spec → vibe-spec-review 진행.
+- **자동 체이닝**: 스킬 `chain-next` 메타데이터 따라 interview → plan → spec → spec-review 진행.
 - **분기 판단**: 기획서의 `type` 필드로 UI 트랙/로직 트랙 여부 결정.
 - **사용자 제어**: 각 단계 사이에 사용자 확인 지점(stop gate) 제공 (ultrawork 모드는 스킵).
 
@@ -41,14 +43,14 @@ Phase 0.5: Input 분석 + Smart resume 결정
     - 기존 .vibe/{interviews,plans,specs}/ 확인
     - 시작 단계 결정: interview | plan | spec | review
     ↓
-Phase 1: Interview (skill: vibe-interview)
+Phase 1: Interview (skill: interview)
     - 조건: interview 파일 없음
     - 사용자 "그만"까지 반복 인터뷰
     - 출력: .vibe/interviews/{feature}.md
     ↓
     [Stop Gate 1] — ultrawork 모드에서는 스킵
     ↓
-Phase 2: Plan (skill: vibe-plan)
+Phase 2: Plan (skill: plan)
     - 조건: plan 파일 없음
     - interview → 마크다운 기획서 정제
     - 출력: .vibe/plans/{feature}.md
@@ -58,14 +60,14 @@ Phase 2: Plan (skill: vibe-plan)
       - website/webapp/mobile → UI + Logic 병렬
       - api/library/feature-data → Logic만
     ↓
-Phase 3: SPEC 작성 (skill: vibe-spec)
+Phase 3: SPEC 작성 (skill: spec)
     - PTCF 구조 SPEC 문서 + Feature(BDD) 파일
     - Parallel research (GPT/Gemini/Claude agents)
     - Large scope 자동 분할
     - Ambiguity scan + 품질 게이트(100점, 수렴까지 루프)
     - 출력: .vibe/specs/{feature}.md + .vibe/features/{feature}.feature
     ↓
-Phase 4: SPEC Review (skill: vibe-spec-review)
+Phase 4: SPEC Review (skill: spec-review)
     - Race Review (GPT + Gemini, 라운드 수 캡 없음, 수렴까지 루프)
     - (옵션) Codex adversarial review
     - 사용자 최종 체크포인트
@@ -138,7 +140,7 @@ Step 1) .vibe/.last-feature 확인 (pointer 파일)
        ✅ interview: .vibe/interviews/{feature}.md  (status: complete, N일 전)
        ✅ plan:      .vibe/plans/{feature}.md       (N일 전)
        ❌ spec:      없음
-       → 다음 단계: Phase 3 (vibe-spec 스킬 — SPEC 작성)
+       → 다음 단계: Phase 3 (spec 스킬 — SPEC 작성)
 
        이어서 진행할까요?
          Enter / yes → 이어서 진행
@@ -224,7 +226,7 @@ Step 3) 빈 시작 (기존 동작)
 분류: 신규 아이디어
 기존 파일: 없음
 
-→ 시작 단계: Phase 1 (vibe-interview)
+→ 시작 단계: Phase 1 (interview)
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -235,7 +237,7 @@ Step 3) 빈 시작 (기존 동작)
 **진입 방식:**
 
 1. **인자 있음** (`/vibe.spec "아이디어"`)
-   → `vibe-interview` 스킬 로드 + 아이디어 전달
+   → `interview` 스킬 로드 + 아이디어 전달
 
 2. **인자 없음** (`/vibe.spec`)
    → **Smart Resume Fallback 먼저** (Phase 0.5 참조):
@@ -256,19 +258,19 @@ Step 3) 빈 시작 (기존 동작)
 
    (파일/이미지 첨부도 가능)
    ```
-   → 사용자 응답 → `vibe-interview` 스킬 로드
+   → 사용자 응답 → `interview` 스킬 로드
 
 **스킬 로드:**
 
 ```
-Load skill `vibe-interview` with input: {user_idea}
+Load skill `interview` with input: {user_idea}
 ```
 
-> **`.last-feature` 갱신**: vibe-interview 스킬이 feature name을 확정하는 즉시 `.vibe/.last-feature` 에 한 줄로 기록. 이후 Phase 2/3/4 진입 시에도 동일 기록 유지 (값이 같으면 no-op).
+> **`.last-feature` 갱신**: interview 스킬이 feature name을 확정하는 즉시 `.vibe/.last-feature` 에 한 줄로 기록. 이후 Phase 2/3/4 진입 시에도 동일 기록 유지 (값이 같으면 no-op).
 
-`vibe-interview` 스킬이 자체적으로:
+`interview` 스킬이 자체적으로:
 - 프로젝트 타입 감지 (website/webapp/mobile/api/library/feature)
-- 타입별 체크리스트 로드 (`skills/vibe-interview/checklists/{type}.md`)
+- 타입별 체크리스트 로드 (`skills/interview/checklists/{type}.md`)
 - 반복 인터뷰 실행 (사용자 "그만"까지)
 - `.vibe/interviews/{feature-name}.md` 저장
 
@@ -285,7 +287,7 @@ Load skill `vibe-interview` with input: {user_idea}
 다음 단계: 기획서 작성
   1. 계속 진행 (기본)
   2. Interview만 저장하고 종료
-  3. Interview 수정 후 다시 (vibe-interview 재실행)
+  3. Interview 수정 후 다시 (interview 재실행)
 
 Enter → 계속
 ```
@@ -295,10 +297,10 @@ Enter → 계속
 **진입 조건:** plan 파일이 아직 없음
 
 ```
-Load skill `vibe-plan` with input: .vibe/interviews/{feature}.md
+Load skill `plan` with input: .vibe/interviews/{feature}.md
 ```
 
-`vibe-plan` 스킬이 자체적으로:
+`plan` 스킬이 자체적으로:
 - 템플릿 로드 (`~/.claude/vibe/templates/plan-template.md`)
 - Interview 섹션별 정제
 - UI 섹션 조건부 포함 (type 기반)
@@ -334,12 +336,12 @@ Enter → 계속
 **진입 조건:** spec 파일이 아직 없음 (또는 재작성 요청)
 
 ```
-Load skill `vibe-spec` with input: .vibe/plans/{feature}.md
+Load skill `spec` with input: .vibe/plans/{feature}.md
 ```
 
-`vibe-spec` 스킬이 PTCF 구조 SPEC 문서 + Feature(BDD) 파일 생성.
+`spec` 스킬이 PTCF 구조 SPEC 문서 + Feature(BDD) 파일 생성.
 
-**핵심 단계** (상세는 `skills/vibe-spec/SKILL.md` 참조):
+**핵심 단계** (상세는 `skills/spec/SKILL.md` 참조):
 
 1. Project analysis (explorer agent)
 2. config.json references 로드
@@ -358,12 +360,12 @@ Load skill `vibe-spec` with input: .vibe/plans/{feature}.md
 ### Phase 4: SPEC Review
 
 ```
-Load skill `vibe-spec-review` with feature: {feature-name}
+Load skill `spec-review` with feature: {feature-name}
 ```
 
-`vibe-spec-review` 스킬이 Race Review + 품질 검증 + 사용자 체크포인트 실행.
+`spec-review` 스킬이 Race Review + 품질 검증 + 사용자 체크포인트 실행.
 
-**핵심 단계** (상세는 `skills/vibe-spec-review/SKILL.md` 참조):
+**핵심 단계** (상세는 `skills/spec-review/SKILL.md` 참조):
 
 1. SPEC/Feature 파일 로드 (single/split 자동 감지)
 2. Quality Validation (100점 게이트, 수렴까지 auto-fix 루프)
@@ -375,7 +377,7 @@ Load skill `vibe-spec-review` with feature: {feature-name}
 ### Phase 4.5: Contract Extract (auto, only for features with an API)
 
 ```
-Load skill `vibe-contract` with: extract "{feature-name}"
+Load skill `contract` with: extract "{feature-name}"
 ```
 
 If the SPEC has a `## API` / `## Endpoints` / `## Interface` section, extract the contract to `.vibe/contracts/{feature-name}.md`. If the section is absent, exit cleanly (not every feature has an API).
@@ -446,9 +448,9 @@ Claude: 🔍 Input 분석
         입력: "원두 브랜드 랜딩"
         분류: 신규 아이디어
         기존 파일: 없음
-        → 시작 단계: Phase 1 (vibe-interview)
+        → 시작 단계: Phase 1 (interview)
 
-        [vibe-interview 스킬 로드]
+        [interview 스킬 로드]
         Type: website 감지 → checklists/website.md 로드
         ...
 ```
@@ -461,9 +463,9 @@ Claude: 🔍 Input 분석
         입력: plan 파일 경로
         분류: 기존 기획서
         Feature: bean-landing
-        → 시작 단계: Phase 3 (vibe-spec)
+        → 시작 단계: Phase 3 (spec)
 
-        [vibe-spec 스킬 로드]
+        [spec 스킬 로드]
         기획서 읽기 → research → PTCF 작성 ...
 ```
 
@@ -477,9 +479,9 @@ Claude: 🔍 Input 분석
           ✅ interview: .vibe/interviews/bean-landing.md
           ✅ plan: .vibe/plans/bean-landing.md
           ❌ spec: 없음
-        → 시작 단계: Phase 3 (vibe-spec)
+        → 시작 단계: Phase 3 (spec)
 
-        [vibe-spec 스킬 로드]
+        [spec 스킬 로드]
         ...
 ```
 
@@ -493,7 +495,7 @@ Claude: 🔍 Input 분석
           ✅ feature: .vibe/features/bean-landing.feature
 
         이미 SPEC이 존재합니다. 어떻게 진행할까요?
-        1. SPEC 리뷰 (Phase 4: vibe-spec-review 스킬 로드)
+        1. SPEC 리뷰 (Phase 4: spec-review 스킬 로드)
         2. /vibe.run 실행 (구현)
         3. SPEC 재작성 (기존 백업 후 새로 작성)
         4. 종료
@@ -509,7 +511,7 @@ Claude: (.last-feature 읽기 → "bean-landing" 발견)
         ✅ interview: .vibe/interviews/bean-landing.md  (status: partial, 2일 전)
         ❌ plan:      없음
         ❌ spec:      없음
-        → 다음 단계: Phase 2 (vibe-plan — 기획서 작성)
+        → 다음 단계: Phase 2 (plan — 기획서 작성)
 
         이어서 진행할까요?
           Enter / yes → 이어서 진행
@@ -521,7 +523,7 @@ User: yes
 
 Claude: [Phase 2 진입]
         .last-feature = bean-landing
-        [vibe-plan 스킬 로드]
+        [plan 스킬 로드]
         ...
 ```
 
@@ -545,7 +547,7 @@ Claude: (.last-feature 없음 → 디렉토리 스캔)
 User: 2
 
 Claude: Feature: todo-app 선택
-        ✅ plan 완성 → Phase 3 (vibe-spec) 진입
+        ✅ plan 완성 → Phase 3 (spec) 진입
         .last-feature = todo-app
         ...
 ```
@@ -557,7 +559,7 @@ Claude: Feature: todo-app 선택
 - 중단 시 다시 `/vibe.spec`으로 돌아오면 Smart Resume Fallback 동작:
   - 인자 있음 (`/vibe.spec "feature-name"` 또는 파일 경로) → 해당 feature의 가장 진행된 단계 다음으로 바로 진입
   - 인자 없음 → `.last-feature` 우선 제안 → 거부하면 진행 중 작업 목록 제시 → 또 거부하면 빈 시작
-- 수동 개입 필요시 스킬 직접 호출 가능 (`Load skill vibe-interview` 등)
+- 수동 개입 필요시 스킬 직접 호출 가능 (`Load skill interview` 등)
 
 ## Next Step
 

package/{commands/vibe.test.md → skills/vibe.test/SKILL.md}

@@ -1,6 +1,8 @@
 ---
+name: vibe.test
 description: Self-test vibe — probe every command/skill/hook/agent in the target harness install dir and write a pass/fail report
-argument-hint: "[cc|coco]  (empty = current harness)"
+argument-hint: "[cc|codex]  (empty = current harness)"
+user-invocable: true
 ---
 
 # /vibe.test
@@ -12,10 +14,10 @@ argument-hint: "[cc|coco]  (empty = current harness)"
 ```
 /vibe.test         # Test current harness (auto-detect)
 /vibe.test cc      # Force-test ~/.claude/
-/vibe.test coco    # Force-test ~/.coco/
+/vibe.test codex   # Force-test ~/.codex/
 ```
 
-No subcommands. No CC-vs-coco comparison semantics. One command, one report.
+No subcommands. No CC-vs-Codex comparison semantics. One command, one report.
 
 ## Report
 
@@ -30,12 +32,12 @@ Markdown summary is also printed to the console when the run finishes.
 
 ## Process
 
-Load skill `vibe-test` with target harness: `$ARGUMENTS`
+Load skill `test` with target harness: `$ARGUMENTS`
 
-- If `$ARGUMENTS` is empty, detect the current harness (CC vs coco) and use that.
+- If `$ARGUMENTS` is empty, detect the current harness (CC vs Codex) and use that.
 - If the target install dir is missing, exit cleanly with guidance (not an error).
 
-See `skills/vibe-test/SKILL.md` for the probe spec and the report template.
+See `skills/test/SKILL.md` for the probe spec and the report template.
 
 ## Done Criteria
 

package/{commands/vibe.trace.md → skills/vibe.trace/SKILL.md}

@@ -1,3 +1,10 @@
+---
+name: vibe.trace
+description: Generate and display Requirements Traceability Matrix (RTM) — REQ → SPEC → Feature → Code 관계 추적
+argument-hint: "feature-name [--html] [--save]"
+user-invocable: true
+---
+
 # /vibe.trace
 
 Generate and display Requirements Traceability Matrix (RTM).

package/{commands/vibe.utils.md → skills/vibe.utils/SKILL.md}

@@ -1,6 +1,8 @@
 ---
+name: vibe.utils
 description: Utility tools (UI preview, diagram, E2E test, image generation, etc.)
 argument-hint: "--ui, --diagram, --e2e, --image, or other options"
+user-invocable: true
 ---
 
 # /vibe.utils

package/{commands/vibe.verify.md → skills/vibe.verify/SKILL.md}

@@ -1,6 +1,8 @@
 ---
+name: vibe.verify
 description: Verify implementation against SPEC requirements
 argument-hint: "feature name"
+user-invocable: true
 ---
 
 # /vibe.verify
@@ -255,7 +257,7 @@ Before printing the failure report, **auto-register each failed scenario as a re
 
 ```
 For each failed scenario:
-  Load skill `vibe-regress` with:
+  Load skill `regress` with:
     subcommand: register --from-verify
     feature: {feature-name}
     scenario: {scenario-name}
@@ -435,7 +437,7 @@ node -e "import('{{VIBE_PATH_URL}}/node_modules/@su-record/vibe/dist/tools/index
 After all scenarios pass, auto-invoke:
 
 ```
-Load skill `vibe-contract` with: check "{feature-name}"
+Load skill `contract` with: check "{feature-name}"
 ```
 
 - Skip if `.vibe/contracts/{feature-name}.md` does not exist

package/skills/video-production/SKILL.md

@@ -1,5 +1,6 @@
 ---
 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]

package/vibe/rules/principles/dual-harness-doctrine.md

@@ -0,0 +1,50 @@
+# Dual-Harness Doctrine
+
+> vibe는 여러 하네스(Claude Code, Codex, Gemini) 위에서 동작한다.
+> 차이는 경로·파일명 같은 **인프라**가 아니라 **인지 방식**에 있다.
+
+## 비대칭의 본질
+
+| | Claude Code | Codex |
+|---|---|---|
+| 모호한 요청 | 의도를 **추론**해 알아서 채움 | **직역** — 지시한 그대로만, 예시 텍스트도 실데이터로 |
+| research 트리거 | planning mode를 켜야 시작 | 모드 없이 **자발적** 탐색 |
+| 작업 단위 | 한 번에 working solution → 끝에 QA | **작게 순차** + 단계별 검증이 성공률 높음 |
+| 도메인 지식 | 탐색을 맡겨도 됨 | 직접 주입할수록(라이브러리·함수·위치) 정확도↑ |
+
+## Core Principle
+
+> **vibe는 어떤 하네스의 *암묵적 동작*에도 의존하지 않는다.**
+> **추론은 `/vibe` 디스패처가 앞단에서 한 번 하고, skill 본문은 모든 것을 명시적으로 쓴다.**
+
+= **"명시성 공통분모 + 추론 앞단"** 모델
+
+- **skill 본문 = 낮은 공통분모**: 명시적·직역-안전. Codex에서 안전하고 CC에서도 여전히 정확.
+- **`/vibe` 디스패처 = 추론 레이어**: 모호한 자연어를 명시적 지시로 *먼저* 펼쳐, 모든 하네스에서 CC급 편의를 제공.
+
+## Operating Rules
+
+1. **추론은 앞단에서 단 한 번.** `/vibe`가 모호한 NL → 명시적·직역 가능한 지시로 전개한다. 하위 skill은 모호한 입력을 받지 않는다.
+2. **예시·placeholder는 명시 표기.** 직역 하네스가 실데이터로 넣을 수 있는 예시 텍스트를 무표기로 쓰지 않는다. `<예시>`, `[채워넣을 값]`, `{{placeholder}}` 사용. (Codex는 무표기 예시를 그대로 테스트 데이터에 넣는다.)
+3. **research는 명시적으로 트리거.** "planning mode" 스위치에 의존하지 않는다. 조사·탐색이 필요한 단계는 skill이 말로 지시한다.
+4. **가장 작은 검증 단위로 분해.** 구현 → 검증 → 다음. 여러 단위를 묶지 않는다. (`vibe.run`의 시나리오 루프가 이미 이 방식 — ultrawork가 빅뱅으로 무너뜨리지 않게 유지.)
+5. **도메인 지식은 SPEC에 주입.** SPEC/plan은 구체적 라이브러리명·함수명·파일 위치를 담는다. 선택이 아닌 **의무 출력** — Codex 정확도가 여기에 비례한다.
+
+## Hooks Across Harnesses
+
+CC의 풍부한 hook 모델(PreToolUse/PostToolUse/UserPromptSubmit/Stop)에는 Codex에 완전한 등가물이 없다. hook의 **의도**별로 하네스에 맞는 메커니즘에 매핑한다.
+
+| hook 의도 | Claude Code | Codex |
+|---|---|---|
+| 라이프사이클 (turn 완료, 세션 시작/종료) | `Stop` / `SessionStart` hook | `config.toml`의 `notify` 프로그램 (agent-turn-complete 시 JSON 발화) |
+| pre-edit / scope guard | `PreToolUse` (동기 deny) | ❌ 동기 인터셉트 없음 → AGENTS.md 운영 규칙 + notify 기반 사후 검증 |
+| 키워드 디스패치 (ralph/ultrawork) | `UserPromptSubmit` | AGENTS.md 지시 (Codex가 직역 실행) |
+| 금지 패턴 차단 | `PreToolUse` | AGENTS.md 규칙 + 에이전트에게 실행하라 지시한 check 명령 |
+
+**핵심 통찰: Codex의 직역 성향이 AGENTS.md "soft hook"을 신뢰성 있게 만든다.** CC는 soft 지시를 가끔 무시해 hard hook이 필요하지만, Codex는 적힌 대로 실행한다. 따라서:
+
+- **하드 라이프사이클 이벤트** → Codex `config.toml notify` (실제·결정적). `stop-dispatcher` 로직(auto-commit, devlog, review gate) 재사용 가능.
+- **행동 가드** → AGENTS.md 운영 규칙. 직역이라 *오히려* 신뢰성 있음.
+- **진짜 동기 pre-edit 차단은 Codex에서 불가** — 사후 검증을 완화책으로 수용한다.
+
+> **Action item (미구현):** `.codex/settings.local.json`에 죽은 hook을 쓰는 것을 중단하고, 대신 `.codex/config.toml`에 `notify` 핸들러를 생성해 `stop-dispatcher` 로직을 재사용하며, 가드 규칙은 AGENTS.md로 방출한다.