Project Rules
.cursor/rules
içinde saklanır, sürüm kontrolünde tutulur ve kod tabanına özelleştirilir.User Rules
Cursor ortamında geneldir. Ayarlarda tanımlanır ve her zaman uygulanır.
AGENTS.md
Agent talimatları markdown formatında.
.cursor/rules
için basit bir alternatif..cursorrules (Legacy)
Hâlâ destekleniyor ama kullanım dışı. Bunun yerine Project Rules kullan.
Kurallar nasıl çalışır

Kurallar Chat ve Inline
Edit için geçerlidir. Etkin kurallar Agent kenar çubuğunda görünür.
Proje kuralları
.cursor/rules
içinde bulunur. Her kural bir dosyadır ve sürüm kontrolü altındadır. Yol kalıplarıyla kapsamlanabilir, elle tetiklenebilir ya da ilgililik durumuna göre dahil edilebilir. Alt dizinler, yalnızca o klasöre uygulanacak şekilde kapsamlanan kendi .cursor/rules
dizinlerini barındırabilir.
Proje kurallarını şunlar için kullan:
- Kod tabanına ilişkin alan-özel bilgiyi kodlamak
- Projeye özgü iş akışlarını veya şablonları otomatikleştirmek
- Stil veya mimari kararları standartlaştırmak
Kural yapısı
.mdc
) formatında yazılır. description
, globs
, alwaysApply
özelliklerini değiştiren tür açılır menüsünden kuralların nasıl uygulanacağını kontrol et.
Kural Türü | Açıklama |
---|---|
Always | Model bağlamına her zaman eklenir |
Auto Attached | Glob desenini eşleyen dosyalara referans verildiğinde eklenir |
Agent Requested | Dahil edilip edilmeyeceğine AI karar verir. Bir açıklama sağlanmalıdır |
Manual | Yalnızca @ruleName kullanılarak açıkça belirtildiğinde eklenir |
İç içe kurallar
.cursor/rules
dizinlerine yerleştirerek düzenle. Kendi dizinlerindeki dosyalar referans alındığında, iç içe kurallar otomatik olarak uygulanır.
Kural oluşturma
New Cursor Rule
komutunu kullanarak veya Cursor Settings > Rules
bölümüne giderek kural oluştur. Bu, .cursor/rules
içinde yeni bir kural dosyası oluşturur. Ayarlardan tüm kuralları ve durumlarını görebilirsin.

Kurallar oluşturma
/Generate Cursor Rules
komutunu kullanarak kuralları doğrudan oluştur. Aracın davranışıyla ilgili kararlar verdiğinde ve bunları yeniden kullanmak istediğinde işine yarar.
En iyi uygulamalar
- Kuralları 500 satırın altında tut
- Büyük kuralları birden çok, birleştirilebilir kurala böl
- Somut örnekler ya da referans verilen dosyalar ekle
- Belirsiz yönlendirmelerden kaçın. Kuralları net iç dokümanlar gibi yaz
- Sohbette tekrarlayan istemlerde kuralları yeniden kullan
Örnekler
Frontend bileşenleri ve API doğrulaması için standartlar
Frontend bileşenleri ve API doğrulaması için standartlar
Bu kural, frontend bileşenleri için standartlar sunar:components dizininde çalışırken:
- Stil için her zaman Tailwind kullan
- Animasyonlar için Framer Motion kullan
- Bileşen adlandırma kurallarına uy
- Tüm doğrulamalar için zod kullan
- Dönüş tiplerini zod şemalarıyla tanımla
- Şemalardan üretilen tipleri dışa aktar
Express servisleri ve React bileşenleri için şablonlar
Express servisleri ve React bileşenleri için şablonlar
Bu kural, Express servisleri için bir şablon sağlar:Express servisi oluştururken bu şablonu kullan:
- RESTful ilkeleri takip et
- Hata yakalama middleware’i ekle
- Doğru loglamayı yapılandır
- En üstte Props arayüzü
- Bileşen named export olarak
- En altta stiller
Geliştirme iş akışlarının otomasyonu ve dokümantasyon üretimi
Geliştirme iş akışlarının otomasyonu ve dokümantasyon üretimi
Bu kural, uygulama analizini otomatikleştirir:Uygulamayı analiz etmen istendiğinde:
npm run dev
ile geliştirme sunucusunu çalıştır- Konsoldan logları al
- Performans iyileştirmeleri öner
- Kod yorumlarını çıkar
- README.md dosyasını analiz et
- Markdown dokümantasyonu üret
Cursor’da yeni bir ayar ekleme
Cursor’da yeni bir ayar ekleme
İlk olarak Uygulamada kullanmak için reactiveStorageService’i içe aktar ve özelliği kullan:
@reactiveStorageTypes.ts
içinde aç/kapa yapılacak bir özellik (property) oluştur.@reactiveStorageService.tsx
içindeki INIT_APPLICATION_USER_PERSISTENT_STORAGE
içine varsayılan değeri ekle.Beta özellikleri için toggle’ı @settingsBetaTab.tsx
içine, diğer durumlarda @settingsGeneralTab.tsx
içine ekle. Toggle’lar, genel onay kutuları için <SettingsSubSection>
olarak eklenebilir. Örnekler için dosyanın geri kalanına bak.AGENTS.md
AGENTS.md
, ajan talimatlarını tanımlamak için basit bir markdown dosyasıdır. Basit kullanım senaryoları için .cursor/rules
’a alternatif olarak proje kök dizinine yerleştir.
Project Rules’dan farklı olarak AGENTS.md
, meta veri veya karmaşık yapılandırmalar içermeyen düz bir markdown dosyasıdır. Yapılandırılmış kuralların ek yükü olmadan basit ve okunabilir talimatlara ihtiyaç duyan projeler için idealdir.
Kullanıcı Kuralları
.cursorrules
(Eski)
.cursorrules
dosyası hâlâ destekleniyor ama yakında kullanımdan kaldırılacak. Daha fazla kontrol, esneklik ve görünürlük için Project Rules’a geçmeni öneriyoruz.
SSS
Kuralım neden uygulanmıyor?
Kuralım neden uygulanmıyor?
Kural türünü kontrol et.
Agent Requested
için bir açıklama tanımladığından emin ol. Auto Attached
için dosya deseninin referans verilen dosyalarla eşleştiğinden emin ol.Kurallar diğer kurallara veya dosyalara referans verebilir mi?
Kurallar diğer kurallara veya dosyalara referans verebilir mi?
Evet. Kuralının bağlamına dosyaları dahil etmek için
@filename.ts
kullan.Sohbetten kural oluşturabilir miyim?
Sohbetten kural oluşturabilir miyim?
Evet,
/Generate Cursor Rules
komutunu kullanarak sohbetten proje kuralları oluştur. Memories etkinse, Memories otomatik olarak oluşturulur.Kurallar Cursor Tab veya diğer yapay zeka özelliklerini etkiler mi?
Kurallar Cursor Tab veya diğer yapay zeka özelliklerini etkiler mi?
Hayır. Kurallar yalnızca Agent ve Inline Edit için geçerlidir