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

Project Rules

.cursor/rules dizininde saklanır, sürüm kontrolündedir ve kod tabanına özeldir.

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, ancak kullanım dışı bırakıldı. Bunun yerine Project Rules kullan.

Kurallar nasıl çalışır

Büyük dil modelleri, tamamlamalar arasında belleği korumaz. Kurallar, istem düzeyinde kalıcı ve yeniden kullanılabilir bağlam sağlar. Uygulandığında, kural içeriği model bağlamının başına eklenir. Bu, yapay zekâya kod üretme, düzenlemeleri yorumlama ve iş akışlarına yardımcı olma konularında tutarlı bir yönlendirme sağlar.
Sohbetle bağlamda uygulanmış kural
Kurallar Sohbet ve Satır İçi Düzenleme için geçerlidir. Etkin kurallar Agent kenar çubuğunda görünür.

Proje kuralları

Proje kuralları .cursor/rules içinde yer alır. Her kural bir dosyadır ve sürüm kontrolü altındadır. Yol kalıplarıyla kapsamlanabilir, elle tetiklenebilir veya ilgililiğe göre dahil edilebilir. Alt dizinler, yalnızca o klasöre kapsamlanan kendi .cursor/rules dizinlerini içerebilir. Proje kurallarını şunlar için kullan:
  • Kod tabanına özgü alan bilgisini kodlamak
  • Projeye özgü iş akışlarını veya şablonları otomatikleştirmek
  • Stil veya mimari kararları standartlaştırmak

Kural yapısı

Her kural dosyası, üstveri ve içeriği destekleyen bir format olan MDC (.mdc) ile yazılır. Kuralların nasıl uygulandığını, description, globs, alwaysApply özelliklerini değiştiren tür açılır menüsünden kontrol edersin.
Kural TürüAçıklama
AlwaysModel bağlamına her zaman dahil edilir
Auto AttachedBir glob kalıbıyla eşleşen dosyalar referans alındığında dahil edilir
Agent RequestedAI tarafından erişilebilir; dahil edilip edilmeyeceğine o karar verir. Bir açıklama sağlaman gerekir
ManualYalnızca @ruleName kullanılarak açıkça belirtildiğinde dahil edilir
---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Use our internal RPC pattern when defining services
- Always use snake_case for service names.

@service-template.ts

İç içe kurallar

Kuralları, proje genelinde .cursor/rules dizinlerine yerleştirerek düzenle. İç içe kurallar, dizinlerindeki dosyalar referans alındığında otomatik olarak eklenir.
project/
  .cursor/rules/        # Proje genelindeki kurallar
  backend/
    server/
      .cursor/rules/    # Backend’e özgü kurallar
  frontend/
    .cursor/rules/      # Frontend’e özgü kurallar

Kural oluşturma

Kuralları New Cursor Rule komutunu kullanarak veya Cursor Settings > Rules bölümüne giderek oluştur. Bu işlem .cursor/rules içinde yeni bir kural dosyası yaratır. Ayarlardan tüm kuralları ve durumlarını görebilirsin.
Kısa ve uzun kuralların karşılaştırması

Kurallar üretme

Sohbetlerde doğrudan /Generate Cursor Rules komutunu kullanarak kurallar üretebilirsin. Aracının davranışı hakkında kararlar verdiğinde ve bunları yeniden kullanmak istediğinde işe yarar.

En iyi uygulamalar

İyi kurallar odaklı, uygulanabilir ve net bir kapsamda olmalı.
  • 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 sun
  • Belirsiz yönlendirmelerden kaçın. Kuralları net iç dokümanlar gibi yaz
  • Sohbette tekrar eden istemlerde kuralları yeniden kullan

Örnekler

Sağlayıcılardan ve framework’lerden birçok örnek mevcut. Topluluk katkılı kurallar, çevrimiçi crowdsourced koleksiyonlarda ve depolarda bulunur.

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’tan 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.
# Project Instructions

## Code Style
- Use TypeScript for all new files
- Prefer functional components in React
- Use snake_case for database columns

## Architecture
- Follow the repository pattern
- Keep business logic in service layers

Geçerli sınırlamalar

  • Yalnızca kök düzey: AGENTS.md proje kök dizinine yerleştirilmeli (v1.5)
  • Kapsam yok: Talimatlar projene global olarak uygulanır
  • Tek dosya: .cursor/rules’un aksine, talimatları birden fazla dosyaya bölemezsin
Alt dizinlerde iç içe AGENTS.md desteği v1.6 için planlanıyor.

Kullanıcı Kuralları

Kullanıcı kuralları, tüm projelerde geçerli olan ve Cursor Settings → Rules içinde tanımlanan genel tercihlerdir. Düz metin olarak kaydedilir ve tercih ettiğin iletişim tarzını ya da kodlama kurallarını belirlemek için idealdir:
Lütfen öz ve net yanıt ver. Gereksiz tekrar ve dolgu ifadelerden kaçın.

.cursorrules (Eski)

Proje kök dizinindeki .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