Kurallar, Agent ve Inline Edit için sistem düzeyinde talimatlar sağlar. Bunları projeleriniz için kalıcı bağlam, tercihler veya iş akışları olarak düşünün. Cursor üç tür kuralı destekler:

Proje Kuralları

.cursor/rules içinde saklanır, sürüm kontrolü altındadır ve kod tabanınıza kapsamlıdır.

Kullanıcı Kuralları

Cursor ortamınızda geneldir. Ayarlarda tanımlanır ve her zaman uygulanır.

.cursorrules (Eski)

Hala desteklenir, ancak kullanımdan kaldırılmıştır. Bunun yerine Proje Kurallarını kullanın.

​
Kurallar nasıl çalışır

Büyük dil modelleri tamamlamalar arasında hafıza tutmazlar. Kurallar, prompt seviyesinde kalıcı ve yeniden kullanılabilir bağlam sağlar. Uygulandığında, kural içerikleri model bağlamının başına dahil edilir. Bu, AI’ya kod üretme, düzenlemeleri yorumlama veya iş akışlarında yardım etme konusunda tutarlı rehberlik sağlar.
Rule applied in context with chat
Kurallar Chat ve Inline Edit için geçerlidir. Aktif kurallar Agent kenar çubuğunda görünür.

​
Proje kuralları

Proje kuralları .cursor/rules dizininde bulunur. Her kural bir dosyadır ve sürüm kontrolü altındadır. Yol desenleri kullanılarak kapsamlandırılabilir, manuel olarak çağrılabilir veya ilgililik temelinde dahil edilebilir. Alt dizinler, o klasöre kapsamlı kendi .cursor/rules dizinlerini içerebilir. Proje kurallarını şunlar için kullanın:
  • Kod tabanınız hakkında alana özgü bilgileri kodlayın
  • Projeye özgü iş akışlarını veya şablonları otomatikleştirin
  • Stil veya mimari kararlarını standartlaştırın

​
Kural anatomisi

Her kural dosyası, metadata ve içeriği destekleyen bir format olan MDC (.mdc) ile yazılır. Kuralların nasıl uygulanacağını, description, globs, alwaysApply özelliklerini değiştiren tür açılır menüsünden kontrol edin.
Kural TürüAçıklama
AlwaysHer zaman model bağlamına dahil edilir
Auto AttachedGlob desenine uyan dosyalar referans alındığında dahil edilir
Agent RequestedAI’ya sunulur, AI dahil edip etmeyeceğine karar verir. Açıklama sağlanmalıdır
ManualYalnızca @ruleName kullanılarak açıkça belirtildiğinde dahil edilir
---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Servisleri tanımlarken dahili RPC desenimizi kullanın
- Servis isimleri için her zaman snake_case kullanın.

@service-template.ts
@service-template.ts gibi referans alınan dosyalar, kural tetiklendiğinde ek bağlam olarak dahil edilir.

​
İç içe kurallar

Kuralları projeniz boyunca .cursor/rules dizinlerine yerleştirerek düzenleyin. İç içe kurallar, dizinlerindeki dosyalar referans alındığında otomatik olarak eklenir. 
project/
  .cursor/rules/        # Proje geneli kurallar
  backend/
    server/
      .cursor/rules/    # Backend'e özgü kurallar
  frontend/
    .cursor/rules/      # Frontend'e özgü kurallar

​
Kural oluşturma

New Cursor Rule komutunu kullanarak veya Cursor Settings > Rules bölümüne giderek kurallar oluşturun. Bu, .cursor/rules dizininde yeni bir kural dosyası oluşturur. Ayarlardan tüm kuralları ve durumlarını görebilirsiniz.
Comparison of concise vs long rules

​
Kural üretme

/Generate Cursor Rules komutunu kullanarak doğrudan konuşmalarda kurallar üretin. Agent davranışı hakkında kararlar verdiğinizde ve bunları yeniden kullanmak istediğinizde faydalıdır.

​
En iyi uygulamalar

İyi kurallar odaklı, uygulanabilir ve kapsamlıdır.
  • Kuralları 500 satırın altında tutun
  • Büyük kuralları birden fazla, birleştirilebilir kurala bölün
  • Somut örnekler veya referans dosyalar sağlayın
  • Belirsiz rehberlikten kaçının. Kuralları açık dahili dokümantasyon gibi yazın
  • Sohbette tekrarlanan komutları kullanırken kuralları yeniden kullanın

​
Örnekler

Sağlayıcılar ve framework’lerden birçok örnek mevcuttur. Topluluk katkılı kurallar, çevrimiçi kitle kaynaklı koleksiyonlar ve depolar arasında bulunur.

​
Kullanıcı Kuralları

Kullanıcı kuralları, Cursor Ayarları → Kurallar bölümünde tanımlanan ve tüm projeler genelinde uygulanan global tercihlerdir. Düz metin formatındadırlar ve tercih edilen iletişim tarzını veya kodlama konvansiyonlarını belirlemek için mükemmeldirler: 
Lütfen özlü bir tarzda yanıt verin. Gereksiz tekrarlardan veya dolgu dilinden kaçının.

​
.cursorrules (Eski)

Proje kök dizininizdeki .cursorrules dosyası hala desteklenmektedir ancak kullanımdan kaldırılacaktır. Daha fazla kontrol, esneklik ve görünürlük için Project Rules’a geçiş yapmanızı öneririz.

​
SSS