@su-record/vibe 2.16.3 → 2.16.4

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 에이전트를 혼동한다.