Cursor Project Rules (.cursor/rules/*.mdc): lokasi dan cara tool membacanya

Project Rules di Cursor adalah file .mdc di .cursor/rules/ yang frontmatter-nya menentukan kapan setiap aturan disertakan. Cursor juga membaca AGENTS.md, serta User Rules dan Team Rules yang ditetapkan di luar repository.

Lokasi

• .cursor/rules/**/*.mdc, subfolder diperbolehkan; file .md biasa di .cursor/rules diabaikan.
• AGENTS.md di direktori root dan subdirektori.
• User Rules, ditetapkan di setelan Cursor.
• Team Rules, ditetapkan di dasbor tim.

Format

Markdown dengan YAML frontmatter; ekstensi .mdc wajib digunakan. alwaysApply: true selalu menyertakan aturan; globs dengan alwaysApply: false menyertakannya saat file yang cocok ada dalam konteks; jika hanya ada description, Agent yang menentukan. Tanpa semua atribut ini, aturan hanya berlaku saat Anda menyebutnya dengan @.

Kunci frontmatter: 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.

Prioritas dan penggabungan

Team Rules, lalu Project Rules, kemudian User Rules. Semua aturan yang berlaku digabungkan; jika terjadi konflik, sumber yang lebih awal diutamakan. Team Rules yang diberlakukan tidak dapat dinonaktifkan. File AGENTS.md bertingkat digabungkan dengan file induknya, dan file yang lebih spesifik diutamakan.

Tool yang membacanya

Tips

• Pisahkan beberapa glob dengan koma di kolom globs.
• Batasi setiap aturan hingga 500 baris dan rujuk file dengan @filename, bukan menyalin isinya.
• Aturan tidak memengaruhi Cursor Tab, dan User Rules tidak berlaku untuk Inline Edit.
• File lama .cursorrules tidak lagi disebut dalam dokumentasi Cursor; pindahkan isinya ke .cursor/rules/.

File instruksi lainnya