@su-record/vibe 2.8.39 → 2.8.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,67 +1,89 @@
1
- # Image Extraction Rules
1
+ # Image Extraction Rules — Node Rendering Based
2
2
 
3
- ## Format
4
-
5
- - Output format: `.webp` always — never `.png`, `.jpg`, `.svg` from MCP asset URLs
6
- - Exception: SVG icons referenced as inline code (not MCP URLs) stay as `.svg`
7
- - Do not convert or re-encode after download — use the raw bytes from `curl`
3
+ ## Core Principle
8
4
 
9
- ## Naming
5
+ ```
6
+ ❌ imageRef 개별 다운로드 금지 (텍스처 fill 공유 문제)
7
+ ✅ 모든 이미지는 Figma screenshot API로 노드 렌더링
8
+ ```
10
9
 
11
- Convert the JavaScript variable name to kebab-case:
10
+ ## Render Methods
12
11
 
13
- | Variable | File Name |
14
- |----------|-----------|
15
- | `img21` | `img-21.webp` |
16
- | `imgTitle` | `title.webp` (strip leading `img` prefix) |
17
- | `imgSnowParticle12` | `snow-particle-12.webp` |
18
- | `imgImgBannerStatic` | `banner-static.webp` (collapse double `img`) |
19
- | `imgBtnShare` | `btn-share.webp` |
12
+ | 이미지 유형 | 렌더링 방법 | 출력 위치 |
13
+ |-----------|-----------|---------|
14
+ | BG 프레임 (합성 배경) | `screenshot {fileKey} {bg.nodeId}` | `bg/{section}-bg.png` |
15
+ | 콘텐츠 (타이틀, 버튼) | `screenshot {fileKey} {node.nodeId}` | `content/{name}.png` |
16
+ | 벡터 글자 그룹 | `screenshot {fileKey} {group.nodeId}` | `content/{name}.png` |
20
17
 
21
- Rules:
22
- - Strip leading `img` prefix before converting to kebab-case
23
- - Numbers stay as-is: `item11` → `item-11`
24
- - Acronyms lowercased: `BTN` → `btn`, `BG` → `bg`
18
+ ## BG 프레임 판별
25
19
 
26
- ## Destination
20
+ ```
21
+ BG 프레임 = 다음 중 하나:
22
+ - name에 "BG", "bg" 포함
23
+ - 부모와 크기 동일(±10%) + 자식 이미지 3개 이상
24
+ - 1depth 첫 번째 자식이면서 이미지 노드 다수 보유
27
25
 
26
+ → 프레임 렌더링 1장 → CSS background-image
27
+ → 하위 개별 레이어 다운로드하지 않음
28
28
  ```
29
- public/images/{feature}/ ← Vue/Nuxt
30
- static/images/{feature}/ ← Nuxt 2 legacy
31
- public/{feature}/ ← Next.js (under /public)
29
+
30
+ ## 벡터 글자 판별
31
+
32
32
  ```
33
+ 벡터 글자 그룹 = 다음 모두 충족:
34
+ - 부모 GROUP/FRAME 아래 VECTOR 타입 3개 이상
35
+ - 각 VECTOR 크기 < 60x60
36
+ - 같은 imageRef 공유 (텍스처 fill)
33
37
 
34
- Always use the directory confirmed in Phase 0 setup.
38
+ 부모 GROUP 통째로 렌더링 (개별 글자 다운로드 금지)
39
+ → 커스텀 폰트 텍스트 = 웹폰트 없음 → 이미지로 사용
40
+ ```
35
41
 
36
- ## Size Limits
42
+ ## Format
37
43
 
38
- | Type | Warn threshold | Block threshold |
39
- |------|---------------|----------------|
40
- | Background image | 500 KB | 2 MB |
41
- | Content image | 200 KB | 1 MB |
42
- | Decorative image | 100 KB | 500 KB |
43
- | Total per section | 3 MB | 10 MB |
44
+ - Output format: `.png` (Figma screenshot API 기본)
45
+ - 최적화 필요 시 빌드 단계에서 webp 변환 (추출 단계에서는 png)
44
46
 
45
- If a file exceeds the warn threshold, log it. Never block the download — size checks are advisory.
47
+ ## Naming
46
48
 
47
- ## Download Rules
49
+ 렌더링된 이미지의 파일명 = Figma 노드 name을 kebab-case로:
50
+ - `"Hero"` BG frame → `hero-bg.png`
51
+ - `"Mission 01"` vector group → `mission-01.png`
52
+ - `"Title"` content → `hero-title.png` (섹션명 prefix)
53
+ - `"Btn_Login"` → `btn-login.png`
48
54
 
49
- - [ ] Download ALL `const img...` variables — zero omissions ("core assets only" is forbidden)
50
- - [ ] Use `curl -sL "{url}" -o {dest}` — silent, follow redirects
51
- - [ ] After download: `ls -la {dir}` — verify file exists and size > 0
52
- - [ ] On 0-byte file: retry once. On second failure: log and continue (do not block code gen for a single failed decorative image)
53
- - [ ] On missing asset (in tree.json but no download URL): use node render fallback (`--render --nodeIds={id}`) to capture as PNG
55
+ Rules:
56
+ - 공백 하이픈
57
+ - 언더스코어 하이픈
58
+ - 숫자 유지: `item11` → `item-11`
59
+ - 대문자 소문자
54
60
 
55
- ## Image Mapping Table
61
+ ## Destination
56
62
 
57
- After all downloads, produce a mapping before writing any component code:
63
+ ```
64
+ /tmp/{feature}/{bp-folder}/
65
+ bg/ ← BG 프레임 렌더링
66
+ content/ ← 콘텐츠 + 벡터 글자 렌더링
67
+ sections/ ← Phase 4 검증용 스크린샷
68
+ ```
58
69
 
59
- ```js
60
- const imageMap = {
61
- imgTitle: '/images/{feature}/title.webp',
62
- img21: '/images/{feature}/img-21.webp',
63
- // ...every variable
64
- }
70
+ 최종 배치 (Phase 5):
65
71
  ```
72
+ static/images/{feature}/ ← Nuxt 2
73
+ public/images/{feature}/ ← Vue/Nuxt 3
74
+ public/{feature}/ ← Next.js
75
+ ```
76
+
77
+ ## Size Limits
78
+
79
+ | Type | Warn threshold | Action |
80
+ |------|---------------|--------|
81
+ | BG 렌더링 | 5 MB | 정상 (합성 이미지라 큰 게 정상) |
82
+ | 콘텐츠 렌더링 | 1 MB | 경고 |
83
+ | 단일 이미지 > 5 MB | — | ⚠️ 텍스처 fill 의심 → imageRef 다운로드 실수 확인 |
84
+
85
+ ## Fallback
66
86
 
67
- This map is the only source for `src` values in generated components. No raw Figma URLs in output code.
87
+ 노드 렌더링 불가 시에만 imageRef 다운로드:
88
+ - Figma screenshot API 실패 (rate limit, 권한)
89
+ - 다운로드 후 파일 크기 5MB 초과 → 텍스처 fill 가능성 → 경고 로그
@@ -1,10 +0,0 @@
1
- ---
2
- name: vibe.figma.analyze
3
- description: "[Merged] → vibe.figma (Phase 1: Storyboard) 참조"
4
- triggers: []
5
- tier: standard
6
- ---
7
-
8
- # vibe.figma.analyze
9
-
10
- 이 스킬은 **vibe.figma** (Phase 1: Storyboard)으로 병합되었습니다.
@@ -1,53 +0,0 @@
1
- # Analysis Dimensions — Figma Design Analysis
2
-
3
- > This skill is merged into vibe.figma (Phase 1: Storyboard). These dimensions guide what to extract and evaluate when reading Figma frames.
4
-
5
- ## Layout
6
-
7
- - [ ] Overall page structure — single column, multi-column, grid, or free-form absolute
8
- - [ ] Section boundaries — identify where each distinct section starts/ends by visual grouping
9
- - [ ] Container width — fixed px vs fluid (100%)
10
- - [ ] Alignment system — centered, left-aligned, or asymmetric
11
- - [ ] Z-layering — how many stacked layers exist (BG/content/overlay count)
12
- - [ ] Overflow behavior — clip, hidden, visible, scroll
13
-
14
- ## Spacing Consistency
15
-
16
- - [ ] Gap between sections — does a single spacing value repeat, or is each unique?
17
- - [ ] Internal component padding — consistent across card variants?
18
- - [ ] Icon-to-text gap — uniform within a component family?
19
- - [ ] Recurring values — list values that appear 3+ times (these become spacing tokens)
20
- - [ ] Irregular values — flag one-off spacings that may indicate design inconsistency
21
-
22
- ## Color Usage
23
-
24
- - [ ] Background palette — how many distinct background colors exist?
25
- - [ ] Text color roles — identify heading / body / label / disabled colors separately
26
- - [ ] Accent/brand colors — primary CTA color, hover state color
27
- - [ ] Transparency usage — rgba overlays, opacity layers
28
- - [ ] Blend modes present — `mix-blend-lighten`, `multiply`, `hue` flag a literal-mode section
29
- - [ ] Dark/light variants — does the design have both, requiring CSS variable tokens?
30
-
31
- ## Typography Hierarchy
32
-
33
- - [ ] H1 equivalent — largest display text, font-size + weight + role
34
- - [ ] H2 / section heading — size, weight, color
35
- - [ ] Body text — base size, line-height, color
36
- - [ ] Caption / label text — smallest size, usage context
37
- - [ ] Font families — how many distinct families? Any variable fonts?
38
- - [ ] Responsive scaling — does font-size change across breakpoints?
39
-
40
- ## Component Inventory
41
-
42
- - [ ] Repeating UI patterns — cards, list items, tabs (candidates for `v-for`)
43
- - [ ] State variants — default, hover, active, disabled, selected (note which states exist)
44
- - [ ] Shared components — GNB, Footer, Popup (already in project or needs creation?)
45
- - [ ] Interactive elements — buttons, links, inputs, toggles
46
- - [ ] Decorative elements — particles, background shapes, overlay effects
47
-
48
- ## Storyboard-Specific Dimensions
49
-
50
- - [ ] Frame classification — SPEC, CONFIG, SHARED, PAGE (by name pattern)
51
- - [ ] Interaction annotations — arrows, overlay connections, state transitions in Figma
52
- - [ ] Section count — total PAGE frames that need components
53
- - [ ] Tall frames (1500px+) — flag for split strategy before `get_design_context`
@@ -1,10 +0,0 @@
1
- ---
2
- name: vibe.figma.codegen
3
- description: "[Merged] → vibe.figma.convert 참조"
4
- triggers: []
5
- tier: standard
6
- ---
7
-
8
- # vibe.figma.codegen
9
-
10
- 이 스킬은 **vibe.figma.convert**으로 병합되었습니다.
@@ -1,54 +0,0 @@
1
- # Code Generation Quality Checklist
2
-
3
- > This skill is merged into vibe.figma.convert. Use this checklist to validate generated component and style files before moving to the next section.
4
-
5
- ## Structure
6
-
7
- - [ ] Component file exists at `components/{feature}/{ComponentName}.vue` (or `.tsx`)
8
- - [ ] Template is not empty — at least one visible HTML element with content
9
- - [ ] No `placeholder` text remaining in any attribute or text node
10
- - [ ] No `src=""` or `href=""` empty attributes
11
-
12
- ## Assets
13
-
14
- - [ ] All `const img...` variables from reference code are replaced with local `/images/{feature}/` paths
15
- - [ ] No `figma.com/api` URLs in any generated file
16
- - [ ] Every image path references a file that was actually downloaded (cross-check image map)
17
- - [ ] Decorative images have `alt="" aria-hidden="true"`
18
- - [ ] Content images have descriptive `alt` text
19
-
20
- ## Styles (Normal Mode)
21
-
22
- - [ ] No `<style>` block inside the component file
23
- - [ ] No inline `style=""` attribute (exception: dynamic `:style` for mask-image)
24
- - [ ] External layout file exists at `styles/{feature}/layout/_{section}.scss`
25
- - [ ] External components file exists at `styles/{feature}/components/_{section}.scss`
26
- - [ ] `_tokens.scss` updated with any new unique color/spacing/typography values
27
-
28
- ## Styles (Literal Mode)
29
-
30
- - [ ] `<style scoped>` block present in component
31
- - [ ] No external SCSS files created for this section
32
- - [ ] All `position: absolute` coordinates are scaled by scaleFactor
33
- - [ ] `mix-blend-mode`, `rotate`, `blur`, `mask-image` values preserved verbatim
34
- - [ ] `%` values not scaled (only `px` values are scaled)
35
-
36
- ## TypeScript / Script
37
-
38
- - [ ] JSDoc comment present with `[기능 정의]`, `[인터랙션]`, `[상태]` sections
39
- - [ ] No `any` type — use explicit interfaces or `unknown`
40
- - [ ] Mock data arrays have 3–7 items (not empty `[]`)
41
- - [ ] Event handler stubs exist with `// TODO:` body
42
- - [ ] Explicit return types on all functions
43
-
44
- ## Responsive
45
-
46
- - [ ] Base styles target the smallest viewport (mobile-first)
47
- - [ ] Desktop overrides use `@media (min-width: {$bp-pc})` or the project mixin
48
- - [ ] No existing base styles deleted when adding breakpoint overrides
49
-
50
- ## Build
51
-
52
- - [ ] No TypeScript compile errors in the generated file
53
- - [ ] No missing imports (components, composables, types)
54
- - [ ] Template references only props/data/computed that are declared in `<script setup>`
@@ -1,10 +0,0 @@
1
- ---
2
- name: vibe.figma.consolidate
3
- description: "[Merged] → vibe.figma (Phase 4: Verification) 참조"
4
- triggers: []
5
- tier: standard
6
- ---
7
-
8
- # vibe.figma.consolidate
9
-
10
- 이 스킬은 **vibe.figma** (Phase 4: Verification)으로 병합되었습니다.
@@ -1,95 +0,0 @@
1
- # Consolidation Report — {{FEATURE_NAME}}
2
-
3
- **Feature Key:** {{FEATURE_KEY}}
4
- **Date:** {{DATE}}
5
- **Phase:** Post-implementation verification
6
-
7
- ---
8
-
9
- ## Summary
10
-
11
- | Metric | Value |
12
- |--------|-------|
13
- | Total sections | {{SECTION_COUNT}} |
14
- | Sections passing | {{PASS_COUNT}} |
15
- | P1 issues found | {{P1_COUNT}} |
16
- | P2 issues found | {{P2_COUNT}} |
17
- | Assets downloaded | {{ASSET_COUNT}} |
18
- | Build status | {{BUILD_STATUS}} |
19
-
20
- ---
21
-
22
- ## Automated Grep Results
23
-
24
- | Check | Result | Details |
25
- |-------|--------|---------|
26
- | `figma.com/api` in generated files | {{PASS/FAIL}} | {{COUNT}} occurrences |
27
- | `<style` in `components/{{FEATURE_KEY}}/` | {{PASS/FAIL}} | {{COUNT}} occurrences |
28
- | `style="` in `components/{{FEATURE_KEY}}/` | {{PASS/FAIL}} | {{COUNT}} occurrences |
29
- | `placeholder` in components | {{PASS/FAIL}} | {{COUNT}} occurrences |
30
- | `src=""` in components | {{PASS/FAIL}} | {{COUNT}} occurrences |
31
- | Images in `public/images/{{FEATURE_KEY}}/` | {{PASS/FAIL}} | {{COUNT}} files |
32
-
33
- ---
34
-
35
- ## Section Review
36
-
37
- | # | Section | Component | Mode | Screenshot Match | P1 | P2 |
38
- |---|---------|-----------|------|-----------------|----|----|
39
- | 1 | {{SECTION_NAME}} | `{{ComponentName}}.vue` | {{normal/literal}} | {{match %}} | {{count}} | {{count}} |
40
-
41
- ---
42
-
43
- ## P1 Issues (Must Fix)
44
-
45
- ### {{SECTION_NAME}} — {{ISSUE_TITLE}}
46
-
47
- **Type:** {{image-missing / layout-mismatch / text-unstyled / asset-wrong-path}}
48
- **Description:** {{DESCRIPTION}}
49
- **Fix:** {{FIX_INSTRUCTION}}
50
- **Status:** {{open / fixed}}
51
-
52
- ---
53
-
54
- ## P2 Issues (Recommended)
55
-
56
- ### {{SECTION_NAME}} — {{ISSUE_TITLE}}
57
-
58
- **Type:** {{spacing-delta / color-delta / font-size-delta}}
59
- **Description:** {{DESCRIPTION}} (delta: {{DELTA}})
60
- **Fix:** {{FIX_INSTRUCTION}}
61
- **Status:** {{open / deferred}}
62
-
63
- ---
64
-
65
- ## File Manifest
66
-
67
- ### Components
68
-
69
- ```
70
- components/{{FEATURE_KEY}}/
71
- {{FILE_LIST}}
72
- ```
73
-
74
- ### Styles
75
-
76
- ```
77
- styles/{{FEATURE_KEY}}/
78
- {{FILE_LIST}}
79
- ```
80
-
81
- ### Assets
82
-
83
- ```
84
- public/images/{{FEATURE_KEY}}/
85
- {{FILE_LIST}}
86
- ```
87
-
88
- ---
89
-
90
- ## Next Steps
91
-
92
- - [ ] P1 count = 0 (required before handoff)
93
- - [ ] Run `/design-normalize` → `/design-audit --quick`
94
- - [ ] Optional: `/design-critique` → `/design-polish` for thorough review
95
- - [ ] Commit with feature key tag: `feat({{FEATURE_KEY}}): figma design implementation`
@@ -1,10 +0,0 @@
1
- ---
2
- name: vibe.figma.frame
3
- description: "[Merged] → vibe.figma.extract 참조"
4
- triggers: []
5
- tier: standard
6
- ---
7
-
8
- # vibe.figma.frame
9
-
10
- 이 스킬은 **vibe.figma.extract**으로 병합되었습니다.
@@ -1,55 +0,0 @@
1
- # Frame Selection Rubric
2
-
3
- > This skill is merged into vibe.figma.extract. Use this rubric to select the right frames before calling `get_design_context`.
4
-
5
- ## Frame Classification by Name Pattern
6
-
7
- | Pattern in Name | Class | Action |
8
- |----------------|-------|--------|
9
- | "기능 정의서", "정책", "spec", "policy" | SPEC | `get_design_context` — extract text requirements |
10
- | "해상도", "브라우저", "config", "resolution" | CONFIG | `get_design_context` — extract scale factor |
11
- | "공통", "GNB", "Footer", "Popup", "shared", "common" | SHARED | Read if referenced; skip if project already has them |
12
- | "화면설계", "메인 -", "section", numbered frames | PAGE | Core implementation targets |
13
-
14
- ## Selection Priority
15
-
16
- 1. SPEC frame (1 frame) — read first, informs all feature requirements
17
- 2. CONFIG frame (1 frame) — establishes scale factors for both breakpoints
18
- 3. PAGE frames — top-level only (e.g. `3.1`, `3.2`, not `3.1.1`, `3.1.2`)
19
- 4. SHARED frames — only if component does not already exist in the project
20
-
21
- Never read sub-case frames (e.g. `3.1.1`, `3.2.1`) during Phase 1. Read them in Phase 2 only if a sub-state is needed for a specific interaction.
22
-
23
- ## Tall Frame Decision Tree
24
-
25
- ```
26
- Frame height > 1500px?
27
- YES → Split before calling get_design_context
28
- 1. get_metadata(nodeId) → get child node list
29
- 2. Call get_design_context per child node
30
- 3. Merge results as one logical section
31
- NO → Call get_design_context directly
32
- ```
33
-
34
- Height thresholds from real data:
35
- - Safe direct call: up to ~900px
36
- - Risk zone: 900–1500px (attempt once, split on timeout)
37
- - Always split: 1500px+
38
-
39
- ## Skipping Frames
40
-
41
- Skip a frame entirely when:
42
- - Name contains "OLD", "archive", "deprecated", "참고", "예시" (reference only)
43
- - Frame is a copy/duplicate of another already processed frame
44
- - Frame is a component definition (Figma component, not an instance) — use its instances instead
45
-
46
- ## Viewport Frames
47
-
48
- When multiple frames represent the same section at different widths:
49
- - Smallest width = mobile (Phase 2 base URL)
50
- - Larger widths = desktop breakpoints (Phase 2 subsequent URLs)
51
- - Process mobile first, then add desktop as responsive layer — never the reverse
52
-
53
- ## Frame Count Warning
54
-
55
- If total PAGE frames > 10, confirm with the user before proceeding. Large frame counts may indicate the Figma file covers multiple pages that should be separate feature implementations.
@@ -1,11 +0,0 @@
1
- ---
2
- name: vibe.figma.pipeline
3
- description: "[Merged] → vibe.figma.consolidate D-4 참조"
4
- triggers: []
5
- tier: standard
6
- ---
7
-
8
- # vibe.figma.pipeline
9
-
10
- 이 스킬은 **vibe.figma.consolidate** D-4 섹션으로 병합되었습니다.
11
- Design Quality Pipeline 안내는 `vibe.figma.consolidate` Step D-4를 참조하세요.
@@ -1,96 +0,0 @@
1
- # Pipeline Stage Descriptions and Failure Handling
2
-
3
- > This skill is merged into vibe.figma.consolidate (D-4). This rubric describes each stage of the Figma-to-code pipeline and what to do when a stage fails.
4
-
5
- ## Stage Map
6
-
7
- ```
8
- Phase 0: Setup
9
- └─ Detect stack → Determine feature key → Create directories
10
-
11
- Phase 1: Storyboard
12
- └─ Classify frames → Analyze SPEC/CONFIG/PAGE → Generate component shells
13
-
14
- Phase 2: Design (per breakpoint)
15
- ├─ 2-1: Style scaffold
16
- ├─ 2-2: Classify mode (normal/literal) per section
17
- ├─ 2-3: Split tall frames if needed
18
- └─ 2-4: Section loop
19
- ├─ a. get_design_context
20
- ├─ b. Download all assets
21
- ├─ c. Convert code
22
- ├─ d. Refactor component template
23
- └─ e. Verify section
24
-
25
- Phase 3: Verification
26
- ├─ Automated grep checks
27
- └─ Screenshot comparison
28
- ```
29
-
30
- ## Stage Failure Handling
31
-
32
- ### Phase 0 Failures
33
-
34
- | Failure | Resolution |
35
- |---------|-----------|
36
- | Cannot detect stack | Ask user: "Vue or React? SCSS or Tailwind?" |
37
- | Directory already exists | Proceed — do not overwrite existing files unless replacing |
38
-
39
- ### Phase 1 Failures
40
-
41
- | Failure | Resolution |
42
- |---------|-----------|
43
- | Metadata too large (>100K chars) | Save to file, parse with Bash/Python to extract frame list |
44
- | No SPEC frame found | Continue without feature requirements; note missing in report |
45
- | No CONFIG frame | Use default scale factors (mobile: 480/720=0.667, PC: 1920/2560=0.75) |
46
- | Storyboard URL is "없음" | Skip Phase 1, go directly to Phase 2 |
47
-
48
- ### Phase 2-a Failures (get_design_context)
49
-
50
- | Failure | Retry | Escalation |
51
- |---------|-------|-----------|
52
- | Timeout on first call | Retry once with `excludeScreenshot: true` | Split frame → per-child calls |
53
- | Timeout after split | Retry individual child once | `get_screenshot` + visual estimation |
54
- | Empty response | Retry once | Skip section, log in consolidation report |
55
-
56
- Maximum retries per section: 2. After 2 failures: use screenshot fallback. Never loop more than 3 times on the same section.
57
-
58
- ### Phase 2-b Failures (Asset Download)
59
-
60
- | Failure | Resolution |
61
- |---------|-----------|
62
- | 0-byte file | Retry once with same curl command |
63
- | 404 URL | Try `get_metadata` → sub-node → `get_design_context` for fresh URL |
64
- | All retries failed | Log missing asset; continue with other assets; mark section as needs-review |
65
-
66
- Single asset failure does not block the entire section unless it is a critical background image.
67
-
68
- ### Phase 2-e Section Verification Failures
69
-
70
- | Check Failed | Action |
71
- |-------------|--------|
72
- | Figma URL in output | Find and replace all occurrences; re-verify |
73
- | 0-byte or missing image | Re-download; if impossible, use placeholder only with TODO comment |
74
- | Empty template | Do not proceed to next section until fixed |
75
- | Build error | Fix TypeScript/template error; re-build |
76
-
77
- ### Phase 3 Failures (Screenshot Comparison)
78
-
79
- | Priority | Issue Type | Action |
80
- |----------|-----------|--------|
81
- | P1 | Image missing, wrong layout, unstyled text | Fix immediately; re-verify before continuing |
82
- | P2 | Spacing delta, slight color difference | Fix if time allows; defer if P1=0 and deadline is tight |
83
- | P3 | Pixel-perfect micro-adjustments | Deferred to `/design-polish` pass |
84
-
85
- P1 = 0 is required before the feature is considered complete. P2/P3 are best-effort.
86
-
87
- ## Design Quality Pipeline (Post-completion)
88
-
89
- ```
90
- /design-normalize → normalize inconsistent values
91
- /design-audit → automated audit (quick pass)
92
- /design-critique → thorough visual critique
93
- /design-polish → final polish pass
94
- ```
95
-
96
- Run at minimum: `/design-normalize` → `/design-audit --quick` before committing.
@@ -1,10 +0,0 @@
1
- ---
2
- name: vibe.figma.rules
3
- description: "[Merged] → vibe.figma (rules are inlined) 참조"
4
- triggers: []
5
- tier: standard
6
- ---
7
-
8
- # vibe.figma.rules
9
-
10
- 이 스킬의 규칙은 **vibe.figma**, **vibe.figma.extract**, **vibe.figma.convert** 3개 스킬에 내장되었습니다.
@@ -1,70 +0,0 @@
1
- # Figma Layer Naming Conventions for Clean Extraction
2
-
3
- > This skill is inlined into vibe.figma, vibe.figma.extract, and vibe.figma.convert. This rubric documents how Figma layer names map to generated code identifiers.
4
-
5
- ## Layer Name → CSS Class
6
-
7
- Convert `data-name` attribute values from reference code to CSS class names:
8
-
9
- | Figma Layer Name | CSS Class | Notes |
10
- |-----------------|-----------|-------|
11
- | `BG` | `.bg` | Lowercase single word |
12
- | `Title` | `.title` | PascalCase → camelCase |
13
- | `Period` | `.period` | |
14
- | `Light` | `.light` | |
15
- | `BTN_Share` | `.btnShare` | `BTN_` prefix → `btn`, underscore → camelCase |
16
- | `BTN_Primary` | `.btnPrimary` | |
17
- | `KV` (Key Visual) | `.kv` | Acronym → all lowercase |
18
- | `GNB` | `.gnb` | |
19
- | `PC_Banner` | `.pcBanner` | |
20
- | `Snow_Particle_12` | `.snowParticle12` | Underscore-separated → camelCase |
21
- | *(no data-name)* | `.node-{nodeId}` | Replace `:` with `-` in nodeId |
22
-
23
- ## Conflict Resolution
24
-
25
- When two layers in the same section share the same name:
26
- - Prefix with parent layer name: `.heroLight`, `.kidLight`
27
- - Or append an index suffix: `.light-1`, `.light-2`
28
- - Never generate duplicate class names in the same `<style scoped>` block
29
-
30
- ## Image Variable Name → File Name
31
-
32
- | Figma Variable | File Name | Rule |
33
- |---------------|-----------|------|
34
- | `imgTitle` | `title.webp` | Strip `img` prefix, kebab-case |
35
- | `img21` | `img-21.webp` | Numeric suffix: keep number |
36
- | `imgSnowParticle12` | `snow-particle-12.webp` | CamelCase → kebab |
37
- | `imgImgBannerStatic` | `banner-static.webp` | Double `img` prefix → strip both |
38
- | `imgBtnShare` | `btn-share.webp` | |
39
-
40
- ## Component File Naming
41
-
42
- | Figma Section Name | Component File |
43
- |-------------------|----------------|
44
- | "Hero" / "히어로" | `HeroSection.vue` |
45
- | "Daily Check-in" / "일일 출석" | `DailyCheckInSection.vue` |
46
- | "Play Time Mission" | `PlayTimeMissionSection.vue` |
47
- | "Exchange" / "교환" | `ExchangeSection.vue` |
48
- | "Popup" | `RewardPopup.vue` (non-section suffix) |
49
- | "GNB" | `TheGnb.vue` (project-wide shared) |
50
-
51
- Rules:
52
- - PascalCase always
53
- - Append `Section` suffix for page sections
54
- - No `Section` suffix for popups, overlays, shared layout components
55
-
56
- ## Feature Key (Directory Name)
57
-
58
- Derived from Figma file name:
59
-
60
- | Figma File Name | Feature Key |
61
- |----------------|-------------|
62
- | "PUBG 겨울 PC방 이벤트" | `winter-pcbang` |
63
- | "Summer Campaign 2025" | `summer-campaign-2025` |
64
- | "Login Page Redesign" | `login-page-redesign` |
65
-
66
- Rules:
67
- - kebab-case
68
- - Remove language/brand prefixes if obvious from context
69
- - Numbers and years are kept
70
- - No special characters
@@ -1,10 +0,0 @@
1
- ---
2
- name: vibe.figma.style
3
- description: "[Merged] → vibe.figma.convert 참조"
4
- triggers: []
5
- tier: standard
6
- ---
7
-
8
- # vibe.figma.style
9
-
10
- 이 스킬은 **vibe.figma.convert**으로 병합되었습니다.