fmcp-screen-recipes

FMCP Screen Recipes — Fast Path Cookbook

Kullanım (v3.1+): fmcp-screen-orchestrator Adım 0.5 Fast Path 5/5 match olduğunda çağrılır. Bağımsız giriş noktası değil. Adım 1.6 (Text Style Resolution) canonical kopyası burada — orchestrator buraya referans verir, kod duplicate etmez.

Ne Zaman Kullanılır

Fast Path DEVREYE GİRER (hepsi TRUE olmalı):

• ✅ Tek ekran üretimi
• ✅ Standart ekran tipi: 9 recipe'ten biri match ediyor
• ✅ DS tanımlı: active-ds.md Status: ✅ Aktif
• ✅ Platform belli
• ✅ Custom animation / prototype YOK

Devreye GİRMEZ: Multi-screen flow, custom layout, animation, explicit generate-figma-screen talebi, DS GATE geçilmemişse.

---

5 Mega-Adımlı Akış

Max 15 op/execute. Her mega-adım sonrası tek satır Türkçe micro-report.

M1: Pre-Flight Discovery + Token + Text Style  (1 execute, ~15 op)
M2: Frame + Structure + Modes                   (1 execute, ~12-14 op)
M3: Component Placement (toplu, 3-4/execute)    (2-3 execute, ~12-15 op each)
     ↳ Her M3 execute sonrası: figma_scan_ds_compliance(threshold=85) inline gate
M4: Dark Variant                                (1 execute, ~4 op)
M5: Validate + Final Report                     (ZORUNLU: figma_scan_ds_compliance(detailed) + figma_validate_screen)

Toplam execute: ~6-8 + 2-3 scan call. Hedef süre: ~10 dk. v1.9.4: Scan call'ları hızlıdır (~150ms), execute bütçesini yemezler.

3 MUTLAK KURAL

KURAL 1 — Fill Bind Zorunlu (frame + text dahil):

const paint = { type: 'SOLID', color: { r: 1, g: 1, b: 1 } };
const bound = figma.variables.setBoundVariableForPaint(paint, 'color', dsColorVar);
node.fills = [bound];

Fill panel'de variable icon 🎨 GÖRÜNMELI. Hardcoded hex YASAK. Frame fill + text fill + primitive dahil TÜM node'lar.

KURAL 2 — Variant Seçim: DEFAULT Koru:

• setProperties ile SADECE recipe'de explicit belirtilen property'leri set et
• Diğer TÜM property'leri DEFAULT bırak
• Product → main (default), Boolean kontroller → recipe'de explicit yoksa DEFAULT