@su-record/vibe 2.9.40 → 2.10.2

package/skills/typescript-advanced-types/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: typescript-advanced-types
+invocation: [auto]
 tier: core
 description: "TypeScript advanced type system master guide. Covers Generics, Conditional Types, Mapped Types, Template Literals, Utility Types. Activates for complex type logic, reusable type utilities, and compile-time type safety."
 sections:

package/skills/ui-ux-pro-max/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: ui-ux-pro-max
+invocation: [command]
 tier: standard
 description: "UI/UX design intelligence with bold aesthetic direction. Searchable database: 50+ styles, 97 color palettes, 57 font pairings, 99 UX guidelines, 25 chart types across 9 stacks (React, Vue, Svelte, Angular, Astro, Next.js, Flutter, Swift, Kotlin). Use when building any UI component, choosing color schemes, selecting typography, applying design patterns, or reviewing UX compliance. Must use this skill when user builds frontend — pages, components, dashboards, or landing pages — to ensure design quality beyond generic AI output."
 ---

package/skills/user-personas/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: user-personas
+invocation: [auto, chain]
 tier: standard
 description: "Create refined user personas from research data — 3 personas with JTBD, pains, gains, and unexpected insights."
 triggers: [persona, user persona, user profile, user segment, user research]

package/skills/vercel-react-best-practices/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: vercel-react-best-practices
+invocation: [auto]
 tier: core
 description: "React/Next.js performance gotchas from Vercel engineering. Non-intuitive pitfalls that LLMs commonly miss."
 triggers: [react, next.js, performance, optimization, vercel, component, rendering]

package/skills/vibe/SKILL.md

@@ -0,0 +1,288 @@
+---
+name: vibe
+description: Dynamic dispatcher — 자연어 요구사항 + 첨부(URL/이미지/PDF/파일)를 받아 적합한 vibe.* 파이프라인을 동적 설계하고 1회 승인 후 체인 실행
+argument-hint: "<자연어 요구사항> [+ URL/이미지/PDF/파일 첨부]"
+user-invocable: true
+---
+
+# /vibe
+
+**vibe의 메인 진입점.** 사용자는 "무엇을 만들지 / 무엇을 할지"만 자연어로 말한다. vibe가 의도를 분석해 어떤 `/vibe.*` 스킬을 어떤 순서로 호출할지 파이프라인을 동적으로 설계하고, **1회 승인 후 실행**한다.
+
+## Usage
+
+```
+/vibe "패럴랙스 웹사이트 만들어줘"
+/vibe "여기 figma 링크 https://figma.com/file/abc 로 로그인 페이지"
+/vibe "로그인 회귀 테스트 다시 돌려서 통과시켜줘"
+/vibe "이 SPEC 리뷰만 한번 봐줘" + 📎 .vibe/specs/login.md
+/vibe "PRD 문서 기반으로 진행" + 📎 docs/prd.pdf
+/vibe "..." ultrawork    # 승인 게이트 없이 자동 전 흐름 실행
+```
+
+## Philosophy
+
+> 사용자는 "무엇"만 말한다. "어떤 스킬을 어떻게" 는 vibe가 결정한다.
+
+- **단일 슬래시 진입점**: `/vibe` 하나로 모든 워크플로 시작. 다른 `/vibe.*` 도 그대로 존재하지만 power user 가 명시적으로 phase 호출하고 싶을 때 쓰는 advanced 경로.
+- **동적 파이프라인**: 의도/입력 종류에 따라 매번 다른 스킬 체인 구성. 미리 정해진 고정 흐름 아님.
+- **무제한 라우팅**: 라우팅 표는 빠른 경로일 뿐 닫힌 화이트리스트가 아니다. 설치된 모든 `vibe.*` 스킬이 라우팅 후보이며, 표에 없는 요구사항도 description 기반 의미 매칭으로 처리한다 (Catch-all).
+- **하네스 정규화 (추론 앞단)**: vibe는 CC(추론)·Codex(직역) 어느 하네스의 암묵적 동작에도 의존하지 않는다. `/vibe`가 모호한 NL을 **명시적·직역 가능한 지시로 먼저 전개**하고, 하위 skill은 모호한 입력을 받지 않는다. 이로써 모든 하네스에서 동일 결과 + CC급 편의를 제공한다. 전문: `vibe/rules/principles/dual-harness-doctrine.md`.
+- **Smart Resume**: `.vibe/{interviews,plans,specs,features}/` 감지하여 "이어서 진행?" 자동 제안.
+- **1회 승인 게이트**: 파이프라인을 설계해서 사용자에게 보여주고 OK 받은 뒤 실행. `ultrawork` 키워드 있으면 skip.
+- **위임자 역할**: `/vibe` 본인은 코드를 직접 쓰지 않는다. 라우팅·설계·실행 위임만 한다.
+
+## Process
+
+> **⏱️ Timer**: 시작 시 `getCurrentTime` 호출하고 결과를 `{start_time}` 으로 기록한다.
+
+### Phase 0: Input 수집
+
+다음을 모두 파싱한다:
+
+| 입력원 | 처리 |
+|---|---|
+| 자연어 텍스트 | 의도 추출 (요구 종류, 도메인, 키워드) |
+| 첨부 파일 (`📎 path`) | 확장자로 분류 (md/feature/pdf/png/jpg/...) |
+| URL | 도메인으로 분류 (figma.com / github.com / 기타) |
+| 키워드 | `ultrawork`, `ralph`, `quick`, `verify` 등 magic keyword 추출 |
+
+### Phase 1: Intent 분류
+
+입력을 다음 의도 중 하나(또는 복수)로 분류:
+
+| 의도 | 신호 | 기본 파이프라인 |
+|---|---|---|
+| **new feature** | "만들어줘", "추가", 신규 아이디어, 입력 없이 빈 호출 | interview → plan → spec → review → run → verify → contract → trace |
+| **figma-driven UI** | figma.com URL, "디자인", 이미지/PDF + UI 단어 | figma-extract → figma-convert → run → verify |
+| **clone existing UI** | 일반 웹사이트 URL + "비슷한", "클론", "이런 느낌" | clone → run → verify |
+| **resume in-progress** | feature name + `.vibe/specs/{name}.md` 존재 | (resume 지점부터) |
+| **review only** | "리뷰", "검토만", 코드/SPEC 첨부 + "확인" | review |
+| **regression fix** | "회귀", "테스트 깨졌", "다시 통과" | regress → run → verify |
+| **contract drift** | "API 변경", "계약 깨졌", "스펙 불일치" | contract → regress (P1만) |
+| **scaffold** | "프로젝트 만들기", "셋업", "초기 구조" | scaffold |
+| **docs sync** | "문서 갱신", "README", "AGENTS.md" | docs |
+| **analyze** | "분석", "조사", "이건 뭐야" + 파일/URL | analyze |
+| **reason** | "추론", "깊게 생각", "트레이드오프", "어떻게 접근" 등 복잡한 사고 요청 | reason |
+| **event** | "이벤트", "커뮤니티", "D-Day", "행사 자동화" | event |
+| **harness check** | "하네스", "환경 점검" | harness |
+| **test self** | "vibe 테스트", "CC ↔ Codex 비교" | test |
+| **utils** | "이어서", "메모리", "체크포인트" | utils |
+
+복수 의도면 우선순위: resume > figma-driven > new feature > 기타.
+
+> **⚠️ 위 표는 닫힌 화이트리스트가 아니라 "흔한 케이스 빠른 경로"다.** 표에 없는 요구사항이라도 막지 말고 **Catch-all 라우팅**(아래)으로 처리한다.
+
+### Catch-all 라우팅 (표에 없는 의도)
+
+입력이 위 표 어느 행과도 명확히 매칭되지 않으면:
+
+1. **의미 매칭**: 사용 가능한 모든 `vibe.*` 스킬의 `description` 을 읽어 요구사항과 의미적으로 가장 가까운 스킬을 고른다. (표는 참고용일 뿐, 실제 라우팅 후보는 설치된 전체 `vibe.*`)
+2. **복합 설계**: 단일 스킬로 안 되면 여러 스킬을 조합한 파이프라인을 동적으로 설계한다.
+3. **되묻기는 최후**: 어떤 스킬과도 매칭이 안 될 때만 사용자에게 "어떤 작업인지" 명확화 질문을 한다.
+
+> 새 `vibe.*` 스킬이 추가되어 위 표에 행이 없더라도, Catch-all 이 description 기반으로 자동 라우팅하므로 기능이 막히지 않는다. 표 누락 = 기능 제한이 되어선 안 된다.
+
+### Phase 2: Smart Resume 감지
+
+```
+.vibe/.last-feature 존재 → 직전 feature 이름 추출
+.vibe/specs/{feature}/ 또는 .vibe/specs/{feature}.md 존재 → spec 단계 완료
+.vibe/features/{feature}/ 또는 .vibe/features/{feature}.feature 존재 → feature 단계 완료
+.vibe/plans/{feature}.md 존재 → plan 단계 완료
+.vibe/interviews/{feature}.md 존재 → interview 단계 완료
+```
+
+감지된 진행 상태가 있으면 사용자에게 명시:
+
+```
+🔍 진행 중인 작업 감지: "login"
+   ✅ interview · ✅ plan · ✅ spec · ⏳ review
+
+이어서 review 부터 진행할까요? 아니면 새 작업?
+[1] 이어서 review
+[2] 새 작업 (위 요구사항으로)
+[3] 취소
+```
+
+### Phase 3: 파이프라인 설계
+
+**먼저 입력을 정규화한다 (하네스 무관 명시화):**
+
+- **예시·placeholder 표기**: 사용자가 설명용으로 던진 예시 텍스트를 실데이터로 넘기지 않는다. `<예시>`, `[채워넣을 값]` 로 명시. (직역 하네스가 그대로 데이터로 쓰는 것 방지)
+- **research 명시**: 조사가 필요하면 파이프라인에 명시적 탐색 단계를 넣는다. planning mode 같은 하네스 스위치에 의존하지 않는다.
+- **도메인 지식 흡수**: 사용자가 준 라이브러리·함수·파일 위치를 SPEC 입력으로 전달한다.
+
+이어서 분류된 의도 + resume 상태 + magic keyword 를 종합해 실행 계획 작성:
+
+```
+📋 Pipeline Plan
+
+목표: 패럴랙스 웹사이트 신규 개발
+Input: 자연어 ("패럴랙스 웹사이트 만들어줘")
+Resume: 없음 (신규)
+Keywords: 없음
+
+Phase 1: /vibe.spec → interview → plan → spec → review
+Phase 2: /vibe.figma → UI 디자인 트랙 (type=website 감지)
+Phase 3: /vibe.run  → 구현
+Phase 4: /vibe.verify → 검증
+Phase 5: /vibe.contract → API 계약 검증
+Phase 6: /vibe.trace → RTM 출력
+
+예상: 6 phase, 중단 게이트 2회 (interview 후, plan 후)
+```
+
+### Phase 4: 승인 게이트
+
+```
+위 파이프라인으로 진행할까요?
+[1] 진행
+[2] 수정 (어느 phase 빼거나 추가)
+[3] 취소
+```
+
+**Skip 조건:**
+- 입력에 `ultrawork` 또는 `ulw` 키워드 → 자동 진행
+- `ralph` 키워드 → 자동 진행 + 100% 수렴까지 반복
+- `quick` 키워드 → 최소 phase 만 자동 진행 (review/verify/contract/trace skip)
+
+### Phase 5: 체인 실행
+
+승인된 파이프라인을 순차 호출:
+
+```
+호출 형식: SlashCommand({command: "/vibe.{name} <args>"})
+
+예:
+1. SlashCommand({command: "/vibe.spec \"패럴랙스 웹사이트\""})
+2. SlashCommand({command: "/vibe.figma"})
+3. SlashCommand({command: "/vibe.run"})
+...
+```
+
+각 phase 종료 시:
+- 성공 → 다음 phase
+- 실패 → 중단하고 사용자에게 보고 (재시도 / skip / abort 선택)
+- `ultrawork` 모드 → 실패도 TODO로 기록하고 계속 진행 (non-interactive)
+
+### Phase 6: 종료 보고
+
+```
+✅ /vibe 완료
+
+실행 파이프라인:
+  ✅ /vibe.spec   (interview + plan + spec + review)
+  ✅ /vibe.figma  (UI 디자인 트랙)
+  ✅ /vibe.run    (구현)
+  ✅ /vibe.verify (검증 — 9/9 통과)
+  ✅ /vibe.trace  (RTM 100%)
+
+생성물:
+  📄 .vibe/specs/parallax-site.md
+  📄 .vibe/features/parallax-site.feature
+  📁 src/pages/parallax/
+  📄 .vibe/reports/parallax-site-rtm.md
+
+⏱️ 시작: {start_time}
+⏱️ 완료: {getCurrentTime 결과}
+```
+
+## Routing Examples
+
+### 예시 1: 신규 + figma
+
+```
+입력: /vibe "https://www.figma.com/design/abc/login 로 로그인 페이지"
+
+→ Intent: figma-driven UI
+→ Resume: 없음
+→ Pipeline:
+   1. /vibe.figma  (figma-extract + figma-convert)
+   2. /vibe.spec   (생성된 SPEC 자동 보정)
+   3. /vibe.run
+   4. /vibe.verify
+   5. /vibe.trace
+```
+
+### 예시 2: Resume
+
+```
+입력: /vibe "이어서"  (혹은 빈 호출)
+
+→ Resume: .vibe/specs/login/ 발견 (3개 phase 파일)
+→ .vibe/features/login/ 없음
+→ Pipeline:
+   1. /vibe.run (구현부터)
+   2. /vibe.verify
+   3. /vibe.trace
+```
+
+### 예시 3: Review only
+
+```
+입력: /vibe "이 코드 리뷰만" + 📎 src/auth/login.ts
+
+→ Intent: review only
+→ Pipeline:
+   1. /vibe.review (단일 phase)
+```
+
+### 예시 4: ultrawork
+
+```
+입력: /vibe "결제 API 만들어줘" ultrawork
+
+→ Approval gate SKIP
+→ 자동 전 phase 실행
+→ 실패는 TODO 기록만 하고 계속
+```
+
+## ⛔ 하지 않는 것
+
+- 직접 코드 작성 / 파일 수정 (위임만)
+- 파이프라인 미리보기 없이 즉시 실행 (`ultrawork` 외)
+- 사용자가 명시한 phase 를 임의로 추가/제거
+- Resume 상태를 무시하고 처음부터 다시 시작
+
+## Magic Keywords (재정의)
+
+| Keyword | Effect |
+|---|---|
+| `ultrawork` / `ulw` | 승인 게이트 skip + non-interactive |
+| `ralph` | 100% 수렴까지 자동 반복 |
+| `quick` | 최소 phase 만 (review/verify/contract/trace skip) |
+| `verify` | 강한 검증 (verify + contract + trace 강제 포함) |
+
+## Output
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 /vibe Dynamic Dispatcher
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+[Phase 0: Input 분석]
+...
+
+[Phase 1: Intent 분류]
+→ new feature + figma-driven UI
+
+[Phase 2: Resume 감지]
+→ 진행 중인 작업 없음
+
+[Phase 3: 파이프라인 설계]
+...
+
+[Phase 4: 승인 게이트]
+사용자 응답 대기...
+
+[Phase 5: 실행]
+...
+
+[Phase 6: 종료 보고]
+...
+```
+
+---
+
+ARGUMENTS: {자연어 요구사항 + 첨부}

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

@@ -1,6 +1,8 @@
 ---
+name: vibe.analyze
 description: Analyze any target — code, document, website, or Figma design
 argument-hint: "feature-name" or file.pdf or https://... or --code or --deps or --arch
+user-invocable: true
 ---
 
 # /vibe.analyze

package/skills/vibe.clone/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: vibe.clone
+description: URL → 마크업 레벨 픽셀 완벽 클론 — 헤드리스 브라우저로 라이브 사이트 캡처 후 현재 프로젝트 스택에 맞게 스캐폴딩
+argument-hint: "<url> [<url2>...] [--name=<feature>] [--mo-only] [--pc-only] [--ignore-robots]"
+user-invocable: true
+---
+
+# /vibe.clone
+
+URL을 받아 **마크업 수준으로 정밀 복제**하고 현재 프로젝트 스택에 맞춰 컴포넌트/스타일을 스캐폴딩한다.
+
+→ 모든 동작은 **`clone` 스킬**의 규칙을 따른다. 이 커맨드는 라우터일 뿐, 휴리스틱·추정·생략은 금지.
+
+## Usage
+
+```
+/vibe.clone <url>                              # 인터랙티브: MO+PC 양쪽 캡처 (기본)
+/vibe.clone <url> --mo-only                    # 모바일(375×812)만 캡처
+/vibe.clone <url> --pc-only                    # 데스크탑(1440×900)만 캡처
+/vibe.clone <url> --name=stripe-clone          # 기능 이름 지정 (기본: 호스트명 kebab-case)
+/vibe.clone <url1> <url2> <url3>               # 다중 페이지 클론 (같은 사이트의 여러 경로)
+/vibe.clone <url> --ignore-robots              # robots.txt 무시 (사이트 소유자 허가 있을 때만)
+```
+
+## Argument Routing
+
+```
+Step 1) 인자 수집
+  urls         = http(s):// 로 시작하는 모든 인자
+  feature      = --name=<value> | URL host → kebab-case
+  scope        = --mo-only | --pc-only | (기본: both)
+  ignoreRobots = --ignore-robots 플래그 유무
+
+Step 2) 인자 검증
+  urls.length === 0  → 사용자에게 URL 입력 요청, 중단
+  ! /^https?:\/\//.test(url) → "유효한 URL이 아닙니다" 에러, 중단
+
+Step 3) 스킬 진입
+  → clone 스킬 Phase 0부터 순차 실행
+  → URL 다중 입력 시 각 URL마다 별도 feature 디렉토리 (URL path 기반 suffix)
+```
+
+## Execution Plan
+
+`clone` 스킬을 로드한 뒤 다음을 순차 실행한다. **Phase 단계 건너뛰기 금지**.
+
+```
+Phase 0: Setup
+  - .vibe/config.json + package.json → 스택 감지
+  - feature 이름 결정, 디렉토리 생성
+
+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, asset-map.json, assets/
+
+Phase 2: Refine (BP마다 독립)
+  - node {{VIBE_PATH}}/hooks/scripts/clone-refine.js \
+      /tmp/{feature}/{bp}/rendered.html /tmp/{feature}/{bp}/computed.json \
+      --out=/tmp/{feature}/{bp}/sections.json --bp={mo|pc}
+
+Phase 3: Scaffold (BP 순차 — MO 완료 후 PC)
+  - Step A: node {{VIBE_PATH}}/hooks/scripts/clone-to-scss.js \
+      /tmp/{feature}/{bp}/sections.json \
+      --out=./styles/{feature}/ --feature={feature}
+  - Claude: 섹션별로 HTML/컴포넌트 작성 (스택별 .tsx/.vue/.svelte/.html)
+  - Step B: node {{VIBE_PATH}}/hooks/scripts/clone-validate.js \
+      ./styles/{feature}/ /tmp/{feature}/{bp}/sections.json --section={Name}
+  - 섹션마다 PASS 받고 다음 섹션 진행
+
+Phase 4: Compile Gate (clone SKILL.md 규칙)
+Phase 5: Pixel Verification (P1=0까지 루프 — clone SKILL.md 규칙)
+```
+
+## Prerequisites
+
+- **puppeteer**: optional peer dependency. 미설치 시 Phase 1에서 `npm install puppeteer` 안내 후 중단
+- **Chromium**: puppeteer 자동 다운로드 (`npx puppeteer browsers install chrome`)
+- **dev 서버**: Phase 4-5에서 `npm run dev` 호출. 스크립트가 미정의면 사용자에게 명시
+- **robots.txt 준수**: 기본 차단. `--ignore-robots` 는 사이트 소유자/CTF/학습 명시일 때만
+
+## Output Locations
+
+```
+/tmp/{feature}/                  # 작업 디렉토리 (산출물 원본)
+  ├── mo/, pc/                   # rendered.html, computed.json, screenshot.png, sections.json, assets/
+  └── project-tokens.json        # 기존 프로젝트 토큰 인덱스
+
+./components/{feature}/          # Claude가 작성한 컴포넌트 (.tsx/.vue/.svelte/.html)
+./styles/{feature}/              # clone-to-scss.js가 생성한 SCSS 파일
+  ├── _tokens.scss               # CSS 변수
+  ├── _base.scss                 # @font-face
+  ├── _shared.scss               # 유틸
+  ├── sections/_<name>.scss      # 섹션별 partial
+  ├── index.scss                 # 마스터 orchestrator
+  └── class-plan.json            # 노드 id → BEM 클래스
+./public/images/{feature}/       # 다운로드된 이미지/폰트
+```
+
+## Legal Notes
+
+```
+이 커맨드는 다음 용도에만 사용:
+  ✅ 클론 코딩 학습 (마크업/레이아웃 연구)
+  ✅ 본인 소유 사이트 재구축
+  ✅ 명시적 허가 받은 리디자인
+
+금지:
+  ❌ 저작권 콘텐츠(텍스트/이미지/로고) 무단 재게시
+  ❌ 피싱/브랜드 사칭 룩어라이크 사이트
+  ❌ robots.txt 우회 (소유자 허가 없는 --ignore-robots)
+
+Claude 기본 행동:
+  - 저작권 텍스트 → 플레이스홀더("[Lorem ipsum]") 교체
+  - robots.txt 차단 경로 → 명시적 --ignore-robots 없으면 거부
+  - 사용자 의도가 사칭/기만이면 즉시 거부
+```

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

@@ -1,6 +1,8 @@
 ---
+name: vibe.contract
 description: API contract drift detection — extract contracts from SPEC, compare to implementation, fail on drift
 argument-hint: "extract | check | diff [feature-name]"
+user-invocable: true
 ---
 
 # /vibe.contract
@@ -28,7 +30,7 @@ A contract = any **interface shape** that external consumers (clients, other ser
 
 ## Process
 
-Load skill `vibe-contract` with subcommand: `$ARGUMENTS`
+Load skill `contract` with subcommand: `$ARGUMENTS`
 
 **Core steps**:
 

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

@@ -1,6 +1,8 @@
 ---
+name: vibe.docs
 description: Generate project documentation — README, architecture docs, user guide, release notes, agent instructions
 argument-hint: "readme, guide, arch, release, or agent"
+user-invocable: true
 ---
 
 # /vibe.docs
@@ -28,6 +30,6 @@ Generate or update project documentation by analyzing the actual codebase.
 
 ---
 
-Load skill `vibe-docs` — subcommand에 따라 해당 섹션 실행
+Load skill `docs` — subcommand에 따라 해당 섹션 실행
 
 ARGUMENTS: $ARGUMENTS

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

@@ -1,6 +1,8 @@
 ---
+name: vibe.event
 description: Community event automation — D-Day based proactive task execution
 argument-hint: "MDC 12차 3/30" or "webinar AI에이전트 4/15" or "DWK 5차 5/20"
+user-invocable: true
 ---
 
 # /vibe.event

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

@@ -1,6 +1,8 @@
 ---
+name: vibe.figma
 description: Figma ↔ Code 양방향 라우터 — READ(Figma→Code) / WRITE(plan→Figma)
 argument-hint: "[<figma-url>... | <plan.md>] [--new] [--create | --create-storyboard | --create-design] [--teach]"
+user-invocable: true
 ---
 
 # /vibe.figma
@@ -29,7 +31,7 @@ Figma와 코드 사이의 **양방향 라우터**. 인자 조합으로 분기를
 /vibe.figma --teach                                  # 어느 branch든 design-teach를 인터랙티브로 강제
 ```
 
-> **URL 분류는 `vibe-figma` 스킬이 자동 처리합니다** — fileKey가 다른 URL은 스토리보드 vs 디자인으로, ROOT 노드 name의 "MO"/"PC"로 디바이스를 구분합니다. 사용자는 URL 종류를 신경 쓰지 않고 한 번에 던지면 됩니다.
+> **URL 분류는 `figma` 스킬이 자동 처리합니다** — fileKey가 다른 URL은 스토리보드 vs 디자인으로, ROOT 노드 name의 "MO"/"PC"로 디바이스를 구분합니다. 사용자는 URL 종류를 신경 쓰지 않고 한 번에 던지면 됩니다.
 
 ## Branch Routing (필수: 첫 단계에서 결정)
 
@@ -117,13 +119,13 @@ AskUserQuestion 사용 시 절대 선택지(options) 제공 금지. 자유 텍
 
 ```
 1. URL 수집 (스킬 진입 전)
-   - urlArgs.length > 0 → 그대로 vibe-figma 스킬에 전달 (인터랙티브 질문 생략)
-   - urlArgs.length == 0 → vibe-figma 스킬이 인터랙티브로 줄바꿈 입력 받음
+   - urlArgs.length > 0 → 그대로 figma 스킬에 전달 (인터랙티브 질문 생략)
+   - urlArgs.length == 0 → figma 스킬이 인터랙티브로 줄바꿈 입력 받음
    ⚠ URL 분류(storyboard vs design, MO vs PC)는 스킬이 자동 처리 — router는 개입하지 않음
      · fileKey 다름 → storyboard vs design
      · ROOT 노드 name에 "MO"/"PC" → 디바이스 구분
 
-2. Load skill `vibe-figma` — Phase 0 Setup
+2. Load skill `figma` — Phase 0 Setup
    → 스택 감지, 디렉토리, 피처명, component-index.json, project-tokens.json
 
 3. Design context 로드 (non-interactive 기본)
@@ -142,7 +144,7 @@ AskUserQuestion 사용 시 절대 선택지(options) 제공 금지. 자유 텍
 ### Phase 1 — Storyboard 분석 (선택)
 
 ```
-Load skill `vibe-figma` — Phase 1 Storyboard
+Load skill `figma` — Phase 1 Storyboard
 
    Phase 0에서 수집한 URL 중 "storyboard"로 자동 분류된 항목이 있으면 분석.
    없으면 이 Phase는 자동 SKIP (스킬 내부 처리).
@@ -154,8 +156,8 @@ Load skill `vibe-figma` — Phase 1 Storyboard
 ### Phase 2 — 재료 확보
 
 ```
-Load skill `vibe-figma-extract`
-Load skill `vibe-figma` — Phase 2 (코디네이터: MO/PC 병렬 워커)
+Load skill `figma-extract`
+Load skill `figma` — Phase 2 (코디네이터: MO/PC 병렬 워커)
 
    Phase 0에서 수집한 URL 중 "design"으로 자동 분류된 항목 (MO/PC)을 사용.
    → tree.json + bg/ + content/ + sections/ (검증용)
@@ -169,7 +171,7 @@ Load skill `vibe-figma` — Phase 2 (코디네이터: MO/PC 병렬 워커)
 ### Phase 3 — 데이터 정제
 
 ```
-Load skill `vibe-figma` — Phase 3
+Load skill `figma` — Phase 3
    ⛔ figma-refine.js 강제 (자체 정제 스크립트 금지)
    → /tmp/{feature}/{bp}-main/sections.json
 ```
@@ -177,8 +179,8 @@ Load skill `vibe-figma` — Phase 3
 ### Phase 4 — BP별 스태틱 구현 (컨벤션 준수)
 
 ```
-Load skill `vibe-figma-convert`
-Load skill `vibe-figma` — Phase 4
+Load skill `figma-convert`
+Load skill `figma` — Phase 4
 
    재사용 매칭 (BLOCKING):
      ① component-index.json 매칭 → import (새로 만들지 않음)
@@ -195,14 +197,14 @@ Load skill `design-normalize`
 ### Phase 5 — 컴파일 게이트
 
 ```
-Load skill `vibe-figma` — Phase 5
+Load skill `figma` — Phase 5
    → tsc/build/dev 서버. P1=0까지 루프. Stuck → 사용자 질문.
 ```
 
 ### Phase 6 — 시각 검증 + 품질 점검 (MANDATORY)
 
 ```
-Load skill `vibe-figma` — Phase 6 (시각 검증 루프, P1=0까지)
+Load skill `figma` — Phase 6 (시각 검증 루프, P1=0까지)
 
    Raw-vs-computed 재조정:
      - tree.json 각 노드의 `raw` 필드(itemSpacing, padding*, fontSize, lineHeightPx,
@@ -233,7 +235,7 @@ Load skill `design-audit`
 ```
 1. URL 수집 — Branch 1 Phase 0와 동일 (urlArgs 있으면 전달, 없으면 인터랙티브)
 
-2. Load skill `vibe-figma` — Phase 0 Setup
+2. Load skill `figma` — Phase 0 Setup
    → 스택만 감지. 디렉토리 생성.
    ⛔ component-index.json 인덱싱 SKIP
    ⛔ project-tokens.json 스캔 SKIP
@@ -243,15 +245,15 @@ Load skill `design-audit`
 ### Phase 1 — Storyboard 분석 (선택)
 
 ```
-Load skill `vibe-figma` — Phase 1
+Load skill `figma` — Phase 1
    → Branch 1 Phase 1과 동일 (storyboard URL이 있으면 분석, 없으면 SKIP)
 ```
 
 ### Phase 2 — 재료 확보
 
 ```
-Load skill `vibe-figma-extract`
-Load skill `vibe-figma` — Phase 2
+Load skill `figma-extract`
+Load skill `figma` — Phase 2
    → Branch 1 Phase 2와 동일 (design URL로 추출)
 
    🚦 Audit gate: Branch 1과 동일하게 `auditSummary.p1 > 0` 이면 Phase 3 진입 금지.
@@ -260,14 +262,14 @@ Load skill `vibe-figma` — Phase 2
 ### Phase 3 — 데이터 정제
 
 ```
-Load skill `vibe-figma` — Phase 3 (figma-refine.js 강제)
+Load skill `figma` — Phase 3 (figma-refine.js 강제)
 ```
 
 ### Phase 4 — BP별 스태틱 구현 (Standalone 모드)
 
 ```
-Load skill `vibe-figma-convert`
-Load skill `vibe-figma` — Phase 4
+Load skill `figma-convert`
+Load skill `figma` — Phase 4
 
    ⛔ 재사용 매칭 SKIP — 새 컴포넌트 자유 생성
    ✅ 새 토큰 자유 생성 (피처 스코프 네이밍: $feature-color-xxx)
@@ -279,13 +281,13 @@ Load skill `vibe-figma` — Phase 4
 ### Phase 5 — 컴파일 게이트
 
 ```
-Load skill `vibe-figma` — Phase 5
+Load skill `figma` — Phase 5
 ```
 
 ### Phase 6 — 시각 검증 + a11y (MANDATORY)
 
 ```
-Load skill `vibe-figma` — Phase 6 (시각 검증 루프, P1=0까지)
+Load skill `figma` — Phase 6 (시각 검증 루프, P1=0까지)
 
    Raw-vs-computed 재조정: Branch 1과 동일 — tree.json `raw` ↔ getComputedStyle 비교.
 
@@ -309,7 +311,7 @@ Load skill `design-audit`
 
 **출력**: 지정된 Figma 파일 내 새 페이지/프레임/섹션
 
-> **Phase 명명 주의**: Branch 3은 `vibe-figma` 스킬의 Phase 0~6과 충돌을 피하기 위해 **Step A~F**로 표기한다.
+> **Phase 명명 주의**: Branch 3은 `figma` 스킬의 Phase 0~6과 충돌을 피하기 위해 **Step A~F**로 표기한다.
 > **2단계 생성 원칙**: `createMode == full`이면 본 디자인 직진 금지. 반드시 **와이어프레임(Step D) → 사용자 검토 → 본 디자인(Step E)** 순서.
 
 ### createMode별 실행 매트릭스
@@ -595,6 +597,6 @@ Load skill `figma:figma-generate-design` — Step 3+: Assemble Sections (디자
 ```
 ❌ Branch 1 도중 figma:figma-use / figma:figma-generate-design 호출 금지 (READ 모드)
 ❌ Branch 2 도중 design-normalize 호출 금지 (독립 모드)
-❌ Branch 3 도중 vibe-figma-extract / vibe-figma-convert / figma-refine.js 호출 금지 (WRITE 모드)
+❌ Branch 3 도중 figma-extract / figma-convert / figma-refine.js 호출 금지 (WRITE 모드)
 ❌ Branch 결정 후 다른 Branch의 Phase로 점프 금지
 ```

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

@@ -1,6 +1,8 @@
 ---
+name: vibe.harness
 description: Diagnose project Harness Engineering maturity across 6 axes
 argument-hint: (no arguments)
+user-invocable: true
 ---
 
 # /vibe.harness

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

@@ -1,6 +1,8 @@
 ---
+name: vibe.reason
 description: Apply systematic reasoning framework to complex problems
 argument-hint: "problem description"
+user-invocable: true
 ---
 
 # /vibe.reason