@su-record/vibe 2.16.2 → 2.16.4

package/skills/design-audit/orchestrator.md

@@ -6,6 +6,8 @@ agents: [a11y-auditor, performance-auditor, responsive-auditor, slop-detector, s
 
 # Design Audit Orchestrator
 
+> 구조·섹션·네이밍은 vibe/rules/orchestrator-contract.md (SSOT) 를 따른다.
+
 ## Workflow
 
 ### Phase 1: Launch Dimension Auditors

package/skills/exec-plan/orchestrator.md

@@ -6,6 +6,8 @@ agents: [decomposer, dependency-mapper, estimator, validator]
 
 # Exec-Plan Orchestrator
 
+> 구조·섹션·네이밍은 vibe/rules/orchestrator-contract.md (SSOT) 를 따른다.
+
 ## Workflow
 
 ### Phase 1: Decompose

package/skills/parallel-research/orchestrator.md

@@ -6,6 +6,8 @@ agents: [best-practices, framework-docs, codebase-patterns, security-advisory, s
 
 # Parallel Research Orchestrator
 
+> 구조·섹션·네이밍은 vibe/rules/orchestrator-contract.md (SSOT) 를 따른다.
+
 ## Workflow
 
 ### Phase 1: Launch Research Agents

package/skills/techdebt/orchestrator.md

@@ -6,6 +6,8 @@ agents: [scanner, analyzer, fixer, reviewer]
 
 # Techdebt Orchestrator
 
+> 구조·섹션·네이밍은 vibe/rules/orchestrator-contract.md (SSOT) 를 따른다.
+
 ## Workflow
 
 ### Phase 1: Scan

package/skills/vibe.clone/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: vibe.clone
 description: URL → 마크업 레벨 픽셀 완벽 클론 — 헤드리스 브라우저로 라이브 사이트 캡처 후 현재 프로젝트 스택에 맞게 스캐폴딩
-argument-hint: "<url> [<url2>...] [--name=<feature>] [--mo-only] [--pc-only] [--ignore-robots]"
+argument-hint: "<url> [<url2>...] [--name=<feature>] [--mo-only] [--pc-only] [--ignore-robots] [--no-interact]"
 user-invocable: true
 ---
 
@@ -20,6 +20,7 @@ URL을 받아 **마크업 수준으로 정밀 복제**하고 현재 프로젝트
 /vibe.clone <url> --name=stripe-clone          # 기능 이름 지정 (기본: 호스트명 kebab-case)
 /vibe.clone <url1> <url2> <url3>               # 다중 페이지 클론 (같은 사이트의 여러 경로)
 /vibe.clone <url> --ignore-robots              # robots.txt 무시 (사이트 소유자 허가 있을 때만)
+/vibe.clone <url> --no-interact                # 능동 인터랙션 스윕 끄기 (완전 결정론적·재현 가능 캡처)
 ```
 
 ## Argument Routing
@@ -52,7 +53,9 @@ Phase 0: Setup
 Phase 1: Capture (병렬 — scope에 따라 MO/PC 동시)
   - node {{VIBE_PATH}}/hooks/scripts/clone-extract.js capture <url> \
       --out=/tmp/{feature}/{bp}/ --viewport={WxH} --bp={mo|pc}
-  - 출력: rendered.html, computed.json, screenshot.png, states.json, asset-map.json, assets/
+  - 출력: rendered.html, computed.json, screenshot.png, states.json, behaviors.json, asset-map.json, assets/
+  - behaviors.json = 능동 인터랙션 스윕(스크롤 시 헤더/내비 변화 diff + 탭 클릭 콘텐츠 스왑 감지).
+    JS로 세팅되는 상태(정적 CSS로는 안 잡힘)를 포착 — 클론 정확도의 핵심. --no-interact 로 비활성화.
 
 Phase 2: Refine (BP마다 독립)
   - node {{VIBE_PATH}}/hooks/scripts/clone-refine.js \
@@ -88,7 +91,7 @@ Phase 5: Pixel Verification (P1=0까지 루프 — clone SKILL.md 규칙)
 
 ```
 /tmp/{feature}/                  # 작업 디렉토리 (산출물 원본)
-  ├── mo/, pc/                   # rendered.html, computed.json, screenshot.png, states.json, sections.json, assets/
+  ├── mo/, pc/                   # rendered.html, computed.json, screenshot.png, states.json, behaviors.json, sections.json, assets/
   └── project-tokens.json        # 기존 프로젝트 토큰 인덱스
 
 ./components/{feature}/          # Claude가 작성한 컴포넌트 (.tsx/.vue/.svelte/.html)

package/skills/vibe.llm/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: vibe.llm
+description: Refresh available models for claude/openai(api+oauth)/gemini/zai as of now and update the vibe model SSOT
+argument-hint: "list | refresh"
+user-invocable: true
+---
+
+# /vibe.llm
+
+현재 시점 기준으로 각 LLM provider(claude, openai API+oauth, gemini, zai)의
+**사용 가능한 모델을 최신화**하고, vibe 가 쓰는 **모델 SSOT(`~/.vibe/config.json` models)**를 갱신한다.
+
+## Usage
+
+```
+/vibe.llm list        # provider 별 현재 사용 가능한 모델 표시 (★ = 추천/최신)
+/vibe.llm refresh     # 라이브 조회 → 추천 모델을 config.json models 에 반영
+```
+
+CLI 로도 동일하게 동작한다:
+
+```
+vibe llm list
+vibe llm refresh
+```
+
+## 동작
+
+1. **라이브 조회** — 각 provider 의 list-models API 호출:
+   - claude: `GET /v1/models` (ANTHROPIC_API_KEY)
+   - openai: `GET /v1/models` (OPENAI_API_KEY). 키 없이 oauth(Codex)만 있으면 큐레이션 목록 표시
+   - gemini: `GET /v1beta/models` (GEMINI_API_KEY)
+   - zai: `GET /models` (coding/general 키)
+2. **fallback** — 키가 없거나 API 실패 시 in-repo 큐레이션 목록을 사용(무네트워크에서도 동작)
+3. **SSOT 갱신** — provider 별 추천(최신) 모델을 `~/.vibe/config.json` 의 `models`
+   (gpt, gemini, zai, zaiCoding)에 기록. 변경 내역을 출력한다.
+
+> Claude 모델은 Claude Code tier(sonnet/opus/haiku alias)로 관리되므로 자동으로 덮어쓰지 않고
+> 조회 결과만 표시한다.
+
+## 구현 위치
+
+- CLI: `src/cli/commands/llm.ts` → `src/cli/llm/model-refresh.ts`
+- SSOT: `~/.vibe/config.json` `models` (ModelOverrides)
+
+이 스킬은 위 CLI 를 호출하고 결과(변경된 모델 SSOT)를 요약해 보고한다.
+
+---
+
+ARGUMENTS: $ARGUMENTS

package/vibe/rules/orchestrator-contract.md

@@ -0,0 +1,56 @@
+# Orchestrator Contract — orchestrator 스킬 작성 계약 (SSOT)
+
+> `type: orchestrator` 스킬(fan-out/fan-in 으로 서브에이전트를 조율하는 스킬)의
+> **구조·스키마·네이밍 규칙**의 유일한 정의다. 각 orchestrator.md 는 이 스키마를 따르되
+> **내용(phase·실패모드·에이전트)은 스킬별로 고유**하다 — 내용을 공유 파일로 병합하지 않는다.
+>
+> 대상: `skills/{techdebt,parallel-research,exec-plan,design-audit,create-prd}/orchestrator.md`
+
+## Frontmatter
+
+```yaml
+---
+name: <skill>-orchestrator      # 스킬 디렉토리명 + "-orchestrator"
+type: orchestrator
+agents: [<agent-basename>, ...]  # skills/<skill>/agents/ 의 파일 basename (접두사 없이)
+---
+```
+
+## 필수 섹션 (순서 고정)
+
+1. `## Workflow` — `### Phase N: <이름>` 목록. 각 Phase 는 아래 4개 필드를 갖는다:
+   - `**Agent**:` — 이 Phase 를 수행하는 에이전트의 **basename**(복수 가능), 또는 `orchestrator (self)`
+   - `**Input**:` / `**Output**:` — 데이터 계약
+   - `**Parallel**:` — `yes`/`no` + 한 줄 근거
+2. `## DAG (Dependency Graph)` — Phase 의존 관계를 `mermaid graph TD` 로.
+3. `## Error Handling` — 스키마 고정 3열 테이블. 행 내용은 스킬별 고유:
+
+   | Phase | Failure Mode | Strategy |
+   |-------|-------------|----------|
+
+4. `## Scalability Modes` — 스키마 고정 3열 테이블. `Full`/`Reduced`/`Single` 3-tier 분류:
+
+   | Mode | When | Agents Used |
+   |------|------|-------------|
+
+## 에이전트 네이밍 규칙
+
+전역 에이전트(`agents/**/*.md`, `CLAUDE_MODEL_MAPPING` 키)와의 **이름 충돌을 피하기 위해**
+skill-local 에이전트는 접두사를 붙인다:
+
+- 에이전트 파일의 frontmatter `name:` = `<prefix>-<agent-basename>`
+- 에이전트끼리의 상호 참조("Reports findings to: …", "… from …")도 **접두사 이름**으로
+- 단, orchestrator.md 의 frontmatter `agents:[]` 와 Workflow `**Agent**:` 는 **basename**(접두사 없이) — 파일명과 일치
+
+**Prefix registry** (스킬 → 접두사):
+
+| Skill | Prefix | 예 |
+|-------|--------|-----|
+| techdebt | `techdebt` | `techdebt-scanner` |
+| exec-plan | `plan` | `plan-decomposer` |
+| design-audit | `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 에이전트를 혼동한다.