@su-record/vibe 3.0.0 → 3.2.0

package/skills/vibe.figma/SKILL.md

@@ -120,26 +120,11 @@ AskUserQuestion 사용 시 절대 선택지(options) 제공 금지. 자유 텍
 ### Phase 0 — Setup + URL 수집 + Project Context
 
 ```
-1. URL 수집 (스킬 진입 전)
-   - 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 `figma` — Phase 0 Setup
    → 스택 감지, 디렉토리, 피처명, component-index.json, project-tokens.json
 
-3. Design context 로드 (non-interactive 기본)
-   ⛔ design-teach 스킬을 자동으로 로드하지 말 것 (인터랙티브라 흐름이 끊김)
+> Read `references/branch-phases.md` for URL pre-collection rules and the design-context loading algorithm (Phase 0, Branch 1).
 
-   알고리즘:
-     - Read .vibe/design-context.json
-     - 존재 → 메모리에 binding 후 계속
-     - 없음 → 다음 한 줄만 출력하고 계속:
-         "💡 design-context.json 없음 — 기본값으로 진행합니다.
-          톤/팔레트/타이포 가이드를 적용하려면 /design-teach 또는
-          /vibe.figma --teach 로 다시 실행하세요."
      - hasTeach == true → 이때만 Load skill `design-teach`로 인터랙티브 진입
 ```
 
@@ -147,28 +132,19 @@ AskUserQuestion 사용 시 절대 선택지(options) 제공 금지. 자유 텍
 
 ```
 Load skill `figma` — Phase 1 Storyboard
-
-   Phase 0에서 수집한 URL 중 "storyboard"로 자동 분류된 항목이 있으면 분석.
-   없으면 이 Phase는 자동 SKIP (스킬 내부 처리).
-
-   → 섹션 목록 + 기능 정의 + TypeScript 인터페이스 초안
-   ❌ 코드 파일 생성 금지
 ```
 
+> Read `references/branch-phases.md` for the storyboard auto-detect/auto-skip rule and output scope (Branch 1, Phase 1).
+
 ### Phase 2 — 재료 확보
 
 ```
 Load skill `figma` — Phase 2 Extract Mode (코디네이터: MO/PC 병렬 워커)
-
-   Phase 0에서 수집한 URL 중 "design"으로 자동 분류된 항목 (MO/PC)을 사용.
    → tree.json + bg/ + content/ + sections/ (검증용)
-
-   🚦 Audit gate (tree.json 루트 `auditSummary` 사용):
-     - `auditSummary.p1 > 0` → Phase 3 진입 금지. 각 항목을 해결(디자인 레이어 교체,
-       근사치 수용 승인, 알려진 편차로 기록) 후 재추출.
-     - P2 항목은 피처 노트에 기록 → Phase 6 리뷰 대상.
 ```
 
+> Read `references/branch-phases.md` for the input-selection detail and the Audit gate rule (tree.json `auditSummary`, P1/P2 handling).
+
 ### Phase 3 — 데이터 정제
 
 ```
@@ -182,18 +158,14 @@ Load skill `figma` — Phase 3
 ```
 Load skill `figma` — Phase 4 Convert Mode
 
-   재사용 매칭 (BLOCKING):
-     ① component-index.json 매칭 → import (새로 만들지 않음)
-     ② project-tokens.json 매칭 → @use (새 토큰 생성 최소화)
-
-   ⛔ figma-to-scss.js 강제 / figma-validate.js PASS 없이 다음 섹션 금지
-
 ⤵ Phase 4 후처리
 Load skill `design-refine` — normalize 모드
    → 매칭 안 된 하드코딩 값 → MASTER.md 토큰으로 정렬
    → 새 토큰 필요 항목은 review 큐에 기록
 ```
 
+> Read `references/branch-phases.md` for the reuse-matching (BLOCKING) rule and the figma-to-scss/figma-validate gate.
+
 ### Phase 5 — 컴파일 게이트
 
 ```
@@ -206,27 +178,16 @@ Load skill `figma` — Phase 5
 ```
 Load skill `figma` — Phase 6 (시각 검증 루프, P1=0까지)
 
-   Raw-vs-computed 재조정:
-     - tree.json 각 노드의 `raw` 필드(itemSpacing, padding*, fontSize, lineHeightPx,
-       letterSpacing, strokeWeight, cornerRadius 등 Figma 원본 수치)를
-       브라우저 `getComputedStyle`과 비교한다.
-     - 허용 오차 초과 시 P1 issue (gap/padding 0.5px, fontSize 0.25px, lineHeight 0.5px).
-     - Figma MCP/변환기가 삼킨 값이 여기서 드러난다.
-
 ⤵ Phase 6 후처리
 Load skill `design-review` — 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-review(audit) 산출물을
-     DESIGN.md (Stitch 9 섹션) 으로 정제해 프로젝트 루트에 저장
-   → 첫 줄: `<!-- design-md-version: 1 -->`
-   → `vibe.design lint` 자동 통과 확인
-
 ⛔ Phase 6 + design-review(audit) 완료 전까지 "완료 요약" 출력 금지.
 ```
 
+> Read `references/branch-phases.md` for the raw-vs-computed reconciliation detail and Phase 6.5 DESIGN.md emission steps.
+
 ---
 
 ## Branch 2: `/vibe.figma --new` — READ + 독립 규격
@@ -239,15 +200,11 @@ Load skill `design-review` — audit 모드
 ### Phase 0 — Setup (Lite) + URL 수집
 
 ```
-1. URL 수집 — Branch 1 Phase 0와 동일 (urlArgs 있으면 전달, 없으면 인터랙티브)
-
 2. Load skill `figma` — Phase 0 Setup
-   → 스택만 감지. 디렉토리 생성.
-   ⛔ component-index.json 인덱싱 SKIP
-   ⛔ project-tokens.json 스캔 SKIP
-   (재사용 매칭을 강제하지 않으므로 인덱스 불필요)
 ```
 
+> Read `references/branch-phases.md` for the URL-reuse note and the Phase 0 (Lite) skip list (component-index/project-tokens).
+
 ### Phase 1 — Storyboard 분석 (선택)
 
 ```
@@ -274,14 +231,10 @@ Load skill `figma` — Phase 3 (figma-refine.js 강제)
 
 ```
 Load skill `figma` — Phase 4 Convert Mode
-
-   ⛔ 재사용 매칭 SKIP — 새 컴포넌트 자유 생성
-   ✅ 새 토큰 자유 생성 (피처 스코프 네이밍: $feature-color-xxx)
-   ✅ figma-to-scss.js / figma-validate.js는 그대로 강제
-
-   ❌ design-refine(normalize) 호출 금지 (이 Branch는 토큰 alignment 대상이 아님)
 ```
 
+> Read `references/branch-phases.md` for the Standalone-mode reuse/token rules (Branch 2, Phase 4).
+
 ### Phase 5 — 컴파일 게이트
 
 ```
@@ -293,20 +246,15 @@ Load skill `figma` — Phase 5
 ```
 Load skill `figma` — Phase 6 (시각 검증 루프, P1=0까지)
 
-   Raw-vs-computed 재조정: Branch 1과 동일 — tree.json `raw` ↔ getComputedStyle 비교.
-
 ⤵ Phase 6 후처리
 Load skill `design-review` — audit 모드
    → a11y는 항상 검증. 컨벤션 무시 모드여도 접근성은 양보 불가.
 
-⤵ Phase 6.5 (hasEmitDesignMd == true 시)
-   → resolved tokens + design-review(audit) 산출물을
-     DESIGN.md (Stitch 9 섹션) 으로 정제해 프로젝트 루트에 저장
-   → 첫 줄: `<!-- design-md-version: 1 -->`
-
 ⛔ Phase 6 + design-review(audit) 완료 전까지 "완료 요약" 출력 금지.
 ```
 
+> Read `references/branch-phases.md` for the raw-vs-computed note and Phase 6.5 DESIGN.md emission steps (Branch 2).
+
 ---
 
 ## Branch 3: `/vibe.figma <plan.md> --create*` — WRITE (plan.md → Figma)
@@ -325,49 +273,13 @@ Load skill `design-review` — audit 모드
 
 ### createMode별 실행 매트릭스
 
-| Step | full | storyboard | design |
-|---|---|---|---|
-| A. plan.md 파싱 | ✅ | ✅ | ✅ |
-| B. target file + state 로드 | ✅ | ✅ | ✅ |
-| C. 디자인 시스템 발견 | ✅ | ⛔ SKIP (와이어는 컴포넌트 불필요) | ✅ |
-| D. 와이어프레임 생성 | ✅ | ✅ | ⛔ SKIP |
-| 🚪 Step D ↔ E 검토 게이트 | ✅ | ⛔ (Step E 없음) | ⛔ (Step D 없음) |
-| E. 본 디자인 적용 | ✅ | ⛔ SKIP | ✅ (분기 동작, 아래 참조) |
-| F. 시각 검증 | ✅ (full) | ✅ (wire 대상, 구조 체크만) | ✅ (design 대상) |
-
-**`createMode == design`의 Step E 동작 (결함 없는 실행을 위한 분기)**:
-
-- state.sections 가 **완전히 비어있음** (hasNewState 또는 첫 실행)
-  → 각 섹션별로 새 frame 생성 후 **곧바로** 컴포넌트 배치 (와이어 placeholder 단계 통째로 생략)
-  → 이 경로에서는 wireNodeId == designNodeId 가 됨 (같은 노드, 한 번에 완성)
-- state.sections 에 **일부 섹션의 wireNodeId 가 존재**
-  → 존재하는 섹션: 기존 wireNodeId 위에 덮어쓰기 (full 모드의 E와 동일)
-  → 없는 섹션: ❌ reject "이 섹션({섹션명})은 와이어가 없습니다.
-                      `--create-storyboard` 로 먼저 와이어를 만들거나, `--create` (full)로 호출하세요.
-                      빈 state에서 처음부터 design 모드로 그리려면 `--new-state` 를 추가하세요."
+> Read `references/step-algorithms.md` for the full per-Step createMode matrix (A–F × full/storyboard/design) and the `design` mode Step E branching summary.
 
 ### Step A — plan.md 파싱 + 디자인 컨텍스트
 
-```
-1. Read {mdArg}
-   필수 추출 섹션:
-     - "## 1. 개요" → 페이지 이름/목적
-     - "## 7. Look & Feel" → 분위기, 컬러, 타이포, 레퍼런스, 인터랙션
-     - "## 8. 레이아웃/섹션 구성" → 섹션 순서, 목적, 핵심 콘텐츠
-     - "## 9. 반응형 전략" → 디바이스 우선순위, 브레이크포인트
-
-   ⛔ 위 섹션 중 7/8 누락 시: 사용자에게 "plan.md에 UI 섹션이 비어있습니다.
-      /vibe.spec를 먼저 돌려 기획서를 보강할까요?" 라고 묻고 중단.
+> Read `references/step-algorithms.md` for the full plan.md required-section extraction list, missing-section rejection message, feature-name rule, and design-context priority resolution.
 
-   ✅ 피처명 결정: 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 (DESIGN.md 가 있으면 보조)
-     · 없음 → plan.md의 "## 7. Look & Feel" 값으로 임시 컨텍스트 구성
+```
    - hasTeach == true 인 경우에만 Load skill `design-teach`로 인터랙티브 보강
 
 3. Load skill `ui-ux-pro-max`
@@ -377,53 +289,9 @@ Load skill `design-review` — audit 모드
 
 ### Step B — Figma 타겟 파일 + State 로드 + Plugin 규칙
 
-```
-1. AskUserQuestion (자유 텍스트):
-   "디자인을 생성할 target Figma 파일 URL을 입력해주세요.
-    (figma.com/design/{fileKey}/...)"
-
-2. URL → fileKey 추출
-
-3. State 파일 로드 (idempotency, 재실행 시 중복 생성 방지)
-   경로: /tmp/{feature}/figma-create-state.json
-
-   스키마:
-     {
-       "feature": "<feature>",
-       "fileKey": "<figma fileKey>",
-       "createdAt": "<ISO-8601>",
-       "updatedAt": "<ISO-8601>",
-       "planHash": "<sha256 of plan.md content>",
-       "sections": [
-         {
-           "name": "<섹션 이름 (plan.md 8번 표 기준)>",
-           "bp": "mo" | "pc",
-           "wireNodeId": "<figma nodeId of wireframe frame>",   // Step D 결과
-           "designNodeId": "<figma nodeId of styled frame>",    // Step E 결과 (없으면 null)
-           "wireHash": "<sha256 of plan.md 8번 row — 레이아웃 키>",
-           "designHash": "<sha256 of plan.md 7번+8번+9번 row — 비주얼 키>",
-           "createdAt": "<ISO-8601>",
-           "updatedAt": "<ISO-8601>"
-         }
-       ]
-     }
-
-   ⚠ wireHash와 designHash를 분리하는 이유:
-     - plan.md 8번(레이아웃)만 변경 → wire 재생성 + design 재생성
-     - plan.md 7번(Look & Feel)만 변경 → wire SKIP + design만 재생성
-     - 둘 다 변경 안 됨 → 둘 다 cached
-
-   알고리즘:
-     - hasNewState == true → 기존 state 무시, 빈 state로 시작 (이전 nodeId 참조 안 함)
-     - 파일 없음 → 빈 state 생성 (sections: []), Step D부터 모두 신규 생성
-     - 존재 + state.fileKey != 입력 fileKey → ❌ 거부:
-         "이 plan.md는 다른 Figma 파일({state.fileKey})에 매핑돼 있습니다.
-          다른 파일에 새로 그리려면 --new-state 플래그를 추가하거나
-          /tmp/{feature}/figma-create-state.json 을 삭제하세요."
-     - 존재 + state.fileKey == 입력 fileKey → reuse 모드:
-         · planHash 비교: 다르면 "plan.md가 수정됐습니다. 변경된 섹션만 update 진행" 안내
-         · sections 매칭은 Step D(wireHash) / Step E(designHash)에서 각각 결정
+> Read `references/step-algorithms.md` for the AskUserQuestion prompt, fileKey extraction, and state-file path detail.
 
+```
 4. Load skill `figma:figma-use` (MANDATORY prerequisite)
    → use_figma 호출 규칙 (color 0-1, 폰트 로드, layoutSizing 순서 등)
 
@@ -431,6 +299,8 @@ Load skill `design-review` — audit 모드
    → 디자인 시스템 컴포넌트 발견 + 섹션별 조립 워크플로
 ```
 
+> Read `references/state-schema.md` for the full state JSON schema, wireHash/designHash rationale, and reuse/reject algorithm.
+
 ### Step C — 디자인 시스템 발견
 
 ```
@@ -438,14 +308,10 @@ Load skill `design-review` — audit 모드
    (와이어는 컴포넌트/변수 정보가 필요 없음)
 
 Load skill `figma:figma-generate-design` — Step 2: Discover Design System
-
-   2a. 컴포넌트: search_design_system 또는 기존 스크린 instance walk
-   2b. 변수(토큰): get_variable_defs로 색/간격/radius 수집
-   2c. 텍스트/이펙트 스타일: 발견된 토큰을 plan.md Look & Feel과 매칭
-       매칭 안 되면 "이 plan.md는 기존 디자인 시스템에 없는 토큰을 요구합니다.
-       새로 만들까요? (figma:figma-generate-library 권장) 또는 가까운 토큰으로 진행할까요?"
 ```
 
+> Read `references/step-algorithms.md` for the full 2a/2b/2c discovery sub-steps and unmatched-token prompt.
+
 ### Step D — 와이어프레임 생성 (incremental + idempotent)
 
 **목적**: plan.md 8번(레이아웃)만으로 회색 박스 + 텍스트 placeholder의 골격을 그린다. 컬러/타이포/컴포넌트 인스턴스는 **금지**.
@@ -456,38 +322,13 @@ Load skill `figma:figma-generate-design` — Step 2: Discover Design System
 
 Load skill `figma:figma-generate-design` — Step 3 패턴 재사용 (와이어 모드)
 
-   plan.md "## 8. 레이아웃/섹션 구성" 표를 순회:
-     for each 섹션 in plan.md:
-       1. 섹션 row 직렬화 → wireHash 계산 (8번 row만 해시)
-       2. state.sections에서 같은 name 매칭:
-          ├─ 매칭 없음 (신규):
-          │    a. use_figma 호출로 wire 프레임 생성 (Auto Layout만)
-          │       - 배경: #F5F5F5 (회색)
-          │       - 자식: 핵심 콘텐츠 컬럼의 항목마다 회색 박스 + 텍스트 라벨
-          │       - 컴포넌트 instance 배치 금지 (Step E에서 채움)
-          │       - 변수 바인딩 금지 (Step E에서 채움)
-          │    b. 반환된 wireNodeId를 state.sections에 entry append
-          │       (designNodeId = null 로 초기화)
-          ├─ 매칭 + wireHash 동일 (구조 변화 없음):
-          │    SKIP, "✓ {섹션명} wire (cached)" 출력
-          └─ 매칭 + wireHash 다름 (구조 변경됨):
-               a. use_figma로 기존 wireNodeId 내부 정리 (children 삭제)
-               b. 신규 케이스 a 재실행 (wireNodeId 재사용)
-               c. state entry의 wireHash + updatedAt 갱신
-               d. designNodeId가 있으면 → null로 리셋 (구조 바뀌었으니 본 디자인도 다시 그려야 함)
-
-   ⛔ 한 번의 use_figma 호출에 모든 섹션을 몰아넣지 말 것.
-      섹션 단위로 incremental 호출 → 검증 → 다음 섹션.
-
-   반응형 처리:
-     plan.md "## 9. 반응형 전략"의 브레이크포인트별로 별도 wire 프레임 생성
-     state.sections에는 bp 필드로 mo/pc 구분하여 각각 entry 저장
-
    Step D 종료 직전:
      state.updatedAt = now
      Write /tmp/{feature}/figma-create-state.json
 ```
 
+> Read `references/step-algorithms.md` for the full per-section wire generation algorithm (신규/캐시/구조변경 케이스), incremental-call rule, and responsive handling.
+
 #### 🚪 사용자 검토 게이트 (Step D ↔ Step E 사이)
 
 ```
@@ -496,21 +337,10 @@ Load skill `figma:figma-generate-design` — Step 3 패턴 재사용 (와이어
    - design 모드: Step D가 없어서 게이트 의미 없음 → Step E 먼저 실행
 
 1. mcp__plugin_figma_figma__get_screenshot 으로 와이어 프레임들 캡처
-2. 사용자에게 제시:
-   "📐 와이어프레임이 생성되었습니다.
-    figma URL: https://figma.com/design/{fileKey}/...?node-id={firstWireNodeId}
-    섹션 요약: 신규 N / 갱신 M / 캐시 K
-
-    구조가 plan.md와 일치합니까?
-      yes  → Step E (본 디자인) 진행
-      <자유 텍스트> → 수정 요청 (해당 섹션의 wireHash 강제 무효화 후 Step D 재실행)
-      abort → 워크플로 중단"
-
-3. ralph/ultrawork 모드:
-   사용자 질문 SKIP, 자동 yes로 Step E 진행
-   (단, 섹션이 0개면 abort)
 ```
 
+> Read `references/step-algorithms.md` for the full user review-gate message template and ralph/ultrawork auto-continue behavior.
+
 ### Step E — 본 디자인 적용 (incremental + idempotent)
 
 **목적**: plan.md 7번+8번+9번 기반으로 컴포넌트 인스턴스/색/타이포/실제 텍스트를 그린다. 모드에 따라 wireNodeId 재사용 여부가 달라진다.
@@ -521,52 +351,14 @@ Load skill `figma:figma-generate-design` — Step 3 패턴 재사용 (와이어
 
 Load skill `figma:figma-generate-design` — Step 3+: Assemble Sections (디자인 모드)
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-분기 A) createMode == "full":
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   state.sections를 순회 (Step D에서 채워진 상태):
-     for each section in state.sections:
-       1. 섹션 row 직렬화 → designHash 계산 (7번+8번+9번 row 해시)
-       2. designNodeId == null 이거나 designHash 변경됨:
-          a. use_figma로 wireNodeId 내부의 자식 정리 (placeholder 삭제)
-             ⚠ wireNodeId 자체는 삭제 금지 (Auto Layout 골격 보존)
-          b. 같은 wireNodeId 안에 컴포넌트 instance 배치 + 변수 바인딩
-          c. 텍스트는 plan.md "핵심 콘텐츠" 컬럼의 실제 값 사용
-          d. designNodeId = wireNodeId 로 set (같은 노드가 2단계로 진화)
-          e. state entry의 designHash + updatedAt 갱신
-       3. designHash 동일: SKIP, "✓ {섹션명} design (cached)" 출력
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-분기 B) createMode == "design":
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   plan.md "## 8. 레이아웃/섹션 구성" 표를 순회 (state가 없을 수 있음):
-     for each 섹션 in plan.md:
-       1. 섹션 row 직렬화 → designHash 계산
-       2. state.sections에서 같은 name 매칭:
-          ├─ 매칭 있음 + wireNodeId 존재 → 분기 A의 update 경로 실행 (wireNodeId 재사용)
-          ├─ 매칭 있음 + wireNodeId null → ❌ "이 섹션({섹션명})은 이전에 design 모드로 그려졌지만
-          │                                   state가 깨졌습니다. --new-state 로 리셋하세요."
-          └─ 매칭 없음:
-              ⚠ state.sections 가 완전히 비어있음 (첫 실행 또는 hasNewState)이면 허용:
-                a. use_figma 호출로 frame 생성 (Auto Layout + 컴포넌트 + 텍스트 한 번에)
-                b. wireNodeId = designNodeId = 반환된 frameNodeId
-                c. state.sections에 entry append (wireHash/designHash 둘 다 계산)
-              ⛔ state.sections 가 일부 비어있지 않으면 reject:
-                "이 섹션({섹션명})은 와이어가 없습니다. --create-storyboard 로 먼저 만들거나
-                 --create (full)로 호출하세요."
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-공통 규칙:
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   ⛔ 한 번의 use_figma 호출에 모든 섹션을 몰아넣지 말 것.
-   ⛔ 분기 A에서 wireNodeId를 삭제하고 새 노드를 만들지 말 것 (state 무효화됨).
-
    Step E 종료 직전:
      state.planHash = sha256(plan.md 전체)
      state.updatedAt = now
      Write /tmp/{feature}/figma-create-state.json
 ```
 
+> Read `references/step-algorithms.md` for the full 분기 A (full 모드) / 분기 B (design 모드) pseudocode and common rules (incremental use_figma calls, wireNodeId preservation).
+
 ### Step F — 시각 검증 + 최종 사용자 확인
 
 ```
@@ -574,30 +366,11 @@ Load skill `figma:figma-generate-design` — Step 3+: Assemble Sections (디자
    - createMode == "storyboard" → wireNodeId들 캡처
    - createMode == "design"     → designNodeId들 캡처
    - createMode == "full"        → designNodeId들 캡처
+```
 
-2. LLM 셀프 체크 (createMode에 따라 항목 narrow):
-
-   createMode == "storyboard" (구조 체크만 — 컬러 판단 불가):
-     - 섹션 순서가 plan.md 표와 일치하는가?
-     - 핵심 CTA 위치가 plan.md와 일치하는가?
-     ⛔ 컬러/분위기 체크 SKIP (와이어는 회색)
-
-   createMode == "design" 또는 "full":
-     - 섹션 순서가 plan.md 표와 일치하는가?
-     - 분위기/컬러 키워드가 시각적으로 반영됐는가?
-     - 핵심 CTA가 Hero에 존재하는가?
-
-3. 사용자에게 다음을 제시:
-   - createMode 표시 ("mode: full" / "mode: storyboard only" / "mode: design only")
-   - figma URL (fileKey + 첫 nodeId 딥링크)
-   - 섹션별 결과 요약:
-     · full:       wire 신규 N / 갱신 M / 캐시 K + design 신규 N / 갱신 M / 캐시 K
-     · storyboard: wire 신규 N / 갱신 M / 캐시 K
-     · design:     design 신규 N / 갱신 M / 캐시 K
-   - state 파일 경로
-   - (storyboard 모드) "다음 단계: 같은 plan.md로 `--create-design` 또는 `--create` 를 호출하면
-     이 와이어 위에 본 디자인이 입혀집니다."
+> Read `references/step-algorithms.md` for the full per-mode LLM self-check list and final user-facing summary template.
 
+```
 ⛔ Step F 완료 전까지 "완료 요약" 출력 금지.
 ⛔ 코드 파일 생성 절대 금지 (이 Branch는 WRITE-to-Figma 전용).
 ```

package/skills/vibe.figma/references/branch-phases.md

@@ -0,0 +1,113 @@
+# Branch 1 / Branch 2 Phase Detail — Full Reference
+
+> Loaded by vibe.figma SKILL.md Branch 1 (READ + 컨벤션) and Branch 2 (READ + 독립) phase bodies for the full elaboration beyond the `Load skill` call itself.
+
+## Branch 1 Phase 0 — URL 수집 + Design Context 로드
+
+```
+1. URL 수집 (스킬 진입 전)
+   - urlArgs.length > 0 → 그대로 figma 스킬에 전달 (인터랙티브 질문 생략)
+   - urlArgs.length == 0 → figma 스킬이 인터랙티브로 줄바꿈 입력 받음
+   ⚠ URL 분류(storyboard vs design, MO vs PC)는 스킬이 자동 처리 — router는 개입하지 않음
+     · fileKey 다름 → storyboard vs design
+     · ROOT 노드 name에 "MO"/"PC" → 디바이스 구분
+```
+
+```
+3. Design context 로드 (non-interactive 기본)
+   ⛔ design-teach 스킬을 자동으로 로드하지 말 것 (인터랙티브라 흐름이 끊김)
+
+   알고리즘:
+     - Read .vibe/design-context.json
+     - 존재 → 메모리에 binding 후 계속
+     - 없음 → 다음 한 줄만 출력하고 계속:
+         "💡 design-context.json 없음 — 기본값으로 진행합니다.
+          톤/팔레트/타이포 가이드를 적용하려면 /design-teach 또는
+          /vibe.figma --teach 로 다시 실행하세요."
+```
+
+## Branch 1 Phase 1 — Storyboard 분석 상세
+
+```
+   Phase 0에서 수집한 URL 중 "storyboard"로 자동 분류된 항목이 있으면 분석.
+   없으면 이 Phase는 자동 SKIP (스킬 내부 처리).
+
+   → 섹션 목록 + 기능 정의 + TypeScript 인터페이스 초안
+   ❌ 코드 파일 생성 금지
+```
+
+## Branch 1 Phase 2 — Audit Gate
+
+```
+   Phase 0에서 수집한 URL 중 "design"으로 자동 분류된 항목 (MO/PC)을 사용.
+   → tree.json + bg/ + content/ + sections/ (검증용)
+
+   🚦 Audit gate (tree.json 루트 `auditSummary` 사용):
+     - `auditSummary.p1 > 0` → Phase 3 진입 금지. 각 항목을 해결(디자인 레이어 교체,
+       근사치 수용 승인, 알려진 편차로 기록) 후 재추출.
+     - P2 항목은 피처 노트에 기록 → Phase 6 리뷰 대상.
+```
+
+## Branch 1 Phase 4 — 재사용 매칭 (BLOCKING)
+
+```
+   재사용 매칭 (BLOCKING):
+     ① component-index.json 매칭 → import (새로 만들지 않음)
+     ② project-tokens.json 매칭 → @use (새 토큰 생성 최소화)
+
+   ⛔ figma-to-scss.js 강제 / figma-validate.js PASS 없이 다음 섹션 금지
+```
+
+## Branch 1 Phase 6 — Raw-vs-Computed 재조정 + Phase 6.5
+
+```
+   Raw-vs-computed 재조정:
+     - tree.json 각 노드의 `raw` 필드(itemSpacing, padding*, fontSize, lineHeightPx,
+       letterSpacing, strokeWeight, cornerRadius 등 Figma 원본 수치)를
+       브라우저 `getComputedStyle`과 비교한다.
+     - 허용 오차 초과 시 P1 issue (gap/padding 0.5px, fontSize 0.25px, lineHeight 0.5px).
+     - Figma MCP/변환기가 삼킨 값이 여기서 드러난다.
+```
+
+```
+⤵ Phase 6.5 (hasEmitDesignMd == true 시)
+   → resolved tokens (Color/Typography/Spacing) + design-review(audit) 산출물을
+     DESIGN.md (Stitch 9 섹션) 으로 정제해 프로젝트 루트에 저장
+   → 첫 줄: `<!-- design-md-version: 1 -->`
+   → `vibe.design lint` 자동 통과 확인
+```
+
+## Branch 2 Phase 0 — Setup (Lite)
+
+```
+1. URL 수집 — Branch 1 Phase 0와 동일 (urlArgs 있으면 전달, 없으면 인터랙티브)
+
+2. Load skill `figma` — Phase 0 Setup
+   → 스택만 감지. 디렉토리 생성.
+   ⛔ component-index.json 인덱싱 SKIP
+   ⛔ project-tokens.json 스캔 SKIP
+   (재사용 매칭을 강제하지 않으므로 인덱스 불필요)
+```
+
+## Branch 2 Phase 4 — Standalone 모드 세부
+
+```
+   ⛔ 재사용 매칭 SKIP — 새 컴포넌트 자유 생성
+   ✅ 새 토큰 자유 생성 (피처 스코프 네이밍: $feature-color-xxx)
+   ✅ figma-to-scss.js / figma-validate.js는 그대로 강제
+
+   ❌ design-refine(normalize) 호출 금지 (이 Branch는 토큰 alignment 대상이 아님)
+```
+
+## Branch 2 Phase 6 — 시각 검증 + a11y 세부
+
+```
+   Raw-vs-computed 재조정: Branch 1과 동일 — tree.json `raw` ↔ getComputedStyle 비교.
+```
+
+```
+⤵ Phase 6.5 (hasEmitDesignMd == true 시)
+   → resolved tokens + design-review(audit) 산출물을
+     DESIGN.md (Stitch 9 섹션) 으로 정제해 프로젝트 루트에 저장
+   → 첫 줄: `<!-- design-md-version: 1 -->`
+```

package/skills/vibe.figma/references/state-schema.md

@@ -0,0 +1,42 @@
+# Figma Create State — Full Reference
+
+> Loaded by vibe.figma SKILL.md Branch 3 Step B for the full state JSON schema, wireHash/designHash rationale, and reuse/reject algorithm.
+
+```
+   스키마:
+     {
+       "feature": "<feature>",
+       "fileKey": "<figma fileKey>",
+       "createdAt": "<ISO-8601>",
+       "updatedAt": "<ISO-8601>",
+       "planHash": "<sha256 of plan.md content>",
+       "sections": [
+         {
+           "name": "<섹션 이름 (plan.md 8번 표 기준)>",
+           "bp": "mo" | "pc",
+           "wireNodeId": "<figma nodeId of wireframe frame>",   // Step D 결과
+           "designNodeId": "<figma nodeId of styled frame>",    // Step E 결과 (없으면 null)
+           "wireHash": "<sha256 of plan.md 8번 row — 레이아웃 키>",
+           "designHash": "<sha256 of plan.md 7번+8번+9번 row — 비주얼 키>",
+           "createdAt": "<ISO-8601>",
+           "updatedAt": "<ISO-8601>"
+         }
+       ]
+     }
+
+   ⚠ wireHash와 designHash를 분리하는 이유:
+     - plan.md 8번(레이아웃)만 변경 → wire 재생성 + design 재생성
+     - plan.md 7번(Look & Feel)만 변경 → wire SKIP + design만 재생성
+     - 둘 다 변경 안 됨 → 둘 다 cached
+
+   알고리즘:
+     - hasNewState == true → 기존 state 무시, 빈 state로 시작 (이전 nodeId 참조 안 함)
+     - 파일 없음 → 빈 state 생성 (sections: []), Step D부터 모두 신규 생성
+     - 존재 + state.fileKey != 입력 fileKey → ❌ 거부:
+         "이 plan.md는 다른 Figma 파일({state.fileKey})에 매핑돼 있습니다.
+          다른 파일에 새로 그리려면 --new-state 플래그를 추가하거나
+          /tmp/{feature}/figma-create-state.json 을 삭제하세요."
+     - 존재 + state.fileKey == 입력 fileKey → reuse 모드:
+         · planHash 비교: 다르면 "plan.md가 수정됐습니다. 변경된 섹션만 update 진행" 안내
+         · sections 매칭은 Step D(wireHash) / Step E(designHash)에서 각각 결정
+```