@su-record/vibe 2.9.23 → 2.9.25

package/vibe/ui-ux-data/version.json

@@ -1,31 +1,31 @@
-{
-  "version": "1.0.0",
-  "schema_version": "1",
-  "description": "UI/UX Design Intelligence CSV data for VIBE framework",
-  "files": {
-    "products.csv": ["No", "Product_Type", "Keywords", "Style_Recommendation", "Color_Palette_Type", "Typography_Type", "Layout_Preference", "Dashboard_Style"],
-    "ui-reasoning.csv": ["No", "UI_Category", "Style_Priority", "Color_Mood", "Typography_Mood", "Decision_Rules", "Anti_Patterns", "Severity"],
-    "styles.csv": ["No", "Style Category", "Keywords", "Primary Colors", "Effects", "Best For", "CSS Keywords", "Design System Variables", "Implementation Checklist"],
-    "colors.csv": ["No", "Product Type", "Primary (Hex)", "Secondary (Hex)", "CTA (Hex)", "Background (Hex)", "Text (Hex)", "Border/Divider (Hex)", "Notes"],
-    "typography.csv": ["No", "Font Pairing Name", "Heading Font", "Body Font", "Best For", "Mood", "Google Fonts URL"],
-    "landing.csv": ["No", "Product Type", "Pattern Name", "Section Order", "Primary CTA Placement", "Color Strategy", "Effects", "Conversion Tips"],
-    "charts.csv": ["No", "Chart Type", "Best For", "Data Type", "Library", "Key Config", "Accessibility Notes"],
-    "icons.csv": ["No", "Icon Library", "Style", "Best For", "CDN URL", "React Component", "Size Options"],
-    "react-performance.csv": ["No", "Pattern", "Problem", "Solution", "Impact", "Priority"],
-    "ux-guidelines.csv": ["No", "Category", "Guideline", "Priority", "WCAG Level", "Implementation"],
-    "web-interface.csv": ["No", "Component", "Pattern", "Best Practice", "Anti-Pattern", "Framework Support"],
-    "stacks/nextjs.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/react.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/shadcn.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/html-tailwind.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/svelte.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/vue.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/nuxtjs.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/nuxt-ui.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/astro.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/flutter.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/react-native.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/swiftui.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
-    "stacks/jetpack-compose.csv": ["No", "Category", "Pattern", "Implementation", "Notes"]
-  }
-}
+{
+  "version": "1.0.0",
+  "schema_version": "1",
+  "description": "UI/UX Design Intelligence CSV data for VIBE framework",
+  "files": {
+    "products.csv": ["No", "Product_Type", "Keywords", "Style_Recommendation", "Color_Palette_Type", "Typography_Type", "Layout_Preference", "Dashboard_Style"],
+    "ui-reasoning.csv": ["No", "UI_Category", "Style_Priority", "Color_Mood", "Typography_Mood", "Decision_Rules", "Anti_Patterns", "Severity"],
+    "styles.csv": ["No", "Style Category", "Keywords", "Primary Colors", "Effects", "Best For", "CSS Keywords", "Design System Variables", "Implementation Checklist"],
+    "colors.csv": ["No", "Product Type", "Primary (Hex)", "Secondary (Hex)", "CTA (Hex)", "Background (Hex)", "Text (Hex)", "Border/Divider (Hex)", "Notes"],
+    "typography.csv": ["No", "Font Pairing Name", "Heading Font", "Body Font", "Best For", "Mood", "Google Fonts URL"],
+    "landing.csv": ["No", "Product Type", "Pattern Name", "Section Order", "Primary CTA Placement", "Color Strategy", "Effects", "Conversion Tips"],
+    "charts.csv": ["No", "Chart Type", "Best For", "Data Type", "Library", "Key Config", "Accessibility Notes"],
+    "icons.csv": ["No", "Icon Library", "Style", "Best For", "CDN URL", "React Component", "Size Options"],
+    "react-performance.csv": ["No", "Pattern", "Problem", "Solution", "Impact", "Priority"],
+    "ux-guidelines.csv": ["No", "Category", "Guideline", "Priority", "WCAG Level", "Implementation"],
+    "web-interface.csv": ["No", "Component", "Pattern", "Best Practice", "Anti-Pattern", "Framework Support"],
+    "stacks/nextjs.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/react.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/shadcn.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/html-tailwind.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/svelte.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/vue.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/nuxtjs.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/nuxt-ui.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/astro.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/flutter.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/react-native.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/swiftui.csv": ["No", "Category", "Pattern", "Implementation", "Notes"],
+    "stacks/jetpack-compose.csv": ["No", "Category", "Pattern", "Implementation", "Notes"]
+  }
+}

package/vibe/ui-ux-data/web-interface.csv

@@ -1,31 +1,31 @@
-No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
-1,Accessibility,Icon Button Labels,icon button aria-label,Web,Icon-only buttons must have accessible names,Add aria-label to icon buttons,Icon button without label,"<button aria-label='Close'><XIcon /></button>","<button><XIcon /></button>",Critical
-2,Accessibility,Form Control Labels,form input label aria,Web,All form controls need labels or aria-label,Use label element or aria-label,Input without accessible name,"<label for='email'>Email</label><input id='email' />","<input placeholder='Email' />",Critical
-3,Accessibility,Keyboard Handlers,keyboard onclick onkeydown,Web,Interactive elements must support keyboard interaction,Add onKeyDown alongside onClick,Click-only interaction,"<div onClick={fn} onKeyDown={fn} tabIndex={0}>","<div onClick={fn}>",High
-4,Accessibility,Semantic HTML,semantic button a label,Web,Use semantic HTML before ARIA attributes,Use button/a/label elements,Div with role attribute,"<button onClick={fn}>Submit</button>","<div role='button' onClick={fn}>Submit</div>",High
-5,Accessibility,Aria Live,aria-live polite async,Web,Async updates need aria-live for screen readers,Add aria-live='polite' for dynamic content,Silent async updates,"<div aria-live='polite'>{status}</div>","<div>{status}</div> // no announcement",Medium
-6,Accessibility,Decorative Icons,aria-hidden decorative icon,Web,Decorative icons should be hidden from screen readers,Add aria-hidden='true' to decorative icons,Decorative icon announced,"<Icon aria-hidden='true' />","<Icon /> // announced as 'image'",Medium
-7,Focus,Visible Focus States,focus-visible outline ring,Web,All interactive elements need visible focus states,Use :focus-visible with ring/outline,No focus indication,"focus-visible:ring-2 focus-visible:ring-blue-500","outline-none // no replacement",Critical
-8,Focus,Never Remove Outline,outline-none focus replacement,Web,Never remove outline without providing replacement,Replace outline with visible alternative,Remove outline completely,"focus:outline-none focus:ring-2","focus:outline-none // nothing else",Critical
-9,Focus,Checkbox Radio Hit Target,checkbox radio label target,Web,Checkbox/radio must share hit target with label,Wrap input and label together,Separate tiny checkbox,"<label class='flex gap-2'><input type='checkbox' /><span>Option</span></label>","<input type='checkbox' id='x' /><label for='x'>Option</label>",Medium
-10,Forms,Autocomplete Attribute,autocomplete input form,Web,Inputs need autocomplete attribute for autofill,Add appropriate autocomplete value,Missing autocomplete,"<input autocomplete='email' type='email' />","<input type='email' />",High
-11,Forms,Semantic Input Types,input type email tel url,Web,Use semantic input type attributes,Use email/tel/url/number types,text type for everything,"<input type='email' />","<input type='text' /> // for email",Medium
-12,Forms,Never Block Paste,paste onpaste password,Web,Never prevent paste functionality,Allow paste on all inputs,Block paste on password/code,"<input type='password' />","<input onPaste={e => e.preventDefault()} />",High
-13,Forms,Spellcheck Disable,spellcheck email code,Web,Disable spellcheck on emails and codes,Set spellcheck='false' on codes,Spellcheck on technical input,"<input spellCheck='false' type='email' />","<input type='email' /> // red squiggles",Low
-14,Forms,Submit Button Enabled,submit button disabled loading,Web,Keep submit enabled and show spinner during requests,Show loading spinner keep enabled,Disable button during submit,"<button>{loading ? <Spinner /> : 'Submit'}</button>","<button disabled={loading}>Submit</button>",Medium
-15,Forms,Inline Errors,error message inline focus,Web,Show error messages inline near the problem field,Inline error with focus on first error,Single error at top,"<input /><span class='text-red-500'>{error}</span>","<div class='error'>{allErrors}</div> // at top",High
-16,Performance,Virtualize Lists,virtualize list 50 items,Web,Virtualize lists exceeding 50 items,Use virtual list for large datasets,Render all items,"<VirtualList items={items} />","items.map(item => <Item />)",High
-17,Performance,Avoid Layout Reads,layout read render getboundingclientrect,Web,Avoid layout reads during render phase,Read layout in effects or callbacks,getBoundingClientRect in render,"useEffect(() => { el.getBoundingClientRect() })","const rect = el.getBoundingClientRect() // in render",Medium
-18,Performance,Batch DOM Operations,batch dom write read,Web,Group DOM operations to minimize reflows,Batch writes then reads,Interleave reads and writes,"writes.forEach(w => w()); reads.forEach(r => r())","write(); read(); write(); read(); // thrashing",Medium
-19,Performance,Preconnect CDN,preconnect link cdn,Web,Add preconnect links for CDN domains,Preconnect to known domains,"<link rel='preconnect' href='https://cdn.example.com' />","// no preconnect hint",Low
-20,Performance,Lazy Load Images,lazy loading image below-fold,Web,Lazy-load images below the fold,Use loading='lazy' for below-fold images,Load all images eagerly,"<img loading='lazy' src='...' />","<img src='...' /> // above fold only",Medium
-21,State,URL Reflects State,url state query params,Web,URL should reflect current UI state,Sync filters/tabs/pagination to URL,State only in memory,"?tab=settings&page=2","useState only // lost on refresh",High
-22,State,Deep Linking,deep link stateful component,Web,Stateful components should support deep-linking,Enable sharing current view via URL,No shareable state,"router.push({ query: { ...filters } })","setFilters(f) // not in URL",Medium
-23,State,Confirm Destructive Actions,confirm destructive delete modal,Web,Destructive actions require confirmation,Show confirmation dialog before delete,Delete without confirmation,"if (confirm('Delete?')) delete()","onClick={delete} // no confirmation",High
-24,Typography,Proper Unicode,unicode ellipsis quotes,Web,Use proper Unicode characters,Use ... curly quotes proper dashes,ASCII approximations,"'Hello...' with proper ellipsis","'Hello...' with three dots",Low
-25,Typography,Text Overflow,truncate line-clamp overflow,Web,Handle text overflow properly,Use truncate/line-clamp/break-words,Text overflows container,"<p class='truncate'>Long text...</p>","<p>Long text...</p> // overflows",Medium
-26,Typography,Non-Breaking Spaces,nbsp unit brand,Web,Use non-breaking spaces for units and brand names,Use &nbsp; between number and unit,"10&nbsp;kg or Next.js&nbsp;14","10 kg // may wrap",Low
-27,Anti-Pattern,No Zoom Disable,viewport zoom disable,Web,Never disable zoom in viewport meta,Allow user zoom,"<meta name='viewport' content='width=device-width'>","<meta name='viewport' content='maximum-scale=1'>",Critical
-28,Anti-Pattern,No Transition All,transition all specific,Web,Avoid transition: all - specify properties,Transition specific properties,transition: all,"transition-colors duration-200","transition-all duration-200",Medium
-29,Anti-Pattern,Outline Replacement,outline-none ring focus,Web,Never use outline-none without replacement,Provide visible focus replacement,Remove outline with nothing,"focus:outline-none focus:ring-2 focus:ring-blue-500","focus:outline-none // alone",Critical
-30,Anti-Pattern,No Hardcoded Dates,date format intl locale,Web,Use Intl for date/number formatting,Use Intl.DateTimeFormat,Hardcoded date format,"new Intl.DateTimeFormat('en').format(date)","date.toLocaleDateString() // or manual format",Medium
+No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
+1,Accessibility,Icon Button Labels,icon button aria-label,Web,Icon-only buttons must have accessible names,Add aria-label to icon buttons,Icon button without label,"<button aria-label='Close'><XIcon /></button>","<button><XIcon /></button>",Critical
+2,Accessibility,Form Control Labels,form input label aria,Web,All form controls need labels or aria-label,Use label element or aria-label,Input without accessible name,"<label for='email'>Email</label><input id='email' />","<input placeholder='Email' />",Critical
+3,Accessibility,Keyboard Handlers,keyboard onclick onkeydown,Web,Interactive elements must support keyboard interaction,Add onKeyDown alongside onClick,Click-only interaction,"<div onClick={fn} onKeyDown={fn} tabIndex={0}>","<div onClick={fn}>",High
+4,Accessibility,Semantic HTML,semantic button a label,Web,Use semantic HTML before ARIA attributes,Use button/a/label elements,Div with role attribute,"<button onClick={fn}>Submit</button>","<div role='button' onClick={fn}>Submit</div>",High
+5,Accessibility,Aria Live,aria-live polite async,Web,Async updates need aria-live for screen readers,Add aria-live='polite' for dynamic content,Silent async updates,"<div aria-live='polite'>{status}</div>","<div>{status}</div> // no announcement",Medium
+6,Accessibility,Decorative Icons,aria-hidden decorative icon,Web,Decorative icons should be hidden from screen readers,Add aria-hidden='true' to decorative icons,Decorative icon announced,"<Icon aria-hidden='true' />","<Icon /> // announced as 'image'",Medium
+7,Focus,Visible Focus States,focus-visible outline ring,Web,All interactive elements need visible focus states,Use :focus-visible with ring/outline,No focus indication,"focus-visible:ring-2 focus-visible:ring-blue-500","outline-none // no replacement",Critical
+8,Focus,Never Remove Outline,outline-none focus replacement,Web,Never remove outline without providing replacement,Replace outline with visible alternative,Remove outline completely,"focus:outline-none focus:ring-2","focus:outline-none // nothing else",Critical
+9,Focus,Checkbox Radio Hit Target,checkbox radio label target,Web,Checkbox/radio must share hit target with label,Wrap input and label together,Separate tiny checkbox,"<label class='flex gap-2'><input type='checkbox' /><span>Option</span></label>","<input type='checkbox' id='x' /><label for='x'>Option</label>",Medium
+10,Forms,Autocomplete Attribute,autocomplete input form,Web,Inputs need autocomplete attribute for autofill,Add appropriate autocomplete value,Missing autocomplete,"<input autocomplete='email' type='email' />","<input type='email' />",High
+11,Forms,Semantic Input Types,input type email tel url,Web,Use semantic input type attributes,Use email/tel/url/number types,text type for everything,"<input type='email' />","<input type='text' /> // for email",Medium
+12,Forms,Never Block Paste,paste onpaste password,Web,Never prevent paste functionality,Allow paste on all inputs,Block paste on password/code,"<input type='password' />","<input onPaste={e => e.preventDefault()} />",High
+13,Forms,Spellcheck Disable,spellcheck email code,Web,Disable spellcheck on emails and codes,Set spellcheck='false' on codes,Spellcheck on technical input,"<input spellCheck='false' type='email' />","<input type='email' /> // red squiggles",Low
+14,Forms,Submit Button Enabled,submit button disabled loading,Web,Keep submit enabled and show spinner during requests,Show loading spinner keep enabled,Disable button during submit,"<button>{loading ? <Spinner /> : 'Submit'}</button>","<button disabled={loading}>Submit</button>",Medium
+15,Forms,Inline Errors,error message inline focus,Web,Show error messages inline near the problem field,Inline error with focus on first error,Single error at top,"<input /><span class='text-red-500'>{error}</span>","<div class='error'>{allErrors}</div> // at top",High
+16,Performance,Virtualize Lists,virtualize list 50 items,Web,Virtualize lists exceeding 50 items,Use virtual list for large datasets,Render all items,"<VirtualList items={items} />","items.map(item => <Item />)",High
+17,Performance,Avoid Layout Reads,layout read render getboundingclientrect,Web,Avoid layout reads during render phase,Read layout in effects or callbacks,getBoundingClientRect in render,"useEffect(() => { el.getBoundingClientRect() })","const rect = el.getBoundingClientRect() // in render",Medium
+18,Performance,Batch DOM Operations,batch dom write read,Web,Group DOM operations to minimize reflows,Batch writes then reads,Interleave reads and writes,"writes.forEach(w => w()); reads.forEach(r => r())","write(); read(); write(); read(); // thrashing",Medium
+19,Performance,Preconnect CDN,preconnect link cdn,Web,Add preconnect links for CDN domains,Preconnect to known domains,"<link rel='preconnect' href='https://cdn.example.com' />","// no preconnect hint",Low
+20,Performance,Lazy Load Images,lazy loading image below-fold,Web,Lazy-load images below the fold,Use loading='lazy' for below-fold images,Load all images eagerly,"<img loading='lazy' src='...' />","<img src='...' /> // above fold only",Medium
+21,State,URL Reflects State,url state query params,Web,URL should reflect current UI state,Sync filters/tabs/pagination to URL,State only in memory,"?tab=settings&page=2","useState only // lost on refresh",High
+22,State,Deep Linking,deep link stateful component,Web,Stateful components should support deep-linking,Enable sharing current view via URL,No shareable state,"router.push({ query: { ...filters } })","setFilters(f) // not in URL",Medium
+23,State,Confirm Destructive Actions,confirm destructive delete modal,Web,Destructive actions require confirmation,Show confirmation dialog before delete,Delete without confirmation,"if (confirm('Delete?')) delete()","onClick={delete} // no confirmation",High
+24,Typography,Proper Unicode,unicode ellipsis quotes,Web,Use proper Unicode characters,Use ... curly quotes proper dashes,ASCII approximations,"'Hello...' with proper ellipsis","'Hello...' with three dots",Low
+25,Typography,Text Overflow,truncate line-clamp overflow,Web,Handle text overflow properly,Use truncate/line-clamp/break-words,Text overflows container,"<p class='truncate'>Long text...</p>","<p>Long text...</p> // overflows",Medium
+26,Typography,Non-Breaking Spaces,nbsp unit brand,Web,Use non-breaking spaces for units and brand names,Use &nbsp; between number and unit,"10&nbsp;kg or Next.js&nbsp;14","10 kg // may wrap",Low
+27,Anti-Pattern,No Zoom Disable,viewport zoom disable,Web,Never disable zoom in viewport meta,Allow user zoom,"<meta name='viewport' content='width=device-width'>","<meta name='viewport' content='maximum-scale=1'>",Critical
+28,Anti-Pattern,No Transition All,transition all specific,Web,Avoid transition: all - specify properties,Transition specific properties,transition: all,"transition-colors duration-200","transition-all duration-200",Medium
+29,Anti-Pattern,Outline Replacement,outline-none ring focus,Web,Never use outline-none without replacement,Provide visible focus replacement,Remove outline with nothing,"focus:outline-none focus:ring-2 focus:ring-blue-500","focus:outline-none // alone",Critical
+30,Anti-Pattern,No Hardcoded Dates,date format intl locale,Web,Use Intl for date/number formatting,Use Intl.DateTimeFormat,Hardcoded date format,"new Intl.DateTimeFormat('en').format(date)","date.toLocaleDateString() // or manual format",Medium

package/README.ko.md

@@ -1,171 +0,0 @@
-# VIBE
-
-**바이브 코딩은 쉽게. 최소 품질은 보장.**
-
-[![npm](https://img.shields.io/npm/v/@su-record/vibe)](https://www.npmjs.com/package/@su-record/vibe)
-[![npm downloads](https://img.shields.io/npm/dt/@su-record/vibe.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@su-record/vibe)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D18-green)](https://nodejs.org/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
-
-Vibe는 AI 코딩 도구를 위한 품질 하네스입니다. Claude Code, Codex, Cursor, Gemini CLI를 감싸고, 타입 안전성, 코드 품질, 보안을 자동으로 강제합니다. 빠르게 바이브 코딩하되, 엉망인 코드가 나가지 않게.
-
-```bash
-npm install -g @su-record/vibe
-vibe init
-```
-
----
-
-## 워크플로우
-
-진입점 하나. 나머지는 자동.
-
-```
-/vibe.spec "커피 브랜드 랜딩 페이지"
-     |
-     v
-  인터뷰    ─── "타깃은 누구?" "어떤 섹션?" "다크 모드?" ───
-     |                   (사용자가 "그만"할 때까지 반복)
-     v
-  기획서    ─── 구조화된 마크다운 기획서 (.claude/vibe/plans/)
-     |
-     v
-  SPEC     ─── PTCF 명세 + BDD 피처, GPT+Gemini 병렬 리서치
-     |
-     v
-  리뷰     ─── Race Review (GPT vs Gemini), 품질 게이트 (100점, 수렴까지 루프)
-     |
-     +──────────────────────────────┐
-     v                              v
-  /vibe.run (로직)             /vibe.figma (UI)
-  SPEC 기반 구현               Figma 디자인 ↔ 코드
-  12개 에이전트 리뷰            읽기 또는 쓰기
-     |                              |
-     v                              v
-  /vibe.verify ──── /vibe.trace ──── 완료
-```
-
-**Smart Resume** — 아무 단계에서나 멈추고, 세션을 닫고, 나중에 돌아오세요. `/vibe.spec`이 중단된 위치를 자동 감지하고 이어서 진행합니다. feature 이름을 외울 필요 없음.
-
-**ultrawork** — 어느 명령이든 `ultrawork`를 붙이면 모든 확인 게이트를 건너뛰고 전체 파이프라인을 자동 실행합니다.
-
----
-
-## 빠른 시작
-
-```bash
-# 설치
-npm install -g @su-record/vibe
-
-# 프로젝트 초기화 (스택 자동 감지)
-cd your-project
-vibe init
-
-# AI 코딩 도구 시작
-claude
-
-# 워크플로우 실행
-/vibe.spec "사용자 인증 추가"
-```
-
----
-
-## Figma ↔ 코드
-
-양방향. Figma에서 디자인을 읽거나, 기획서에서 Figma에 디자인을 쓰거나.
-
-```bash
-# READ — 기존 프로젝트에 UI 추가 (프로젝트 컨벤션 준수)
-/vibe.figma <figma-url> <figma-url>
-
-# READ — 신규 독립 페이지 (독립 스타일)
-/vibe.figma --new <figma-url>
-
-# WRITE — 기획서에서 Figma 디자인 생성
-/vibe.figma plan.md --create                 # Full (와이어 + 비주얼 디자인)
-/vibe.figma plan.md --create-storyboard      # 와이어만
-/vibe.figma plan.md --create-design          # 비주얼 디자인만
-```
-
-**READ 동작**: Figma REST API로 노드 트리 + 30개 CSS 속성 추출. Auto Layout → Flexbox 1:1 기계적 매핑. 스크린샷은 검증용 — 트리가 원천.
-
-**WRITE 동작**: 기획서의 Look & Feel, 레이아웃, 반응형 전략 섹션을 파싱하여 와이어프레임을 먼저 그리고 (구조 검토), 그 위에 디자인 시스템 컴포넌트로 비주얼 적용. 멱등성 보장 — 기획서 수정 후 재실행하면 변경된 섹션만 갱신.
-
----
-
-## 품질 게이트
-
-모든 도구 호출마다 3계층 방어:
-
-| 계층 | 차단 대상 |
-|------|----------|
-| Pre-commit 훅 | `any` 타입, `@ts-ignore`, `console.log`, 50줄 초과 함수 |
-| 리뷰 에이전트 | 12개 전문 리뷰어 병렬 실행 (보안, 성능, 접근성, 복잡도, ...) |
-| 수렴 루프 | 리뷰 findings P1=0까지 루프. 라운드 캡 없음. Stuck이면 사용자에게 질문, 절대 조용히 넘어가지 않음. |
-
----
-
-## 주요 기능
-
-**40+ 에이전트** — 탐색, 구현, 아키텍처, 병렬 코드 리뷰, UI/UX 분석, 보안 감사, Figma 분석/빌드.
-
-**44개 스킬** — 한 번에 다 로드되지 않음. 3-tier 시스템으로 컨텍스트 과부하 방지:
-
-| 티어 | 로드 시점 | 용도 | 예시 |
-|------|----------|------|------|
-| **Core** | 항상 활성 | 버그 방지, 워크플로 진입 | 품질 게이트, 인터뷰, 기획 |
-| **Standard** | `vibe init`이 스택별 선택 | 스택/역할 지원 | figma, design-audit, techdebt |
-| **Optional** | 명시적 `/skill` 호출만 | 레퍼런스, 래퍼 | chub-usage, context7 |
-
-**멀티 LLM** — Claude가 오케스트레이션, GPT가 추론, Gemini가 리서치. 가용 모델에 따라 자동 라우팅. 기본값은 Claude 단독. coco 환경(GPT 주관)에서는 Claude CLI가 보조로 전환되어 cross-validation 수행 — `~/.coco/` 감지로 역할 자동 역전.
-
-**스택 감지** — 24개 프레임워크 자동 감지 (Next.js, Django, Rails, Go, Rust, Flutter 등) 후 프레임워크별 규칙과 스킬 적용.
-
-**세션 메모리** — 결정, 제약, 목표가 SQLite + FTS5 검색으로 세션 간 유지.
-
-**Smart Resume** — `.last-feature` 포인터가 마지막 작업을 추적. 인자 없이 `/vibe.spec`을 호출하면 중단된 위치를 보여주거나 진행 중 feature 목록을 제시.
-
----
-
-## 지원 도구
-
-| CLI | 상태 |
-|-----|------|
-| [Claude Code](https://claude.ai/code) | 전체 지원 |
-| coco (`~/.coco/`) | 전체 지원 (자동 감지) |
-| [Codex](https://github.com/openai/codex) | 플러그인 |
-| [Cursor](https://cursor.sh) | 에이전트 + 룰 |
-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | 에이전트 + 스킬 |
-
----
-
-## 명령어
-
-| 명령어 | 용도 |
-|--------|------|
-| `/vibe.spec` | 단일 진입점 — 인터뷰, 기획, SPEC, 리뷰, 그리고 구현까지 |
-| `/vibe.run` | SPEC 기반 구현 |
-| `/vibe.figma` | Figma ↔ 코드 (읽기 또는 쓰기, 3가지 모드) |
-| `/vibe.verify` | 구현이 SPEC에 맞는지 검증 |
-| `/vibe.trace` | 요구사항 추적 매트릭스 |
-
----
-
-## 문서
-
-상세 가이드, 스킬 레퍼런스, 설정 방법은 [Wiki](https://github.com/su-record/vibe/wiki)를 참고하세요.
-
-- [README (English)](README.md)
-- [릴리스 노트](RELEASE_NOTES.md)
-
----
-
-## 요구사항
-
-- Node.js >= 18.0.0
-- Claude Code (필수)
-- GPT, Gemini (선택)
-
-## 라이선스
-
-MIT — Copyright (c) 2025 Su