@su-record/vibe 2.10.0 → 2.11.0

package/hooks/scripts/llm-orchestrate.js

@@ -112,7 +112,6 @@ function resolveModel(providerName, config) {
  *
  * true인 경우:
  * - vibe-codex: ANTHROPIC_BASE_URL이 localhost (프록시 모드)
- * - coco: ~/.coco/ 존재 또는 COCO_HOME 설정
  * - 명시적: VIBE_SECONDARY_LLM=claude
  */
 function useClaudeAsSecondary() {
@@ -121,10 +120,6 @@ function useClaudeAsSecondary() {
   // 2. vibe-codex 프록시 모드
   const baseUrl = process.env.ANTHROPIC_BASE_URL || '';
   if (baseUrl.includes('localhost') || baseUrl.includes('127.0.0.1')) return true;
-  // 3. coco 환경
-  if (process.env.COCO_HOME) return true;
-  const cocoDir = path.join(os.homedir(), '.coco');
-  if (fs.existsSync(cocoDir)) return true;
   return false;
 }
 
@@ -601,10 +596,10 @@ async function main() {
     // 명시적 claude 호출
     providerChain = ['claude', 'gemini'];
   } else if (isGpt) {
-    // GPT 주관 → claude fallback (vibe-codex/coco), gemini fallback (직접 모드)
+    // GPT 주관 → claude fallback (vibe-codex), gemini fallback (직접 모드)
     providerChain = claudeSecondary ? [provider, 'claude'] : [provider, 'gemini'];
   } else {
-    // gemini 주관 → claude fallback (vibe-codex/coco), gpt fallback (직접 모드)
+    // gemini 주관 → claude fallback (vibe-codex), gpt fallback (직접 모드)
     providerChain = claudeSecondary ? ['gemini', 'claude'] : ['gemini', 'gpt'];
   }
 

package/hooks/scripts/prompt-dispatcher.js

@@ -42,11 +42,11 @@ try {
 
 if (!prompt) process.exit(0);
 
-// 레거시 SSOT 통합 — `/vibe.*` 진입 시 `.claude/vibe/`·`.coco/vibe/` → `.vibe/` 자동 이동.
+// 레거시 SSOT 통합 — `/vibe.*` 진입 시 `.claude/vibe/` → `.vibe/` 자동 이동.
 // `vibe init`/`update` 와 동일한 `consolidateLegacyVibe` (dist/cli/setup/LegacyMigration.js) 를 직접 재사용. Idempotent.
 if (/^\s*\/vibe\b/i.test(prompt)) {
   try {
-    const projectDir = process.env.CLAUDE_PROJECT_DIR || process.env.COCO_PROJECT_DIR || process.cwd();
+    const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
     const utils = await import('./utils.js');
     const CLI_BASE = utils.getCliBaseUrl();
     const { consolidateLegacyVibe } = await import(`${CLI_BASE}setup/LegacyMigration.js`);
@@ -183,7 +183,7 @@ if (!matched) {
   setImmediate(async () => {
     try {
       const utils = await import('./utils.js');
-      const projectDir = process.env.CLAUDE_PROJECT_DIR || process.env.COCO_PROJECT_DIR || '.';
+      const projectDir = process.env.CLAUDE_PROJECT_DIR || '.';
       const configPath = utils.projectVibePath(projectDir, 'config.json');
       let gapEnabled = true;
       try {

package/hooks/scripts/utils.js

@@ -17,7 +17,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const DETECTED_VIBE_PATH = path.resolve(__dirname, '..', '..');
 
 export const VIBE_PATH = process.env.VIBE_PATH || DETECTED_VIBE_PATH;
-export const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.env.COCO_PROJECT_DIR || '.';
+export const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || '.';
 
 // ~/.vibe/ 디렉토리 경로
 const VIBE_HOME_DIR = path.join(os.homedir(), '.vibe');
@@ -25,16 +25,14 @@ const VIBE_HOME_DIR = path.join(os.homedir(), '.vibe');
 /**
  * 프로젝트 내 Vibe 에셋 루트 해석.
  *
- * 신규 SSOT: `<project>/.vibe/` — CLI(Claude/coco)와 무관한 공용 디렉토리.
+ * 신규 SSOT: `<project>/.vibe/` — CLI(Claude/Codex)와 무관한 공용 디렉토리.
  * Legacy fallback:
  *   - `<project>/.claude/vibe/`  (Claude Code 프로젝트 초기화 흔적)
- *   - `<project>/.coco/vibe/`    (coco 프로젝트 초기화 흔적)
  *
  * 해석 규칙 — **읽기**(lookup) 시:
  *   1) `.vibe/` 가 존재하면 그 경로
  *   2) `.claude/vibe/` 가 존재하면 그 경로
- *   3) `.coco/vibe/` 가 존재하면 그 경로
- *   4) 아무것도 없으면 기본값 `.vibe/` (생성 대상)
+ *   3) 아무것도 없으면 기본값 `.vibe/` (생성 대상)
  *
  * **쓰기**(write) 시에는 항상 새 SSOT 인 `.vibe/` 로 수렴시키는 것이 원칙이지만,
  * 기존 프로젝트의 legacy 파일이 있으면 해당 위치에 쓰는 것이 덜 파괴적이다.
@@ -48,8 +46,6 @@ export function projectVibeRoot(projectDir = PROJECT_DIR) {
     if (fs.existsSync(vibeRoot)) return vibeRoot;
     const claudeVibe = path.join(projectDir, '.claude', 'vibe');
     if (fs.existsSync(claudeVibe)) return claudeVibe;
-    const cocoVibe = path.join(projectDir, '.coco', 'vibe');
-    if (fs.existsSync(cocoVibe)) return cocoVibe;
   } catch { /* ignore */ }
   return path.join(projectDir, '.vibe');
 }
@@ -66,14 +62,13 @@ export function projectVibePath(projectDir = PROJECT_DIR, ...sub) {
 
 /**
  * 프로젝트 메모리 DB 디렉토리 해석.
- * `.vibe/memories/` (신규) → `.claude/memories/` (legacy Claude) → `.coco/memories/` (legacy coco) → 기본 `.vibe/memories/`
+ * `.vibe/memories/` (신규) → `.claude/memories/` (legacy Claude) → 기본 `.vibe/memories/`
  */
 export function projectMemoryDir(projectDir = PROJECT_DIR) {
   try {
     const candidates = [
       path.join(projectDir, '.vibe', 'memories'),
       path.join(projectDir, '.claude', 'memories'),
-      path.join(projectDir, '.coco', 'memories'),
     ];
     for (const c of candidates) if (fs.existsSync(c)) return c;
   } catch { /* ignore */ }
@@ -95,7 +90,7 @@ export function readVibeConfig() {
 }
 
 /**
- * 프로젝트 설정(.vibe/config.json) 읽기 — legacy `.claude/vibe/`, `.coco/vibe/` fallback 포함
+ * 프로젝트 설정(.vibe/config.json) 읽기 — legacy `.claude/vibe/` fallback 포함
  * @returns {object} 파싱된 config 또는 빈 객체
  */
 export function readProjectConfig() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@su-record/vibe",
-  "version": "2.10.0",
+  "version": "2.11.0",
   "description": "AI Coding Framework for Claude Code — 56 agents, 45 skills, multi-LLM orchestration",
   "type": "module",
   "main": "dist/cli/index.js",

package/skills/docs/SKILL.md

@@ -106,9 +106,9 @@ graph TD
 | CLI | File | Support |
 |---|---|---|
 | Claude Code | `CLAUDE.md` | 100% (Primary) |
-| coco | `AGENTS.md` | 100% (Primary) |
+| Codex | `AGENTS.md` | 100% (Primary) |
 
-Gemini CLI / Codex CLI / Cursor are not supported — do not generate or check `GEMINI.md`.
+Gemini CLI / Cursor are not supported — do not generate or check `GEMINI.md`.
 
 **Source of truth:**
 - **`CLAUDE.md` is the content SSOT.** Always edit it first; `AGENTS.md` is a regenerated derivative.
@@ -120,7 +120,7 @@ Gemini CLI / Codex CLI / Cursor are not supported — do not generate or check `
 2. **For `AGENTS.md`**:
    - **If missing** → create by cloning `CLAUDE.md` + applying CLI substitution (below).
    - **If exists** → regenerate from current `CLAUDE.md` + substitution, preserving user-specific additions outside the VIBE block.
-3. **CLI substitution for `AGENTS.md`** (coco): `Claude Code` → `coco` · `~/.claude/` → `~/.coco/` · `.claude/` → `.coco/` · `CLAUDE.md` → `AGENTS.md`. `CLAUDE.md` itself gets no substitution.
+3. **CLI substitution for `AGENTS.md`** (Codex): `Claude Code` → `Codex` · `~/.claude/` → `~/.codex/` · `.claude/` → `.codex/` · `CLAUDE.md` → `AGENTS.md`. `CLAUDE.md` itself gets no substitution.
 4. **Validate every touched file (whether newly created or modified)** via the `claude-md-guide` → `agents-md` skill chain — see validation block below. **Never write or save without running this step.**
 5. Report per file: created / updated / skipped / validation warnings.
 

package/skills/test/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: test
-description: vibe 자가검진 본체 — 대상 harness(~/.claude/~/.coco)의 모든 command/skill/hook/agent 프로빙 → pass/fail 리포트 → ~/.vibe/test-reports/.
+description: vibe 자가검진 본체 — 대상 harness(~/.claude/~/.codex)의 모든 command/skill/hook/agent 프로빙 → pass/fail 리포트 → ~/.vibe/test-reports/.
 when_to_use: /vibe.test 진입점에서 체인 호출. 직접 호출 금지.
 user-invocable: false
 tier: core
@@ -12,7 +12,7 @@ Probe every shipped vibe surface in one install dir and emit a pass/fail report.
 
 ## Why this exists
 
-When vibe ships new commands, skills, hooks, or agents, one side (CC or coco) can end up out of sync with the other, frontmatter can drift, and hook tests can silently break. `/vibe.test` is the single mechanical check: does every surface in the target install actually load and pass its own tests?
+When vibe ships new commands, skills, hooks, or agents, one side (CC or Codex) can end up out of sync with the other, frontmatter can drift, and hook tests can silently break. `/vibe.test` is the single mechanical check: does every surface in the target install actually load and pass its own tests?
 
 ## Target harness
 
@@ -20,15 +20,15 @@ The argument selects which install dir to probe:
 
 | Arg | Probed dir |
 |---|---|
-| (empty) | current harness — CC: `~/.claude/`, coco: `~/.coco/` |
+| (empty) | current harness — CC: `~/.claude/`, Codex: `~/.codex/` |
 | `cc` | `~/.claude/` |
-| `coco` | `~/.coco/` |
+| `codex` | `~/.codex/` |
 
 If the target dir does not exist, print a clear message and exit with guidance (not an error). Example:
 
 ```
-~/.coco/ not found — coco isn't installed on this machine.
-  To install: pnpm add -g @su-record/vibe-coco
+~/.codex/ not found — Codex isn't installed on this machine.
+  To install: npm i -g @openai/codex
 ```
 
 ## Probes
@@ -118,8 +118,8 @@ If `failed` is empty, replace the Failures section with `_All probes passed._`.
 
 ## Steps
 
-1. **Resolve target**: argument (`cc` / `coco` / empty). Empty → detect current harness (`$CLAUDE_PROJECT_DIR` set → `cc`; else fall back to `cc`).
-2. **Resolve install dir**: `cc` → `~/.claude`, `coco` → `~/.coco`. If missing → print guidance + exit.
+1. **Resolve target**: argument (`cc` / `codex` / empty). Empty → detect current harness (`$CLAUDE_PROJECT_DIR` set → `cc`; else fall back to `cc`).
+2. **Resolve install dir**: `cc` → `~/.claude`, `codex` → `~/.codex`. If missing → print guidance + exit.
 3. **Read `vibe_version`** from `package.json` in the current repo.
 4. **Walk each category**, run its check, append `{ name, status, error? }` to `probes.<category>`.
 5. **Compute** `summary` counts and the flat `failed[]` list.

package/skills/vibe/SKILL.md

@@ -26,6 +26,8 @@ user-invocable: true
 
 - **단일 슬래시 진입점**: `/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` 본인은 코드를 직접 쓰지 않는다. 라우팅·설계·실행 위임만 한다.
@@ -61,12 +63,26 @@ user-invocable: true
 | **scaffold** | "프로젝트 만들기", "셋업", "초기 구조" | scaffold |
 | **docs sync** | "문서 갱신", "README", "AGENTS.md" | docs |
 | **analyze** | "분석", "조사", "이건 뭐야" + 파일/URL | analyze |
+| **reason** | "추론", "깊게 생각", "트레이드오프", "어떻게 접근" 등 복잡한 사고 요청 | reason |
+| **event** | "이벤트", "커뮤니티", "D-Day", "행사 자동화" | event |
 | **harness check** | "하네스", "환경 점검" | harness |
-| **test self** | "vibe 테스트", "CC ↔ coco 비교" | test |
+| **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 감지
 
 ```
@@ -91,7 +107,13 @@ user-invocable: true
 
 ### Phase 3: 파이프라인 설계
 
-분류된 의도 + resume 상태 + magic keyword 를 종합해 실행 계획 작성:
+**먼저 입력을 정규화한다 (하네스 무관 명시화):**
+
+- **예시·placeholder 표기**: 사용자가 설명용으로 던진 예시 텍스트를 실데이터로 넘기지 않는다. `<예시>`, `[채워넣을 값]` 로 명시. (직역 하네스가 그대로 데이터로 쓰는 것 방지)
+- **research 명시**: 조사가 필요하면 파이프라인에 명시적 탐색 단계를 넣는다. planning mode 같은 하네스 스위치에 의존하지 않는다.
+- **도메인 지식 흡수**: 사용자가 준 라이브러리·함수·파일 위치를 SPEC 입력으로 전달한다.
+
+이어서 분류된 의도 + resume 상태 + magic keyword 를 종합해 실행 계획 작성:
 
 ```
 📋 Pipeline Plan

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) 로 보강