Kurallar

Yeniden kullanılabilir, kapsamlı yönergelerle Agent modelinin davranışını kontrol et.

Kurallar, Agent ve Inline Edit için sistem düzeyinde yönergeler sağlar. Bunları projelerin için kalıcı bağlam, tercih veya iş akışları olarak düşün.

Cursor dört tür kuralı destekler:

Project Rules

.cursor/rules içinde saklanır, sürüm kontrolündedir ve kod tabanına kapsamlanır.

User Rules

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

AGENTS.md

Markdown formatında Agent yönergeleri. .cursor/rules için basit bir alternatif.

.cursorrules (Legacy)

Hâlâ destekleniyor, ancak kullanımdan kaldırıldı. Bunun yerine Project Rules kullan.

Kurallar nasıl çalışır

Büyük dil modelleri, tamamlamalar arasında belleğe sahip değildir. Kurallar, istem düzeyinde kalıcı, yeniden kullanılabilir bir 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 veya iş akışlarına yardımcı olma konusunda tutarlı bir yönlendirme sağlar.

Kurallar Chat ve Inline Edit 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üne tabidir. Yol desenleriyle kapsamlanabilir, elle çalıştırılabilir ya da ilgililik durumuna göre dahil edilebilir. Alt dizinler, yalnızca o klasöre uygulanacak şekilde kapsamlanan kendi .cursor/rules dizinlerini içerebilir.

Proje kurallarını şunlar için kullan:

• Kod tabanına yönelik alan-özgü bilgiyi kodlamak
• Projeye özgü iş akışlarını veya şablonları otomatikleştirmek
• Stil veya mimari kararları standartlaştırmak

Kural anatomisi

Her kural dosyası, üstveri ve içeriği destekleyen MDC (.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	Her zaman model bağlamına dahil edilir
Auto Attached	Bir glob desenine uyan dosyalara referans verildiğinde dahil edilir
Agent Requested	Dahil edilip edilmeyeceğine AI karar verebilir. Bir açıklama sağlamalısın
Manual	Yalnızca @ruleName kullanılarak açıkça anıldığında dahil edilir

---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Servisleri tanımlarken dahili RPC pattern'ımızı kullan
- Servis isimleri için her zaman snake_case kullan.

@service-template.ts

İç içe kurallar

Kuralları, proje genelinde .cursor/rules dizinlerine yerleştirerek düzenle. İç içe kurallar, bulundukları dizindeki dosyalara referans verildiğinde otomatik olarak eklenir.

project/
  .cursor/rules/        # Proje genelindeki kurallar
  backend/
    server/
      .cursor/rules/    # Backend'e özel kurallar
  frontend/
    .cursor/rules/      # Frontend'e özel kurallar

Kural oluşturma

New Cursor Rule komutunu kullanarak ya da Cursor Settings > Rules bölümüne giderek kurallar oluşturabilirsin. Bu işlem, .cursor/rules içinde yeni bir kural dosyası oluşturur. Ayarlar üzerinden tüm kuralları ve durumlarını görebilirsin.

Kurallar oluşturma

Sohbetlerde /Generate Cursor Rules komutuyla doğrudan kurallar oluştur. Aracın davranışıyla ilgili kararlar verdiğinde ve bunları yeniden kullanmak istediğinde işine yarar.

En iyi uygulamalar

İyi kurallar odaklı, uygulanabilir ve net bir kapsamda olur.

• 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önlendirmeden kaçın. Kuralları net iç dokümanlar gibi yaz
• Sohbette tekrarladığın istemlerde kuralları yeniden kullan

Örnekler

Frontend bileşenleri ve API doğrulaması için standartlar

Bu kural, frontend bileşenleri için standartlar getirir:

components dizininde çalışırken:

• Stil için her zaman Tailwind kullan
• Animasyonlar için Framer Motion kullan
• Bileşen adlandırma kurallarına uy

Bu kural, API uç noktalarında doğrulamayı zorunlu kılar:

API dizininde:

• Tüm doğrulamalar için zod kullan
• Dönüş türlerini zod şemalarıyla tanımla
• Şemalardan üretilen türleri dışa aktar

Express servisleri ve React bileşenleri için şablonlar

Bu kural, Express servisleri için bir şablon sunar:

Express servisi oluştururken bu şablonu kullan:

• RESTful ilkeleri takip et
• Hata yakalama middleware’ini ekle
• Doğru loglamayı yapılandır

@express-service-template.ts

Bu kural, React bileşenlerinin yapısını tanımlar:

React bileşenleri şu düzeni izlemeli:

• En üstte Props arayüzü
• Bileşen named export olarak
• En altta stiller

@component-template.tsx

Geliştirme iş akışlarını ve dokümantasyon üretimini otomatikleştirme

Bu kural uygulama analizini otomatikleştirir:

Uygulamanın analiz edilmesi istendiğinde:

1. npm run dev ile geliştirme sunucusunu çalıştır
2. Konsol loglarını al
3. Performans iyileştirmeleri öner

Bu kural dokümantasyon üretimine yardımcı olur:

Dokümantasyon taslağına şu şekilde yardımcı ol:

• Kod yorumlarını çıkar
• README.md dosyasını analiz et
• Markdown dokümantasyonu üret

Cursor’da yeni bir ayar ekleme

Önce @reactiveStorageTypes.ts içinde aç/kapa yapılacak bir özellik oluştur.

@reactiveStorageService.tsx içindeki INIT_APPLICATION_USER_PERSISTENT_STORAGE’a varsayılan değeri ekle.

Beta özellikler için toggle’ı @settingsBetaTab.tsx içine, aksi halde @settingsGeneralTab.tsx içine ekle. Genel onay kutuları için toggle’lar <SettingsSubSection> olarak eklenebilir. Örnekler için dosyanın geri kalanına bak.

<SettingsSubSection
				label="Your feature name"
				description="Your feature description"
				value={
					vsContext.reactiveStorageService.applicationUserPersistentStorage
						.myNewProperty ?? false
				}
				onChange={(newVal) => {
					vsContext.reactiveStorageService.setApplicationUserPersistentStorage(
						'myNewProperty',
						newVal
					);
				}}
			/>

Uygulamada kullanmak için reactiveStorageService’i içe aktar ve özelliği kullan:

const flagIsEnabled = vsContext.reactiveStorageService.applicationUserPersistentStorage.myNewProperty

Sağlayıcılar ve framework’lerden birçok örnek mevcut. Topluluk katkılı kurallar, çevrimiçi kitle kaynaklı koleksiyonlar ve depolarda bulunabilir.

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üne yerleştir.

Project Rules’tan farklı olarak, AGENTS.md meta veri ya da 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

Kullanıcı Kuralları

Kullanıcı kuralları, tüm projelerde geçerli olan ve Cursor Settings → Rules bölümünde tanımlanan genel tercihlerdir. Düz metin şeklindedir ve tercih ettiğin iletişim tarzını ya da kodlama kurallarını belirlemek için idealdir:

Please reply in a concise style. Avoid unnecessary repetition or filler language.

.cursorrules (Eski)

Proje kökündeki .cursorrules dosyası hâlâ destekleniyor, ancak 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 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?

Evet. Kuralının bağlamına dosyaları dahil etmek için @filename.ts kullan.

Sohbetten kural oluşturabilir miyim?

Evet, sohbetten /Generate Cursor Rules komutunu kullanarak proje kuralları oluşturabilirsin. Memories etkinse, anılar otomatik olarak oluşturulur.

Kurallar Cursor Tab’i veya diğer yapay zeka özelliklerini etkiler mi?

Hayır. Kurallar yalnızca Agent ve Inline Edit için geçerlidir