Figma, tasarım kütüphanelerine Markdown yönergeleri eklemeyi açtı

Figma, 6 Ekim 2026’da Figma Agent’ı genel kullanıma açarken tasarım kütüphaneleri için yeni bir yönerge özelliği de duyurdu. Artık yayımlanmış bir design library’ye Markdown dosyaları eklenebiliyor. Kütüphane etkinleştirilerek Figma Agent’a tasarım yaptırıldığında bu dosyalar ajana otomatik bağlam olarak veriliyor.

Markdown dosyaları ne işe yarıyor?

Bir kütüphanedeki bileşenler, stiller ve değişkenler ajana nelerin mevcut olduğunu gösteriyor. Markdown yönergeleri ise bu parçaların ne zaman ve nasıl kullanılacağını anlatıyor. Bileşen seçimi, varyant tercihleri, yerleşim kuralları, semantik renk ve boşluk değişkenleri, iyi uygulamalar ve kaçınılması gereken kalıplar bu dosyalarda tarif edilebiliyor.

Örneğin bir Button bileşeninin Primary ve Secondary varyantları olduğunu tekrar yazmak yerine, hangi senaryoda Primary seçileceğini ve aynı alanda birden fazla baskın eylemden neden kaçınılacağını açıklamak daha yararlı. Figma da yönergelerin, ajanın kütüphane varlıklarına bakarak çıkaramayacağı karar kurallarına odaklanmasını öneriyor.

Dosyalar kütüphaneye nasıl ekleniyor?

Kütüphaneyi içeren Figma Design dosyasında File → Library → Manage guidelines… menüsü açılıyor. Upload ile bilgisayardan .md, .txt veya .json dosyaları seçiliyor; ardından Apply changes ile işlem tamamlanıyor. Yönergeleri eklemek için dosyada düzenleme yetkisi gerekiyor ve kütüphanenin yayımlanmış olması gerekiyor. Özellik Professional, Organization ve Enterprise planlarında sunuluyor.

Figma, tek bir uzun belge yerine konu bazlı, tekrarsız üç ila sekiz dosya öneriyor. overview.md, components.md, layout.md ve anti-patterns.md olası dosya adları. Önerilen toplam boyut 100 KB’nin altında; teknik üst sınır 200 KB. Yüklenen dosyalar aynı menüden yeniden adlandırılabiliyor, değiştirilebiliyor veya kaldırılabiliyor.

Kapsamı ne?

Bu yönergeler, Figma Design içindeki ilgili kütüphane kullanıldığında Figma Agent’ın bağlamına ekleniyor. Figma Make içindeki yönergeler ayrı yönetiliyor; Design kütüphanesine eklenen dosyalar şu anda Make kit oluşturulurken kullanılmıyor. Yönerge dosyaları ajana daha fazla bağlam verdiği için bir isteğin AI kredisi tüketimini artırabiliyor.

Kaynaklar: Figma sürüm notları · Kütüphaneye yönerge ekleme rehberi · Figma’nın tasarım sistemleri yazısı