@su-record/vibe 2.10.2 → 2.12.1

package/skills/spec-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: spec-review
-description: SPEC 품질 리뷰 본체 — GPT/Gemini 크로스 검증, 100-point gate, Race Review(수렴 종료), Codex 적대 리뷰, 사용자 체크포인트.
+description: SPEC 품질 리뷰 본체 — GPT/Antigravity 크로스 검증, 100-point gate, Race Review(수렴 종료), Codex 적대 리뷰, 사용자 체크포인트.
 when_to_use: spec 완료 후 또는 /vibe.spec Phase 4에서 체인. 직접 호출 금지.
 user-invocable: false
 tier: core
@@ -8,7 +8,7 @@ tier: core
 
 # spec-review — SPEC Quality Review
 
-Review and enhance SPEC with GPT/Gemini cross-validation.
+Review and enhance SPEC with GPT/Antigravity cross-validation.
 
 **Purpose:** Run this skill after `spec` to ensure accurate review execution. For large contexts, invoke in a new session.
 
@@ -38,7 +38,7 @@ Or via natural language trigger: "스펙 리뷰", "review spec", "명세 리뷰"
 > CODEX_AVAILABLE=$(node "{{VIBE_PATH}}/hooks/scripts/codex-detect.js" 2>/dev/null || echo "unavailable")
 > ```
 >
-> If `available`, `/codex:adversarial-review` is automatically invoked. If `unavailable`, falls back to the existing GPT+Gemini workflow.
+> If `available`, `/codex:adversarial-review` is automatically invoked. If `unavailable`, falls back to the existing GPT+Antigravity workflow.
 
 ---
 
@@ -56,7 +56,7 @@ If the value is already the same, no-op.
 ```
 /vibe.spec "feature" → SPEC created (Phase 3)
         ↓
-Phase 4: spec-review skill (this) → Quality validation + GPT/Gemini review
+Phase 4: spec-review skill (this) → Quality validation + GPT/Antigravity review
         ↓
     /vibe.run "feature"
 ```
@@ -246,7 +246,7 @@ Re-evaluating...
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Score: 100/100 ✅ PASSED
 
-✅ Quality Gate PASSED - proceeding to GPT/Gemini review
+✅ Quality Gate PASSED - proceeding to GPT/Antigravity review
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -285,7 +285,7 @@ How would you like to proceed?
 
 ---
 
-## Step 3: Race Review (GPT + Gemini Cross-Validation) - Convergence-Based (No Round Cap)
+## Step 3: Race Review (GPT + Antigravity Cross-Validation) - Convergence-Based (No Round Cap)
 
 **RULES FOR RACE REVIEW:**
 
@@ -294,7 +294,7 @@ How would you like to proceed?
 3. Run rounds sequentially (each round uses updated SPEC)
 4. **No hard round cap** — loop until P1=0 AND no new findings (convergence)
 
-> Race Mode reviews SPEC with GPT and Gemini in parallel, then cross-validates findings for higher confidence. The loop continues until quality converges naturally.
+> Race Mode reviews SPEC with GPT and Antigravity in parallel, then cross-validates findings for higher confidence. The loop continues until quality converges naturally.
 
 ### Termination Rules
 
@@ -318,7 +318,7 @@ When the same findings repeat across rounds, the auto-apply loop has hit a wall.
 
 Same findings repeated from Round {N-1}. Auto-applier cannot resolve:
 
-| # | Issue | Severity | GPT | Gemini | Reason it's stuck |
+| # | Issue | Severity | GPT | Antigravity | Reason it's stuck |
 |---|-------|----------|-----|--------|-------------------|
 | 1 | {issue title} | P1 | ✅ | ✅ | {e.g., "fix requires domain decision"} |
 | 2 | {issue title} | P2 | ✅ | ❌ | {e.g., "conflicts with existing constraint"} |
@@ -371,7 +371,7 @@ To prevent LLM cosmetic noise from causing infinite loops while still reaching 1
 
 ### 3.1 Review Loop (No Round Cap)
 
-**Run GPT + Gemini in PARALLEL via Bash tool for each round. Stop when termination rules trigger.**
+**Run GPT + Antigravity in PARALLEL via Bash tool for each round. Stop when termination rules trigger.**
 
 **🚨 IMPORTANT: SPEC content is too large for CLI arguments. Use --input file method (no pipe needed).**
 
@@ -388,7 +388,7 @@ To prevent LLM cosmetic noise from causing infinite loops while still reaching 1
 **Step B: Script path:**
 - `[LLM_SCRIPT]` = `{{VIBE_PATH}}/hooks/scripts/llm-orchestrate.js`
 
-**Step C: Run GPT + Gemini in PARALLEL (two separate Bash tool calls at once):**
+**Step C: Run GPT + Antigravity in PARALLEL (two separate Bash tool calls at once):**
 
 ```bash
 # GPT review (Bash tool call 1)
@@ -396,16 +396,16 @@ node "[LLM_SCRIPT]" gpt orchestrate-json --input "[SCRATCHPAD]/spec-review-input
 ```
 
 ```bash
-# Gemini review (Bash tool call 2 - run in parallel with GPT)
-node "[LLM_SCRIPT]" gemini orchestrate-json --input "[SCRATCHPAD]/spec-review-input.json"
+# Antigravity review (Bash tool call 2 - run in parallel with GPT)
+node "[LLM_SCRIPT]" antigravity orchestrate-json --input "[SCRATCHPAD]/spec-review-input.json"
 ```
 
 **🚨 MANDATORY: Replace `[SCRATCHPAD]` with the actual scratchpad directory path.**
 **🚨 Replace `[N]` with the current round number (1, 2, 3, ...).**
 **🚨 Replace `[LLM_SCRIPT]` with the resolved absolute path from Step B.**
-**🚨 Run GPT and Gemini calls in PARALLEL (two separate Bash tool calls at once).**
+**🚨 Run GPT and Antigravity calls in PARALLEL (two separate Bash tool calls at once).**
 
-- Round 1: Write SPEC → Run GPT + Gemini in parallel (full scope) → Cross-validate → Apply fixes → Update SPEC file
+- Round 1: Write SPEC → Run GPT + Antigravity in parallel (full scope) → Cross-validate → Apply fixes → Update SPEC file
 - Round 2: Write updated SPEC → Run (P1+P2 scope) → Cross-validate → Apply fixes → Update SPEC file
 - Round 3+: Write updated SPEC → Run (P1-only scope) → Cross-validate → Apply fixes → Continue until P1=0 AND no new findings (or convergence detected)
 
@@ -438,7 +438,7 @@ Key changes found across {N} review rounds:
 
 | # | Change | Source | Confidence |
 |---|--------|--------|------------|
-| 1 | {change1} | GPT+Gemini | 100% |
+| 1 | {change1} | GPT+Antigravity | 100% |
 | 2 | {change2} | GPT only | 50% |
 | ... | ... | ... | ... |
 
@@ -469,10 +469,10 @@ Model Results:
 | Model  | Issues | Duration |
 |--------|--------|----------|
 | GPT    | 2      | 1823ms   |
-| Gemini | 2      | 2156ms   |
+| Antigravity | 2      | 2156ms   |
 
 Cross-Validated Issues:
-| Issue                    | GPT | Gemini | Codex | Confidence |
+| Issue                    | GPT | Antigravity | Codex | Confidence |
 |--------------------------|-----|--------|-------|------------|
 | Missing retry logic      | ✅  | ✅     | ✅    | 100% → P1  |
 | Missing rate limiting    | ✅  | ✅     | ✅    | 100% → P1  |
@@ -491,7 +491,7 @@ Auto-applying...
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Cross-Validated Issues:
-| Issue                       | GPT | Gemini | Codex | Confidence |
+| Issue                       | GPT | Antigravity | Codex | Confidence |
 |-----------------------------|-----|--------|-------|------------|
 | Concurrent session unclear  | ✅  | ❌     | ❌    | 50% → P2   |
 
@@ -517,14 +517,14 @@ Cross-Validated Issues: None
 ### Step 3.1: Codex Adversarial Review (When Codex Plugin Is Active)
 
 > **Activation condition**: Automatically runs when Codex plugin is installed. Skipped if not installed.
-> Runs **simultaneously** with GPT+Gemini Race Review for triple cross-validation.
+> Runs **simultaneously** with GPT+Antigravity Race Review for triple cross-validation.
 
 Codex adversarial review **challenges the design decisions** in the SPEC:
 - Validates whether an alternative architecture would be better
 - Checks for over-engineering or under-engineering
 - Identifies missing edge cases and non-functional requirements
 
-**Execution (parallel with GPT+Gemini Race):**
+**Execution (parallel with GPT+Antigravity Race):**
 
 ```
 /codex:adversarial-review
@@ -533,7 +533,7 @@ Codex adversarial review **challenges the design decisions** in the SPEC:
 **Result integration**: Add Codex column to the Race Review cross-validation table:
 
 ```markdown
-| Issue | GPT | Gemini | Codex | Confidence |
+| Issue | GPT | Antigravity | Codex | Confidence |
 |-------|-----|--------|-------|------------|
 | {issue} | ✅/❌ | ✅/❌ | ✅/❌ | {%} |
 ```
@@ -693,9 +693,9 @@ Expected (split):  .vibe/features/{feature-name}/_index.feature
 Please run /vibe.spec "{feature-name}" first to create the Feature file.
 ```
 
-### GPT/Gemini Call Failed
+### GPT/Antigravity Call Failed
 ```
-⚠️ WARNING: {GPT|Gemini} call failed
+⚠️ WARNING: {GPT|Antigravity} call failed
 
 Error: {error message}
 

package/skills/tool-fallback/SKILL.md

@@ -87,8 +87,8 @@ Request → Check circuit
 
 | Task Type | Primary → Secondary → Fallback |
 |-----------|-------------------------------|
-| architecture, debugging | GPT → Gemini → Claude |
-| uiux, code-analysis | Gemini → GPT → Claude |
+| architecture, debugging | GPT → Antigravity → Claude |
+| uiux, code-analysis | Antigravity → GPT → Claude |
 | code-gen, general | Claude only |
 
 ## Principles

package/skills/tool-fallback/rubrics/fallback-chain.md

@@ -23,8 +23,8 @@
 
 | Task Type | Primary | Secondary | Fallback |
 |-----------|---------|-----------|----------|
-| Architecture, debugging | GPT | Gemini | Claude direct |
-| UI/UX, code analysis | Gemini | GPT | Claude direct |
+| Architecture, debugging | GPT | Antigravity | Claude direct |
+| UI/UX, code analysis | Antigravity | GPT | Claude direct |
 | Code generation, general | Claude | — | — |
 
 **On 429 / rate limit**: skip to secondary immediately — no retry on rate-limited primary.

package/skills/vibe.design/SKILL.md

@@ -0,0 +1,183 @@
+---
+name: vibe.design
+description: DESIGN.md(시각 품질 SSOT) 생성·검증·드리프트 검사·동기화. Figma 독립.
+argument-hint: "init [--from=interview|code|reference|figma] | lint | verify | sync"
+user-invocable: true
+---
+
+# /vibe.design
+
+**vibe 의 세 번째 SSOT — 시각 품질 계약 문서(`DESIGN.md`)** 의 라이프사이클을 전담한다.
+
+> `CLAUDE.md`(코드) · `AGENTS.md`(빌드) 에 이은 시각 규약. **Figma 에 종속되지 않는다** — Figma 는 4 가지 입력 소스 중 하나.
+
+## Usage
+
+```
+/vibe.design init                       # 인터뷰 (디폴트)
+/vibe.design init --from=interview      # 대화형 9 섹션 작성
+/vibe.design init --from=code           # 기존 코드 토큰 역추출
+/vibe.design init --from=reference --reference=linear   # awesome-design-md 시드 선택
+/vibe.design init --from=figma --file=<key>             # /vibe.figma 위임 (옵션)
+/vibe.design lint                       # Stitch 9 섹션 완전성 검증
+/vibe.design verify [--files=<glob>]    # 구현 ↔ DESIGN.md hex 드리프트 (v1)
+/vibe.design sync                       # Figma 연결 시 양방향 동기화 (Should, Phase 2)
+```
+
+## Philosophy
+
+- **Figma 독립**: 모든 서브커맨드는 Figma 없이 동작. Figma 연결 시에만 sync 활성.
+- **권유 > 강제**: DESIGN.md 부재 = 안내 메시지 1 회. `/vibe.run` · `/vibe.verify` 는 막지 않는다.
+- **Stitch 9 섹션 표준**: 외부 에이전트 호환 (Google Stitch, awesome-design-md 생태계).
+- **버전 frontmatter**: `<!-- design-md-version: 1 -->` 로 미래 호환.
+- **루트 배치**: `CLAUDE.md` · `AGENTS.md` 와 동일하게 프로젝트 루트.
+
+## Process
+
+> **⏱️ Timer**: 시작 시 `getCurrentTime` 호출, `{start_time}` 으로 기록.
+
+### Subcommand: `init`
+
+**진입 조건**: 프로젝트 루트에 `DESIGN.md` 없음 (있으면 덮어쓰기 확인).
+
+**경로 결정**:
+
+| `--from` | 동작 |
+|---------|------|
+| 미지정 / `interview` | 대화형 9 섹션 인터뷰 (디폴트) |
+| `code` | 기존 코드에서 토큰 역추출 → 인터뷰 보강 |
+| `reference` | `--reference=<slug>` 로 시드 카탈로그 선택 → §1·§2·§3 시드 + §4–§9 단축 인터뷰 |
+| `figma` | `/vibe.figma --emit-design-md` 위임 (Figma MCP 필요) |
+
+**공통 출력**:
+- 위치: `<프로젝트 루트>/DESIGN.md`
+- 첫 줄: `<!-- design-md-version: 1 -->`
+- 9 H2 섹션 (Visual Theme / Color Palette / Typography / Components / Layout / Depth / Do's & Don'ts / Responsive / Agent Prompt Guide)
+- 템플릿: `templates/DESIGN.md.template`
+
+#### `--from=interview` 흐름
+
+1. 사용자가 9 섹션을 순차 답변 (브랜드 톤, 컬러, 폰트, 컴포넌트 스타일, 그리드, 그림자/뎁스, 금기, 브레이크포인트, 에이전트 가이드)
+2. 빈 섹션은 템플릿 기본값(주석) 으로 채움
+3. `DESIGN.md` 저장 + `lint` 자동 실행 → P1 없으면 성공
+
+#### `--from=code` 흐름
+
+1. `.vibe/config.json` 의 `stacks[].type` 으로 추출기 결정 (`heuristics/code-extract.md`)
+2. v1 필수 패턴: **Tailwind config / CSS custom properties / styled-components theme**
+3. 추출된 토큰을 §2·§3·§4 시드로 사용
+4. 나머지 6 섹션은 단축 인터뷰 (≤3 질문) 또는 템플릿 기본값
+
+#### `--from=reference` 흐름
+
+1. `references/README.md` 시드 카탈로그에서 `--reference=<slug>` 매칭 (`linear`, `vercel`, `stripe` …)
+2. 시드의 `style-preset` 한 줄 (예: `"minimal, neutral grays + electric purple accent, Inter Display"`) 로 §1·§2·§3 기본값 채움
+3. §4–§9 는 단축 인터뷰 (≤3 질문)
+4. 네트워크 차단 환경에서도 동작 (시드는 로컬 시드)
+
+#### `--from=figma` 흐름
+
+1. `/vibe.figma --emit-design-md --file=<key>` 호출 (위임)
+2. 산출물(`DESIGN.md`) 받아서 lint 통과 확인
+
+### Subcommand: `lint`
+
+**입력**: 프로젝트 루트 `DESIGN.md`
+
+**체크**:
+- 9 섹션 모두 존재 (`lintMissingSections` from `design-md-parser.ts`)
+- frontmatter 버전 주석 존재
+- §2 (Color Palette) 에 최소 1 개 hex 토큰
+- §9 (Agent Prompt Guide) 비어있지 않음
+
+**출력**:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ DESIGN.md lint PASS
+   9 sections, 12 color tokens, version 1
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+또는:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+❌ DESIGN.md lint FAIL (P1: 2)
+   Missing: Typography, Responsive
+   → Run /vibe.design init to regenerate, or edit DESIGN.md
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**성능 목표**: <200ms (100 줄 DESIGN.md 기준).
+
+### Subcommand: `verify`
+
+**입력**:
+- 프로젝트 루트 `DESIGN.md` (없으면 안내 후 종료)
+- `--files=<glob>` (기본: 최근 변경 파일 — `/vibe.verify` 의 changed-files 정책 따름)
+
+**체크 (v1 범위)**:
+- `extractHexTokens(DESIGN.md)` → 허용 토큰 셋
+- `findHardcodedColors(files, allowed)` → 허용 셋 밖 hex = P1 후보
+
+**v1 비범위** (Phase 2+):
+- spacing / font-family 드리프트
+- HSL/RGB/named color
+- Tailwind arbitrary value `bg-[#xxxxxx]`
+
+**출력**:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ DESIGN.md verify PASS (32 files scanned)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+또는:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+❌ DESIGN.md verify FAIL (P1: 3 hex drifts)
+   src/Button.tsx:42  #FF5733 not in DESIGN.md tokens
+   src/Card.tsx:18    #123456 not in DESIGN.md tokens
+   src/Nav.tsx:7      #ABCDEF not in DESIGN.md tokens
+   → Add to DESIGN.md §2 Color Palette, or replace with token
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**성능 목표**: <1s / 100 파일.
+
+### Subcommand: `sync` (Should, Phase 2)
+
+**진입 조건**: `~/.vibe/config.json#figma.token` 존재 + `--file=<key>` 또는 프로젝트에 figma 연결 메타.
+
+**v1 동작**: "Phase 2 에서 활성됩니다. 현재는 `/vibe.figma --emit-design-md` 를 사용하세요." 메시지 후 종료.
+
+## Integration
+
+| Skill | 통합 지점 |
+|------|---------|
+| `/vibe.run` | UI 스택 진입 시 `DESIGN.md` 없으면 `### DESIGN.md Gate` 에서 권유 (ultrawork 시 silent skip) |
+| `/vibe.verify` | `### 3.2 Visual Drift Detection` 에서 `vibe.design verify` 호출 — P1 → fail |
+| `/vibe.review` | `### Phase 2.5 Visual P1 Baseline` 에서 DESIGN.md 우선, 없으면 WCAG AA 폴백 |
+| `/vibe.figma` | WRITE 는 DESIGN.md 읽어 톤·팔레트 우선, READ 는 `--emit-design-md` 플래그로 출력 |
+
+## Figma Credential Handling (init/sync only)
+
+- 토큰 출처: `~/.vibe/config.json#figma.token` (chmod 0o600)
+- 메모리 외 노출 금지. 로그에는 마지막 4 자만 노출 (`****abc1`)
+- `--from=figma` · `sync` 외 서브커맨드는 토큰 읽지 않음
+
+## Output
+
+| 파일 | 생성/수정 |
+|-----|---------|
+| `<root>/DESIGN.md` | `init` / `sync` |
+| 콘솔 리포트 | `lint` / `verify` |
+
+## Heuristics & References
+
+- 코드 역추출 패턴: `heuristics/code-extract.md`
+- 시드 카탈로그: `references/README.md`
+- 템플릿: `templates/DESIGN.md.template`
+
+ARGUMENTS: $ARGUMENTS

package/skills/vibe.design/heuristics/code-extract.md

@@ -0,0 +1,100 @@
+# vibe.design — Code Extract Heuristics
+
+`/vibe.design init --from=code` 가 기존 코드에서 시각 토큰을 역추출할 때 따르는 패턴.
+
+## v1 Required Patterns
+
+v1 에서 **반드시 동작**해야 하는 추출기 (테스트 픽스처 보장):
+
+### 1. Tailwind config
+
+대상: `tailwind.config.{ts,js,cjs,mjs}` · `tailwind.config.*` · `app.config.ts` (Nuxt)
+
+```ts
+// tailwind.config.ts
+export default {
+  theme: {
+    extend: {
+      colors: {
+        primary: '#5E6AD2',
+        accent: '#10B981',
+      },
+      fontFamily: {
+        sans: ['Inter', 'system-ui'],
+      },
+      spacing: { '18': '4.5rem' },
+    },
+  },
+};
+```
+
+추출 결과:
+- `§2 Color Palette` ← `theme.extend.colors.*`
+- `§3 Typography` ← `theme.extend.fontFamily.*`
+- `§5 Layout spacing scale` ← `theme.extend.spacing.*`
+
+### 2. CSS custom properties (CSS variables)
+
+대상: `**/*.css` · `**/*.scss` 의 `:root { --... }`
+
+```css
+:root {
+  --color-primary: #5E6AD2;
+  --color-bg: #FFFFFF;
+  --font-sans: 'Inter', sans-serif;
+  --space-md: 16px;
+}
+```
+
+추출 결과:
+- `--color-*` → `§2 Color Palette` (semantic 이름 유지)
+- `--font-*` → `§3 Typography`
+- `--space-*` · `--size-*` → `§5 Layout`
+- `--shadow-*` · `--elevation-*` → `§6 Depth`
+
+### 3. styled-components theme
+
+대상: `**/theme.{ts,tsx,js}` · `ThemeProvider` 의 `theme={...}`
+
+```ts
+export const theme = {
+  colors: { primary: '#5E6AD2', bg: '#FFFFFF' },
+  typography: { fontFamily: 'Inter, sans-serif' },
+  spacing: [4, 8, 16, 24, 32],
+};
+```
+
+추출 결과: 위 CSS-vars 와 동일 매핑.
+
+## Documented-only Patterns (v1 비범위, Phase 2+)
+
+문서로만 정리. 실제 추출기는 Phase 2 에서 구현.
+
+| 패턴 | 위치 | Phase 2 계획 |
+|-----|------|------------|
+| PostCSS custom properties | `postcss.config.*` + `@custom-media` | Tailwind 추출기 확장 |
+| SCSS variables | `**/*.scss` 의 `$variable` | CSS-vars 추출기 확장 |
+| Emotion theme | `@emotion/react` ThemeProvider | styled-components 추출기 확장 |
+| Vanilla Extract | `*.css.ts` `createTheme` | 신규 추출기 |
+| Panda CSS / Linaria | `panda.config.ts` / `*.linaria.ts` | 신규 추출기 |
+| Flutter ThemeData | `theme.dart` | 모바일 트랙 (Phase 3) |
+| iOS asset catalog | `*.xcassets/Colors.xcassets` | 모바일 트랙 (Phase 3) |
+| Android styles.xml | `res/values/colors.xml` | 모바일 트랙 (Phase 3) |
+
+## Stack 매핑
+
+`.vibe/config.json#stacks[].type` 으로 추출기 선택:
+
+| Stack | v1 활성 추출기 |
+|------|--------------|
+| `typescript-react` / `typescript-nextjs` | Tailwind + CSS-vars + styled-components |
+| `typescript-vue` / `typescript-nuxt` | Tailwind + CSS-vars |
+| `typescript-svelte` / `typescript-astro` | Tailwind + CSS-vars |
+| `typescript-angular` | CSS-vars (Tailwind 옵션) |
+| `typescript-react-native` | styled-components (Theme 객체) |
+| `dart-flutter` · `swift-ios` · `kotlin-android` | (Phase 3 — 문서만) |
+
+## Fallback
+
+추출 실패 또는 토큰 0 개 → 인터뷰 모드로 자동 폴백 (`--from=interview` 처럼 동작).
+사용자에게 한 줄 안내: "코드에서 토큰을 찾지 못해 인터뷰로 전환합니다."

package/skills/vibe.design/references/README.md

@@ -0,0 +1,39 @@
+# vibe.design — Reference Seeds
+
+`awesome-design-md` 생태계에서 추출한 **로컬 시드 카탈로그**. 네트워크 없이도
+`/vibe.design init --from=reference --reference=<slug>` 으로 §1·§2·§3 기본값을 시드한다.
+
+각 시드의 `style-preset` 컬럼은 한 문장으로 시각 무드를 요약하며, init 시 §1 Visual
+Theme + §2 Color Palette 의 primary/accent + §3 Typography family 의 기본값으로 변환된다.
+나머지 §4–§9 는 단축 인터뷰(≤3 질문) 로 채운다.
+
+## Catalog
+
+| Slug | Style Preset | 주된 무드 |
+|------|--------------|----------|
+| `linear` | minimal, neutral grays + electric purple accent (#5E6AD2), Inter Display | 도구·정확·조용 |
+| `vercel` | mono-light, pure black/white + zinc neutrals, Geist Sans | 미니멀·기술 |
+| `stripe` | clean white + indigo accent (#635BFF), Sohne / Inter | 신뢰·전문 |
+| `notion` | warm off-white (#FBFBFA) + charcoal text, system serif + sans | 따뜻·문서 |
+| `github` | crisp white/dark + GitHub blue (#0969DA), system-ui | 개발자·정보밀도 |
+| `apple` | premium white + space gray, SF Pro / system | 프리미엄·여백 |
+| `figma` | dark canvas + multi-color accents, Inter | 창의·툴링 |
+| `tailwind` | white + sky/cyan accent (#06B6D4), Inter | 유틸·교육 |
+| `posthog` | playful peach + dark navy, Matter SQ | 친근·실험 |
+| `supabase` | dark + emerald accent (#3ECF8E), Custom Sans | 모던·DB |
+| `arc` | iridescent gradients + soft pastels, Inter Display | 미래·브라우저 |
+| `clerk` | white + purple/violet accent, Inter | 인증·SaaS |
+
+## Adding a new seed
+
+1. 카탈로그 표에 한 줄 추가 (slug · style-preset · 무드)
+2. `style-preset` 은 한 문장: `<intensity>, <palette>, <font family>`
+3. 라이선스: 시드는 시각 규약 텍스트만 보유 (브랜드 로고/이미지 미포함)
+
+## How `init --from=reference` uses these
+
+1. `--reference=<slug>` 매칭 → `style-preset` 추출
+2. `style-preset` 의 palette 토큰 → `DESIGN.md §2 Color Palette` 의 primary/accent 시드
+3. font family → `§3 Typography` 의 Family 시드
+4. intensity 문구 → `§1 Visual Theme` 의 한 문단 초안
+5. `§4–§9` 는 단축 인터뷰 (컴포넌트 radius, spacing scale, breakpoints) 로 보강

package/skills/vibe.design/templates/DESIGN.md.template

@@ -0,0 +1,100 @@
+<!-- design-md-version: 1 -->
+<!-- generated-by: vibe.design -->
+<!-- format: Google Stitch 9-section standard -->
+
+# DESIGN.md — Visual Quality SSOT
+
+> 이 문서는 프로젝트의 시각 규약 단일 출처(SSOT)입니다.
+> `CLAUDE.md`(코드) · `AGENTS.md`(빌드) 와 동급으로 외부 AI 에이전트가 직접 읽습니다.
+> 수정 시 `/vibe.design lint` 로 9 섹션 완전성을 검증하세요.
+
+## Visual Theme
+
+> §1 — 브랜드 톤 한 문단 (분위기, 무드, 핵심 정서).
+
+예시: "Minimal · neutral grays + single accent · 도구처럼 정확하고 조용한 인상."
+
+## Color Palette
+
+> §2 — hex 토큰 리스트 (이 섹션의 hex 만 verify 통과). semantic 이름 우선.
+
+- Primary: `#000000`
+- Background: `#FFFFFF`
+- Text: `#1A1A1A`
+- Border: `#E5E5E5`
+- Accent: `#5E6AD2`
+- Success: `#10B981`
+- Warning: `#F59E0B`
+- Error: `#EF4444`
+
+## Typography
+
+> §3 — 폰트 패밀리, 사이즈 스케일, 행간/자간.
+
+- Family: `"Inter", -apple-system, system-ui, sans-serif`
+- Display: 48 / 56 (weight 600)
+- H1: 32 / 40 (weight 600)
+- H2: 24 / 32 (weight 600)
+- Body: 16 / 24 (weight 400)
+- Caption: 14 / 20 (weight 400)
+- Code: `"JetBrains Mono", monospace`
+
+## Components
+
+> §4 — 공용 컴포넌트의 시각 규약 (Button / Input / Card / Modal …).
+
+- **Button**: radius 8px, padding 12px 20px, transition 150ms ease
+- **Input**: radius 6px, border 1px solid Border, focus ring 2px Accent
+- **Card**: radius 12px, padding 24px, background Background, border 1px solid Border
+- **Modal**: max-width 480px, backdrop blur 8px, radius 16px
+
+## Layout
+
+> §5 — 그리드, 간격 스케일, 컨테이너 최대폭.
+
+- Spacing scale: `4 / 8 / 12 / 16 / 24 / 32 / 48 / 64 / 96`
+- Container max-width: 1200px
+- Section vertical rhythm: 96px (desktop) / 64px (mobile)
+- Grid: 12-col, gutter 24px
+
+## Depth
+
+> §6 — 그림자, elevation, z-index 계층.
+
+- elevation-0: none (flat)
+- elevation-1: `0 1px 2px rgba(0,0,0,0.05)`
+- elevation-2: `0 4px 8px rgba(0,0,0,0.08)`
+- elevation-3: `0 12px 24px rgba(0,0,0,0.12)`
+- z-index: base 0, dropdown 10, modal 100, toast 1000
+
+## Do's & Don'ts
+
+> §7 — 금기와 권장 사항 (visual P1 의 시드).
+
+**DO**
+- 색은 §2 Color Palette 의 토큰만 사용
+- 모든 인터랙티브 요소에 focus ring (2px Accent)
+- spacing 은 §5 scale 에서만 선택
+
+**DON'T**
+- hex 하드코딩 (`bg: #FF0000` 금지 — 토큰으로 §2 에 등록)
+- 임의 그림자값 (반드시 §6 elevation 사용)
+- 폰트 패밀리 임시 변경
+
+## Responsive
+
+> §8 — 브레이크포인트와 적응 규칙.
+
+- Breakpoints: `sm: 640px`, `md: 768px`, `lg: 1024px`, `xl: 1280px`, `2xl: 1536px`
+- Mobile-first 작성, `min-width` 미디어쿼리만 사용
+- Section vertical rhythm: 96px (lg+) / 64px (sm/md)
+- Touch target 최소 44×44px (mobile)
+
+## Agent Prompt Guide
+
+> §9 — UI 코드 생성 AI 에이전트를 위한 한 문단 가이드.
+
+"UI 코드를 생성/수정할 때 §2 Color Palette · §3 Typography · §5 Layout spacing scale 의 토큰만 사용한다.
+hex 하드코딩 시 §2 에 토큰을 추가하거나 기존 토큰으로 치환한다.
+신규 컴포넌트는 §4 의 radius · padding 규칙을 따른다.
+브레이크포인트는 §8 만 사용한다."

package/skills/vibe.event/SKILL.md

@@ -147,7 +147,7 @@ python output/serve.py
 # - Timeline view with D-Day progress
 # - Generate buttons per step
 # - File preview links
-# - API status (Gemini/Aligo key validity)
+# - API status (Antigravity/Aligo key validity)
 # - Dark theme with community color coding
 ```
 

package/skills/vibe.figma/SKILL.md

@@ -45,6 +45,8 @@ Step 1) 플래그 수집
   hasNew              = args에 "--new" 포함
   hasTeach            = args에 "--teach" 포함
   hasNewState         = args에 "--new-state" 포함 (Branch 3 전용: state 파일 무시하고 새로 그림)
+  hasEmitDesignMd     = args에 "--emit-design-md" 포함 (Branch 1/2 전용: READ 완료 후 DESIGN.md 출력)
+  hasReadDesignMd     = 프로젝트 루트에 DESIGN.md 존재 (Branch 3 전용: WRITE 시 톤·팔레트 우선 입력)
 
 Step 2) 위치 인자 분류
   positional  = 모든 비-플래그 인자
@@ -218,6 +220,12 @@ Load skill `design-audit`
    → 5-dimension 점검 (a11y, performance, responsive, theming, AI slop)
    → P1 finding은 review 큐에 기록 (read-only)
 
+⤵ Phase 6.5 (hasEmitDesignMd == true 시)
+   → resolved tokens (Color/Typography/Spacing) + design-audit 산출물을
+     DESIGN.md (Stitch 9 섹션) 으로 정제해 프로젝트 루트에 저장
+   → 첫 줄: `<!-- design-md-version: 1 -->`
+   → `vibe.design lint` 자동 통과 확인
+
 ⛔ Phase 6 + design-audit 완료 전까지 "완료 요약" 출력 금지.
 ```
 
@@ -295,6 +303,11 @@ Load skill `figma` — Phase 6 (시각 검증 루프, P1=0까지)
 Load skill `design-audit`
    → a11y는 항상 검증. 컨벤션 무시 모드여도 접근성은 양보 불가.
 
+⤵ Phase 6.5 (hasEmitDesignMd == true 시)
+   → resolved tokens + design-audit 산출물을
+     DESIGN.md (Stitch 9 섹션) 으로 정제해 프로젝트 루트에 저장
+   → 첫 줄: `<!-- design-md-version: 1 -->`
+
 ⛔ Phase 6 + design-audit 완료 전까지 "완료 요약" 출력 금지.
 ```
 
@@ -353,8 +366,11 @@ Load skill `design-audit`
    ✅ 피처명 결정: mdArg 파일명에서 .md 제거한 값을 {feature}로 사용
 
 2. Design context 로드 (non-interactive 기본)
+   - hasReadDesignMd == true (프로젝트 루트에 DESIGN.md 존재):
+     · §1 Visual Theme / §2 Color Palette / §3 Typography 를 톤·팔레트의
+       **1 차 입력**으로 사용 (`design-context.json` · plan.md 보다 우선)
    - Read .vibe/design-context.json
-     · 존재 → 톤/팔레트 보강용으로 binding
+     · 존재 → 톤/팔레트 보강용으로 binding (DESIGN.md 가 있으면 보조)
      · 없음 → plan.md의 "## 7. Look & Feel" 값으로 임시 컨텍스트 구성
    - hasTeach == true 인 경우에만 Load skill `design-teach`로 인터랙티브 보강