Cursor Project Rules (.cursor/rules/*.mdc): konumu ve araçların dosyayı nasıl okuduğu

Cursor Project Rules, her kuralın ne zaman ekleneceğini frontmatter ile belirlediğiniz .cursor/rules/ içindeki .mdc dosyalarıdır. Cursor ayrıca AGENTS.md dosyalarını, depodan ayrı olarak tanımlanan User Rules ve Team Rules kurallarını da okur.

Konumu

• .cursor/rules/**/*.mdc; alt klasörlere izin verilir. .cursor/rules içindeki düz .md dosyaları yok sayılır.
• Kök dizindeki ve iç içe klasörlerdeki AGENTS.md dosyaları.
• Cursor ayarlarında belirlenen User Rules.
• Ekip panosunda belirlenen Team Rules.

Biçim

YAML frontmatter içeren Markdown; .mdc uzantısı zorunludur. alwaysApply: true kuralı her zaman ekler; alwaysApply: false ile birlikte kullanılan globs, eşleşen bir dosya bağlamda olduğunda kuralı ekler; yalnızca description varsa kararı Agent verir. Bunların hiçbiri yoksa kural yalnızca @ ile anıldığında uygulanır.

Frontmatter anahtarları: descriptionglobsalwaysApply

---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

- One component per file, with a named export matching the file name.
- Type props with an interface named after the component plus Props.
- Use the existing CSS modules; no inline style objects.
- Follow @src/components/Button.tsx as the reference pattern.

Öncelik ve birleştirme

Önce Team Rules, ardından Project Rules, sonra User Rules uygulanır. Geçerli tüm kurallar birleştirilir; çakışma durumunda kaynak sıralamasında önde olan geçerlidir. Zorunlu Team Rules devre dışı bırakılamaz. İç içe AGENTS.md dosyaları üst dosyalarıyla birleştirilir; daha belirli olan dosya önceliklidir.

Dosyayı okuyan araçlar

İpuçları

• globs alanında birden fazla glob kalıbını virgülle ayırın.
• Her kuralı 500 satırın altında tutun ve dosyaların içeriğini yapıştırmak yerine dosyalara @filename ile başvurun.
• Kurallar Cursor Tab'i etkilemez; User Rules ise Inline Edit için geçerli değildir.
• Eski .cursorrules dosyası artık Cursor belgelerinde yer almıyor; içeriğini .cursor/rules/ içine taşıyın.

Diğer talimat dosyaları