F-MCP Temel Kurallar

Bu skill, tüm F-MCP skill'leri ve komutları için geçerli olan temel kuralları tanımlar. Her Figma işleminde bu kurallar otomatik olarak uygulanır.

Kullanıcı İstekleri — Otomatik Yanıt

"F-MCP'yi güncelle" / "update" / "güncelle"

Terminal komutu verme. bash scripts/update.sh çalıştır, sonucu bildir:

Güncelleme tamamlandı (vX.Y.Z). Claude'u yeniden başlat ve Figma'da plugin'i kapat-aç.

"F-MCP'yi kur" / "setup" / "kur" / "bunu kur" / GitHub linki verildi

Kullanıcı GitHub linki (github.com/atezer/FMCP) verip "kur" derse veya herhangi bir şekilde kurulum isterse:

1. Repo zaten clone edilmişse: bash scripts/setup.sh çalıştır
2. Repo clone edilmemişse: git clone https://github.com/atezer/FMCP.git && cd FMCP && bash scripts/setup.sh
3. Kullanıcıya sadece sonucu bildir.

Kullanıcıya ASLA terminal komutu söyleme, teknik adım açıklama. Her şeyi sen yap.

Dil

Kullanıcı Türkçe konuşuyor. Tüm dosyalarda Türkçe karakterler (ş, ç, ğ, ö, ü, ı, İ) doğru kullanılmalı.

Token-Only Enforcement (v1.9.8+ MUTLAK)

Kullanıcıya soru/seçenek sunarken (AskUserQuestion options, plan summary, onay metni, fallback dialog):

• ❌ YASAK: ham hex değer (#195e90, #FFFFFF), ham px (375px, 390px), ham pt, ham rem, ham RGB
• ✅ ZORUNLU: token adı (<DS>/primary/default, <DS>/spacing/150, <DS>/text/body/M)
• ✅ ZORUNLU: device preset adı (iPhone 17 (402×874), Pixel 8 Pro (412×917), iPad Pro 11 (834×1194))

Self-check (ZORUNLU): AskUserQuestion çağırmadan önce soru metnini ve tüm option text'lerini kontrol et:

• Regex match: /#[0-9a-f]{3,8}\b/i → VARSA: soru kuralı ihlali, hex'i <DS>/... token adıyla değiştir ve yeniden formüle et
• Regex match: /\b\d{2,4}\s*px\b/i → VARSA: px yerine device preset adı veya <DS>/spacing/... kullan

Gerekçe: Kullanıcı hex/px görmemeli — token adı DS-agnostic, DS değiştiğinde soru otomatik doğru kalır. Hex sunmak "Option A vs B" gibi sahte alternatifler üretir ve kullanıcıyı DS dışına çıkarır.

Tek istisna: Kullanıcı açıkça "hex değeri göster" isterse debug/troubleshooting bağlamında gösterilebilir, ama UI seçim option'ı olarak DEĞİL.

Hedef Dosya Kuralı (v1.10.0+)

Birden fazla Figma dosyası bağlıyken yazma yapan her çağrıya (figma_execute mutation, figma_create_frame / figma_create_text gibi oluşturma araçları, variable CRUD, prototip araçları) fileKey (veya figmaUrl) ver. Hedefsiz yazma TARGET_REQUIRED hatası döner; hata mesajındaki dosya listesinden doğru fileKey'i seçip tekrar çağır. Hangi dosya olduğu belirsizse kullanıcıya sor — kütüphane dosyalarına (DS, ikon, asset) yanlışlıkla yazma.

EXECUTION_STATE_UNKNOWN veya TIMEOUT dönerse kodu körlemesine tekrar çalıştırma: önce ilgili node'ları okuyup değişikliğin uygulanıp uygulanmadığını doğrula.

Design System Kütüphaneleri

Kullanıcı lokal olarak design system kütüphaneleri kaydedebilir. Kayıtlı kütüphaneler .claude/libraries/ dizininde bulunur.

Kullanım kuralları

1. Skill çalıştırmadan önce .claude/libraries/ dizinini kontrol et. Kayıtlı kütüphane varsa oku.
2. Varsayılan kütüphane: Kullanıcı "hangi kütüphane?" demişse veya context'ten anlaşılamıyorsa, kayıtlı kütüphanelerden ilkini kullan.
3. Figma file key'leri kütüphane dosyasındaki tablolardan al — URL'den parse etme, doğrudan File Key alanını kullan.
4. Token okuma her zaman kütüphanenin WEB/ana dosyasından yapılır.
5. Platform seçimi: Web ekranı → WEB dosyası, Mobil ekran → Mobil dosyası (yoksa WEB fallback).

Design Token Kuralı (TÜM skill'ler için geçerli — ZORUNLU)

Hiçbir skill gömülü/hardcoded design token değeri içeremez ve kullanamaz. Font ailesi, renk kodu, font boyutu, spacing, radius, gölge — hiçbir tasarım değeri skill içine yazılmaz.

Her tasarım değeri çalışma anında tasarım sisteminden okunur:

1. Önce kayıtlı kütüphaneyi oku: .claude/libraries/ dizinindeki kütüphane dosyasını kontrol et. Font ailesi, variable collection'lar ve style listesi orada.
2. Canlı değerleri Figma'dan al:
   • Kütüphane variable'ları (renkler, spacing) → figma_get_library_variables() veya figma_execute ile figma.teamLibrary.getAvailableLibraryVariableCollectionsAsync() + getVariablesInLibraryCollectionAsync() — DS dosyasına bağlanmak GEREKMEZ, hedef dosyadan çalışır
   • Lokal variable'lar → figma_get_variables() — sadece dosya içi değerler
   • Lokal stiller → figma_get_styles() — sadece dosya içi stiller
   • Kütüphane text style'ları → cache'den key al, figma.importStyleByKeyAsync(key) ile import et. Cache yoksa REST API: figma_rest_api GET /v1/files/{fileKey}/styles
   • Font → kütüphane text style'larından veya kütüphanenin Font Ailesi alanından
   • Gölgeler → figma_get_styles() effect style'larından veya kütüphane cache'inden
3. Bulunamazsa kullanıcıya sor.
4. Kullanıcı "sen seç" derse: Önce DS kütüphanesi bağlıysa DS fontunu kullan (text style'lardan çıkar). DS fontu bulunamadıysa Inter, renkler için Figma varsayılanları kullan.

ÖNEMLİ: figma_get_styles() ve figma_get_variables() sadece dosya İÇİ (local) değerleri döndürür. Team library'den gelen token'lar için figma_get_library_variables veya figma.teamLibrary API'si kullanılmalıdır.

Skill'lerdeki kod örnekleri: Örneklerde geçen değerler (renk hex, font adı, piksel boyutu) yalnızca FORMAT gösterimidir. Çalışma anında bu değerler her zaman tasarım sisteminden okunmalıdır.

Bağlı Token Kuralı (ZORUNLU — tüm ekran/bileşen oluşturma işlemlerinde)

Figma'da oluşturulan hiçbir node'da bağlanmamış (unbound) tasarım değeri bulunmamalıdır. Her renk, spacing, padding, radius ve metin stili DS variable'ına veya text style'ına bağlı (bound) olmalıdır.

• Renk (fill/stroke): figma.variables.importVariableByKeyAsync(key) ile import et, setBoundVariableForPaint() ile bağla
• Spacing/padding/radius/gap: setBoundVariable("paddingLeft", variable) ile bağla
• Metin stili: setTextStyleIdAsync(styleId) ile DS text style'ını uygula
• Metin rengi: Text node fill'ini setBoundVariableForPaint() ile bağla

Hardcoded değer kabul edilmez. node.fills = [{ type: "SOLID", color: {r,g,b} }] veya node.fontSize = 16 gibi doğrudan değer atamaları YASAKTIR. Tüm değerler DS'ten import edilip bağlanmalıdır.

Detaylı API kullanımı: figma-canvas-ops skill'inin madde 10 bölümüne bak.

Mevcut kütüphaneler

Kayıtlı kütüphaneleri görmek için .claude/libraries/ dizinini kontrol et. Her .md dosyası bir kütüphanedir. Kütüphane eklemek için /add-library komutunu kullan.

Evolution Triggers

• Yeni DS kural kategorisi eklendiğinde bu skill güncellenmelidir.
• Yeni platform desteği (Flutter, React Native vb.) eklendiğinde platform seçimi kuralları genişletilmelidir.
• Kullanıcı geri bildirimine göre otomatik yanıt kuralları güncellenmelidir.