@atezer/figma-mcp-bridge 1.7.23 → 1.7.25

package/.claude-plugin/plugin.json

@@ -0,0 +1,37 @@
+{
+  "name": "figma-mcp-bridge",
+  "version": "1.7.25",
+  "description": "Figma tasarım verilerini 46 MCP aracı ile AI asistanlarına açar. 19 uzman skill, 8 komut. REST API token gerektirmez, Zero Trust mimarisi.",
+  "author": {
+    "name": "Abdussamed Tezer",
+    "url": "https://github.com/atezer"
+  },
+  "homepage": "https://github.com/atezer/FMCP",
+  "repository": "https://github.com/atezer/FMCP",
+  "license": "MIT",
+  "keywords": [
+    "figma",
+    "mcp",
+    "design",
+    "design-system",
+    "design-tokens",
+    "ui",
+    "claude-code"
+  ],
+  "skills": "./skills/",
+  "commands": "./commands/",
+  "agents": "./agents/",
+  "hooks": "./hooks/hooks.json",
+  "mcpServers": {
+    "figma-mcp-bridge": {
+      "command": "npx",
+      "args": ["-y", "@atezer/figma-mcp-bridge@latest", "figma-mcp-bridge-plugin"]
+    }
+  },
+  "userConfig": {
+    "default_platform": {
+      "description": "Varsayılan hedef platform (web/ios/android)",
+      "sensitive": false
+    }
+  }
+}

package/.cursor-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "figma-mcp-bridge",
+  "version": "1.7.25",
+  "description": "Figma tasarim verilerini genis figma_* MCP araclari ile AI asistanlarina acar. Ayrintili liste: docs/TOOLS.md. REST API token gerektirmez (plugin-only), Zero Trust mimarisi.",
+  "author": {
+    "name": "Abdussamed Tezer"
+  },
+  "homepage": "https://github.com/atezer/FMCP",
+  "repository": "https://github.com/atezer/FMCP",
+  "license": "MIT",
+  "keywords": ["figma", "mcp", "design", "design-system", "design-tokens", "ui", "cursor", "plugin"],
+  "logo": "assets/logo.png",
+  "skills": "./skills/",
+  "commands": "./commands/",
+  "mcpServers": {
+    "figma-mcp-bridge": {
+      "command": "npx",
+      "args": ["-y", "@atezer/figma-mcp-bridge@latest", "figma-mcp-bridge-plugin"]
+    }
+  }
+}

package/CHANGELOG.md

@@ -12,6 +12,36 @@ Bu dosya [Keep a Changelog](https://keepachangelog.com/tr/1.1.0/) biçimine uygu
 
 Bu changelog'a ekleme öncesi sürümlerin tam ayrıntıları için `git log` kullanılabilir.
 
+## [1.7.23] - 2026-04-11
+
+### Refactor: Local Full + Cloudflare Modları Kaldırıldı
+
+Proje artık yalnızca **plugin-only** modunu destekliyor. CDP debug port (9222), Figma REST API ve Cloudflare Workers modları kaldırıldı. ~15.000+ satır kod temizlendi.
+
+**Kaldırılan:**
+- `src/local.ts` — Full local server (CDP + REST + Puppeteer)
+- `src/index.ts` — Cloudflare Workers entry point
+- `src/browser/` — Tüm browser modülleri (Puppeteer, Cloudflare Browser Rendering)
+- `src/cloud-*.ts` — Cloudflare cloud-specific modüller
+- `src/core/figma-tools.ts` — REST API araç kaydı (3,564 satır)
+- `src/core/figma-desktop-connector.ts` — CDP connector (1,391 satır)
+- `src/core/figma-api.ts`, `console-monitor.ts`, `snippet-injector.ts`, `design-system-manifest.ts`, `figma-reconstruction-spec.ts`
+- `src/core/enrichment/` — Tüm enrichment modülleri
+- `tsconfig.cloudflare.json`, `wrangler.jsonc`, `worker-configuration.d.ts`
+- Bağımlılıklar: `@cloudflare/puppeteer`, `agents`, `puppeteer-core`, `wrangler`
+
+**Güncellenen:**
+- `package.json` — main/types → local-plugin-only, bin sadeleştirildi, 3 runtime + 1 dev bağımlılık kaldırıldı
+- `tsconfig.local.json` — Sadece plugin-only + core
+- `scripts/validate-fmcp-skills-tools.mjs` — Kaynak: sadece local-plugin-only.ts
+- `.github/workflows/ci.yml` — local.ts version check kaldırıldı
+- `KURULUM.md`, `CONTRIBUTING.md`, `f-mcp-plugin/README.md`, `f-mcp-plugin/manifest.json`
+- `.cursor/skills/f-mcp/TOOL_MAPPING.md` — 19 kaldırılan araç temizlendi
+- `src/core/types/index.ts` — Kullanılmayan tipler kaldırıldı
+- `src/core/config.ts` — Browser/console/screenshot config kaldırıldı
+
+**Korunan:** 46 MCP aracı, 19 skill, plugin bridge (WebSocket 5454), audit log
+
 ## [1.7.19] - 2026-04-10
 
 ### Fix: `figma_create_frame` Otomatik Pozisyonlama

package/README.md

@@ -51,7 +51,7 @@ Kurulum tek seferlik. Sonrasında **Claude Desktop'ı** açın — tıpkı Claud
 |------|-------------------|-----|
 | **Claude Desktop** (masaüstü uygulaması) | ✅ | Sohbet arayüzü — günlük kullanım için önerilen |
 | **Claude Code** (terminal uygulaması) | ✅ | Kod yazma ve geliştirme için |
-| **Cursor** | ✅ | Kod editörü — geliştirciler için |
+| **Cursor** | ✅ | Kod editörü — geliştiriciler için |
 | **Claude Chat** (claude.ai web) | ❌ | Web tarayıcısı Figma plugin'ine erişemez |
 
 ---
@@ -128,7 +128,8 @@ Daha fazla: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
 ## Teknik detaylar
 
 - **46 araç** — tasarım okuma, bileşen oluşturma, variable yönetimi, export ([tam liste](docs/TOOLS_FULL_LIST.md))
-- **17 skill** — token pipeline, ekran üretimi, erişilebilirlik denetimi, kod üretimi ([test raporu](docs/TEST_REPORT.md))
+- **20 skill** — token pipeline, ekran üretimi, erişilebilirlik denetimi, kod üretimi, DS denetim ([skill dizini](skills/SKILL_INDEX.md))
+- **3 otonom agent** — DS denetim, token senkronizasyon, ekran oluşturma (Claude Code)
 - **Çoklu dosya + çoklu AI aracı** — Claude, Cursor ve Claude Code aynı anda çalışır
 - **Figma Desktop + Tarayıcı** — Her ikisinde de çalışır
 - **Gizlilik** — Veriler bilgisayarınızdan çıkmaz, internetsiz (air-gap) ortamlarda çalışır
@@ -138,7 +139,7 @@ Daha fazla: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
 
 | | |
 |---|---|
-| Güncel sürüm | **1.7.14** ([CHANGELOG](CHANGELOG.md) · [Releases](https://github.com/atezer/FMCP/releases)) |
+| Güncel sürüm | **1.7.25** ([CHANGELOG](CHANGELOG.md) · [Releases](https://github.com/atezer/FMCP/releases)) |
 | npm | [@atezer/figma-mcp-bridge](https://www.npmjs.com/package/@atezer/figma-mcp-bridge) |
 | Lisans | MIT — kişisel ve ticari kullanıma açık |
 

package/agents/ds-auditor.md

@@ -0,0 +1,29 @@
+---
+name: ds-auditor
+description: Figma ekranlarını design system uyumu açısından otonom olarak denetler, DS uyum raporu üretir. "DS audit yap", "design system kontrolü", "ekranı denetle" ifadeleriyle tetiklenir.
+model: sonnet
+maxTurns: 30
+---
+
+# DS Auditor — Design System Uyumluluk Denetim Ajanı
+
+Sen F-MCP DS Auditor ajanısın. Görevin Figma ekranlarını design system uyumu açısından otonom olarak denetlemek ve kapsamlı bir rapor üretmektir.
+
+## Görev
+
+1. **Bağlantı kontrolü:** `figma_get_status()` ile Figma plugin bağlantısını doğrula.
+2. **Hedef tespiti:** Kullanıcıdan hangi ekran/frame'in denetleneceğini öğren veya mevcut sayfadaki tüm frame'leri tara.
+3. **Denetim:** `audit-figma-design-system` skill'indeki adımları uygula:
+   - DS bileşen kullanımı (instance vs local)
+   - Token bağlantıları (bound vs unbound)
+   - Stil tutarlılığı (text style, color style)
+   - Spacing/padding uyumu
+4. **Raporlama:** Bulgularını yapılandırılmış markdown formatında sun.
+5. **Öneriler:** Her bulgu için düzeltme önerisi ver (hangi skill kullanılmalı: fix-figma-design-system-finding veya apply-figma-design-system).
+
+## Kurallar
+
+- Sadece okuma işlemleri yap — hiçbir şeyi değiştirme.
+- Her tasarım değerini DS'ten doğrula: hardcoded değer = FAIL.
+- Raporu Türkçe yaz.
+- CI ortamında JSON formatı kullan.

package/agents/screen-builder.md

@@ -0,0 +1,29 @@
+---
+name: screen-builder
+description: Açıklama veya koddan Figma ekranı oluşturur, DS bileşenlerini kullanır. "Figma'da ekran oluştur", "ekran tasarla", "generate screen" ifadeleriyle tetiklenir.
+model: sonnet
+maxTurns: 40
+---
+
+# Screen Builder — Figma Ekran Oluşturma Ajanı
+
+Sen F-MCP Screen Builder ajanısın. Görevin açıklama, wireframe veya koddan Figma'da tam ekran oluşturmaktır.
+
+## Görev
+
+1. **Bağlantı kontrolü:** `figma_get_status()` ile Figma plugin bağlantısını doğrula.
+2. **DS hazırlık:** Kayıtlı kütüphaneyi kontrol et (`.claude/libraries/`), yoksa `figma_search_components()` ile DS bileşenlerini tara.
+3. **Token okuma:** `figma_get_variables()` ve `figma_get_styles()` ile tasarım token'larını al.
+4. **Ekran oluşturma:** `generate-figma-screen` skill'indeki adımları uygula:
+   - DS bileşen instance'ları kullan (hardcoded shape YASAK)
+   - Tüm değerleri DS variable'larına bağla
+   - Auto-layout ile responsive yapı kur
+5. **Doğrulama:** `figma_capture_screenshot()` ile sonucu göster ve kullanıcı onayı al.
+
+## Kurallar
+
+- `figma-canvas-ops` kurallarını her `figma_execute` öncesi uygula.
+- Hardcoded renk/boyut/font YASAK — tümü DS'ten bağlanmalı.
+- Her node'da DS variable bağlantısı zorunlu.
+- Brand profile varsa (`.fmcp-brand-profile.json`) oku ve uygula.
+- Raporu ve tüm iletişimi Türkçe yap.

package/agents/token-syncer.md

@@ -0,0 +1,26 @@
+---
+name: token-syncer
+description: Figma design token'larını kod dosyalarıyla senkronize eder (CSS/Tailwind/Swift/Compose). "Token'ları senkronla", "export tokens", "token pipeline" ifadeleriyle tetiklenir.
+model: sonnet
+maxTurns: 20
+---
+
+# Token Syncer — Design Token Senkronizasyon Ajanı
+
+Sen F-MCP Token Syncer ajanısın. Görevin Figma variable'larını ve stil'lerini kod tarafındaki token dosyalarıyla senkronize etmektir.
+
+## Görev
+
+1. **Bağlantı kontrolü:** `figma_get_status()` ile Figma plugin bağlantısını doğrula.
+2. **Token okuma:** `figma_get_variables()` ve `figma_get_styles()` ile mevcut token'ları çek.
+3. **Platform tespiti:** Hedef platformu belirle (Web: CSS/Tailwind/Sass, iOS: Swift, Android: Compose/XML).
+4. **Senkronizasyon:** `design-token-pipeline` skill'indeki adımları uygula:
+   - Figma → Kod (export)
+   - Kod → Figma (import — opsiyonel)
+5. **Doğrulama:** Oluşturulan dosyaları kontrol et.
+
+## Kurallar
+
+- Hardcoded token değeri YASAK — tümü Figma'dan okunmalı.
+- Mevcut token dosyası varsa üzerine yazmadan önce diff göster.
+- Raporu Türkçe yaz.

package/commands/add-library.md

@@ -0,0 +1,122 @@
+# Tasarım Sistemi Kütüphanesi Ekle
+
+Kullanıcı "kütüphane ekle", "library ekle", "tasarım sistemi ekle", "design system ekle" dediğinde bu komutu uygula.
+
+## Akış
+
+### Adım 1 — Bilgi topla
+
+Kullanıcıdan şu bilgileri iste. Eksik olan her şeyi sor, tahmin etme:
+
+**Zorunlu:**
+
+1. **Kütüphane adı** — Kısa isim (örn: SUI, Primer, Carbon)
+2. **Ana Figma dosyası URL'si** — Bileşenler + variables + styles içeren dosya. En az 1 tane olmalı.
+
+**İsteğe bağlı (varsa sor):**
+
+3. **Mobil dosyası URL'si** — Mobil platforma özel bileşenler varsa
+4. **İkon dosyası URL'si** — Ayrı bir ikon kütüphanesi varsa
+5. **Asset dosyası URL'si** — Logo, illüstrasyon gibi varlıklar varsa
+6. **Diğer dosyalar** — Başka Figma dosyası varsa (tema, dokümantasyon, vb.)
+
+Her dosya için kullanıcıya sor: **"Bu dosyada ne var? Kısa açıklama verin."**
+
+### Adım 2 — Figma dosyalarını tara
+
+Her dosya için sırayla:
+
+1. `figma_get_status()` — Plugin bağlı mı kontrol et. Bağlı değilse kullanıcıdan Figma'da plugini açmasını iste.
+2. `figma_get_design_system_summary(fileKey)` — Component set/component sayıları, variable collection adları
+3. `figma_get_variables(fileKey, verbosity: "inventory")` — Variable grupları (inventory büyükse Python ile parse et, sadece grup adı + sayı çıkar)
+4. `figma_get_styles(fileKey, verbosity: "summary")` — Paint, text, effect style listesi
+5. `figma_search_components(fileKey, currentPageOnly: false, limit: 200)` — Tüm bileşen adları ve key'leri
+6. `figma_get_file_data(fileKey, depth: 1, verbosity: "summary")` — Sayfa yapısı
+7. **Font ailesi çıkarma (ZORUNLU):** Ana/WEB dosyasındaki text style'lardan font ailesini belirle. `figma_get_styles` sonucundaki text style ID'lerinden birini seç, `figma_execute` ile font bilgisini oku:
+   ```js
+   const style = await figma.getStyleByIdAsync("TEXT_STYLE_ID");
+   const font = style.fontName; // { family: "...", style: "..." }
+   return { fontFamily: font.family, fontStyle: font.style };
+   ```
+   Sonucu kütüphane dosyasının "Genel Bilgi" bölümüne `Font Ailesi` olarak yaz. Bu bilgi tüm skill'ler tarafından font seçiminde kullanılır.
+
+### Adım 3 — Kütüphane dosyası oluştur
+
+`.claude/libraries/{kütüphane-adı-küçük-harf}.md` dosyasını oluştur.
+
+Dosya formatı şablonu:
+
+```markdown
+# {Kütüphane Adı} — {Açıklama}
+
+## Genel Bilgi
+
+- **Adı:** {Kütüphane Adı}
+- **Font Ailesi:** {text style'lardan çıkarılan font ailesi, ör: "Source Sans Pro"}
+- **Gizlilik:** Lokal — repo'ya dahil edilmez, paylaşılmaz.
+- **Son tarama:** {tarih}
+
+---
+
+## {N}. {Dosya Açıklaması}
+
+| Alan | Değer |
+|------|-------|
+| **Dosya Adı** | {Figma dosya adı} |
+| **File Key** | `{fileKey}` |
+| **Node ID** | `{nodeId}` |
+| **URL** | {tam URL} |
+
+### Sayısal Özet
+
+(figma_get_design_system_summary sonuçları — tablo olarak)
+
+### Variable Collection'lar
+
+(varsa — collection adı, sayı, açıklama tablosu)
+
+### Variable Grupları
+
+(varsa — top-level grup adı ve sayı tablosu)
+
+### Text/Effect/Paint Style'lar
+
+(varsa — hiyerarşik liste)
+
+### Bileşen Sayfaları
+
+(sayfa adı → bileşen adları tablosu, deprecated ve WIP işaretleri ayrı)
+
+---
+
+## Skill Talimatları
+
+(hangi dosyadan ne okunacak, platform seçimi kuralları, import yöntemi)
+```
+
+### Adım 4 — Sistem dosyalarını güncelle
+
+1. **`.gitignore`** — `.claude/libraries/` satırı yoksa ekle
+2. **`project-context.md`** — "Design System Kütüphaneleri" bölümündeki tabloya yeni satır ekle. Bölüm yoksa oluştur.
+
+### Adım 5 — Kullanıcıya bildir
+
+Kısa özet ver:
+
+> ✅ {Kütüphane Adı} eklendi.
+>
+> **Taranan dosyalar:** {N} dosya
+> **Bileşen:** {toplam component set} set, {toplam component} component
+> **Variable:** {toplam} token ({collection sayısı} collection)
+> **Style:** {paint} paint, {text} text, {effect} effect
+>
+> Skill'ler artık {Kütüphane Adı}'yı varsayılan kütüphane olarak tanıyor.
+
+## Kurallar
+
+- Kullanıcıya teknik terim açıklama. "File key", "node ID" gibi kavramları sen çöz, URL'den parse et.
+- Figma plugini bağlı değilse nazikçe "Figma'da {dosya adı} dosyasını açıp F-MCP pluginini çalıştırın" de.
+- Tarama sırasında hata alırsan kullanıcıya hangi dosyada sorun olduğunu bildir, diğerlerine devam et.
+- Variable verisi çok büyükse (>50K karakter) Python ile parse et, tüm veriyi context'e yükleme.
+- Deprecated (⛔️) ve WIP (⌛️) bileşenleri ayrı listele.
+- Her dosyayı taradıktan sonra ilerlemeyi bildir: "✅ {dosya adı} tarandı. Sıradaki: {sonraki dosya}"

package/commands/ds-add.md

@@ -0,0 +1,255 @@
+# Design System Ekle (Akıllı Tespit)
+
+Kullanıcı bir Figma linki ile yeni tasarım sistemi eklemek istediğinde bu komutu kullan. Bu komut yeni ekleme ve güncelleme arasındaki farkı otomatik tespit eder.
+
+## Argüman
+$ARGUMENTS
+
+Argüman olabilir:
+- Tek Figma linki
+- Birden fazla Figma linki (boşlukla ayrılmış)
+- Boş (kullanıcıdan iste)
+
+---
+
+## Adım 1: Argüman Kontrolü
+
+- `$ARGUMENTS` boşsa → kullanıcıya şöyle de: "Hangi Figma linkini eklemek istersin? Lütfen yapıştır."
+- Link(ler) varsa → regex ile file key(ler)'i çıkar: `figma\.com/design/([a-zA-Z0-9]+)`
+- Geçersiz link varsa → "Bu Figma linki gibi durmuyor. Format: https://figma.com/design/..."
+
+---
+
+## Adım 2: Her File Key İçin Figma Analizi
+
+Her file key için **paralel** çağrı yap:
+
+1. `mcp__figma-mcp-bridge__figma_list_connected_files` → bağlı mı kontrol et
+   - Bağlı DEĞİLSE → DUR ve kullanıcıya talimat:
+     ```
+     ❌ Bu Figma dosyası plugin'e bağlı değil.
+     Lütfen:
+     1. Figma'da dosyayı aç
+     2. F-MCP Bridge plugin'i çalıştır (Plugins → F-MCP ATezer Bridge)
+     3. Sonra tekrar dene
+     ```
+
+2. `mcp__figma-mcp-bridge__figma_get_file_data` (verbosity: "summary") → dosya adını al
+
+3. `mcp__figma-mcp-bridge__figma_get_variables` (verbosity: "summary") → token sayısı
+4. `mcp__figma-mcp-bridge__figma_get_styles` (verbosity: "summary") → stil sayısı
+5. `mcp__figma-mcp-bridge__figma_search_components` (query: "", currentPageOnly: false, limit: 500) → bileşen sayısı
+
+**Hata yönetimi:** Her çağrı için try-catch. Başarısız olanı "0" say ama diğerlerine devam.
+
+---
+
+## Adım 3: Mevcut Kütüphane Tespiti
+
+`.claude/design-systems/` altındaki tüm `_meta.md` dosyalarını oku ve bu yeni file key(ler) ile karşılaştır.
+
+### Kontrol 1: File Key Eşleşmesi (Kesin)
+Bu file key zaten bir kütüphanede kayıtlı mı?
+
+**Varsa:**
+```
+📋 Bu Figma dosyası zaten "<library-name>" kütüphanesinde kayıtlı.
+Son güncelleme: <tarih>
+
+Güncellemek ister misin? (evet / iptal)
+```
+- evet → `/ds-sync <library-name>` mantığı uygulanır, DUR.
+- iptal → İşlem sonlandırılır.
+
+### Kontrol 2: İsim Eşleşmesi (Tam)
+`.claude/design-systems/<normalized-name>/` dizini var mı?
+
+**Varsa:**
+```
+⚠️ "<name>" adında bir kütüphane zaten var, ama farklı bir Figma dosyası.
+
+Seçenekler:
+1. Mevcut <name>'i bu yeni dosyayla değiştir
+2. Farklı isimle ekle (örn: <name>-v2)
+3. İptal
+
+Hangisi?
+```
+
+### Kontrol 3: Fuzzy İsim Eşleşmesi
+Benzer isim var mı? (ör: "sui" vs "sui-mobile") Karşılaştırma: normalized isimde substring kontrolü.
+
+**Varsa:**
+```
+🔍 "<new-name>" dosyasını buldum.
+Mevcut "<existing-name>" kütüphanen var. Bu onunla ilgili mi?
+
+Seçenekler:
+1. Mevcut <existing-name>'e ek kaynak (source) olarak ekle → mobile.md / icons.md gibi section'a yazılır
+2. Ayrı <new-name> kütüphanesi olarak ekle
+3. İptal
+
+Hangisi?
+```
+
+### Kontrol 4: Hiç Eşleşme Yok
+Yeni kütüphane olarak ekleme akışına geç (Adım 4).
+
+---
+
+## Adım 4: Yeni Kütüphane Ekleme Akışı
+
+### 4a. İçerik Analizi ve Section Tespiti
+
+Figma analiz sonuçlarına göre hangi section'ların oluşturulacağına karar ver:
+
+```python
+# Pseudo-code
+sections = []
+if variables > 0 or styles > 0:
+    sections.append("tokens")
+
+# Bileşen isimlerini analiz et
+component_names = [... figma_search_components sonucu ...]
+icon_count = count names matching [r'^\.?icon', r'^flag_', r'\.ikon_', r'/icon']
+mobile_count = count names matching [r'mobile', r'mobil', r'iOS', r'android', r'bottom.?sheet']
+asset_count = count names matching [r'logo', r'illustration', r'grafik']
+
+if icon_count > 20:
+    sections.append("icons")
+if mobile_count > 5:
+    sections.append("mobile")
+if asset_count > 3:
+    sections.append("assets")
+
+# Her zaman components (ikon/asset hariç)
+non_special_count = len(component_names) - icon_count - asset_count
+if non_special_count > 5:
+    sections.append("components")
+```
+
+### 4b. ID ve İsim Önerisi
+
+- Dosya adını kebab-case'e çevir: "Material UI" → "material-ui"
+- Rezerve isimler: `_config`, `_README`, `commands`, `hooks` → kullanma
+- ID regex kontrolü: `^[a-z][a-z0-9-]{1,30}$`
+- Geçersizse normalize et veya kullanıcıya sor
+
+### 4c. Kullanıcıya Özet Göster
+
+```
+📊 Analiz Sonucu:
+
+Dosya: <file_name>
+Önerilen ID: <id>
+Ad: <display_name>
+
+Bulunan içerik:
+✅ Tokens: <N> variable, <M> style
+✅ Components: <K> bileşen
+✅ Icons: <L> ikon (ayrı section)
+ℹ️ Mobile: bulunamadı
+
+Oluşturulacak dosyalar:
+• _meta.md
+• tokens.md
+• components.md
+• icons.md
+
+Bu şekilde kaydetmek istiyor musun? (evet / değiştir / iptal)
+```
+
+### 4d. Onay Sonrası
+
+1. **Dizin oluştur:** `mkdir -p .claude/design-systems/<id>`
+
+2. **`_meta.md` yaz** (kaynak-section eşleştirme ile):
+```markdown
+# <display_name> — Meta
+
+## Kaynaklar (Source-to-Section Eşleştirme)
+| Source ID | Figma File Key | File Name | Yazılan Section'lar |
+|-----------|----------------|-----------|----------------------|
+| main      | <file_key>     | <name>    | tokens.md, components.md |
+
+## Sync Durumu
+- **Son başarılı sync:** (henüz yapılmadı)
+- **Durum:** 🆕 BEKLEMEDE
+- **Eksik section'lar:** tokens, components, icons, mobile
+- **Devam komutu:** `/ds-sync <id>`
+
+## İstatistikler
+- Token sayısı: 0
+- Bileşen sayısı: 0
+- İkon sayısı: 0
+
+## Sync Geçmişi
+- (boş)
+```
+
+3. **İlk sync başlat:** `/ds-sync <id>` mantığını çalıştır (ayrı komut dosyası).
+
+4. **project-context.md güncelle:** DS kurallar bölümü zaten genel kural içeriyorsa dokunma. Sadece kütüphane özelinde bir not gerekmez; kural otomatik uygulanır.
+
+5. **Kullanıcıya rapor:**
+```
+✅ <display_name> eklendi.
+📂 .claude/design-systems/<id>/
+📊 İlk sync başlatılıyor (tahmini süre: <N> dakika)...
+```
+
+---
+
+## Adım 5: Çoklu Kaynak İşleme (Fuzzy Match Seçeneği 1)
+
+Kullanıcı benzer isimde mevcut bir kütüphaneye kaynak eklemek isterse:
+
+1. Mevcut `_meta.md`'yi oku
+2. "Kaynaklar" tablosuna yeni satır ekle
+3. Yeni kaynağın içerik analizini yap
+4. Hangi section'a yazılacağını belirle (örn: "mobile" isimdeki dosya → mobile.md)
+5. `_meta.md`'de section listesini güncelle
+6. Sadece o section için sync başlat (`/ds-sync <existing> mobile`)
+
+---
+
+## Adım 6: Çoklu Link Tek Seferde (Senaryo E)
+
+Kullanıcı birden fazla link verirse:
+
+1. Her link için Adım 2'yi uygula (paralel)
+2. Dosya adlarını kullanıcıya göster:
+```
+🔍 3 Figma dosyası tespit ettim:
+1. Material UI
+2. Material UI Icons
+3. Material UI Themes
+
+Bu 3'ü AYNI kütüphane olarak mı (tek 'material-ui') yoksa AYRI ayrı mı ekleyeyim?
+(aynı / ayrı / iptal)
+```
+3. Cevaba göre:
+   - "aynı" → tek kütüphane, 3 kaynak
+   - "ayrı" → 3 ayrı kütüphane (her biri için Adım 4)
+
+---
+
+## Hata Mesajları
+
+| Hata | Kullanıcıya |
+|------|-------------|
+| Link yok | "Hangi Figma linkini eklemek istersin?" |
+| Geçersiz link | "Bu Figma linki gibi durmuyor. Format: https://figma.com/design/..." |
+| Bağlı değil | Adım 2'deki bağlantı talimatı |
+| Boş dosya | "Bu dosyada hiçbir tasarım sistemi öğesi bulamadım. Link doğru mu?" |
+| Permission denied | "Bu dosyaya erişim izninizin olmadığı görünüyor. Figma hesabınızı kontrol edin." |
+| API timeout | "Figma yanıt vermiyor. Bağlantıyı kontrol edip tekrar dene." |
+
+---
+
+## Doğal Dil Desteği
+
+Kullanıcı slash command kullanmasa bile bu komuttaki mantığı uygula:
+- "Material UI kütüphanesini ekle: <link>" → bu komutun mantığı
+- "Şu linkdeki tasarım sistemini ekle: <link>" → bu komutun mantığı
+- "<link> bunu ekle" → bu komutun mantığı