Cursor Project Rules (.cursor/rules/*.mdc): lokalizacja i sposób odczytu przez narzędzia

Reguły projektu Cursor to pliki .mdc w .cursor/rules/, których frontmatter określa, kiedy dana reguła jest dołączana. Cursor odczytuje też AGENTS.md, a także reguły użytkownika i zespołu skonfigurowane poza repozytorium.

Lokalizacja

• .cursor/rules/**/*.mdc; dozwolone są podkatalogi. Zwykłe pliki .md w .cursor/rules są ignorowane.
• AGENTS.md w katalogu głównym i zagnieżdżonych folderach.
• Reguły użytkownika skonfigurowane w ustawieniach Cursor.
• Reguły zespołu skonfigurowane w panelu zespołu.

Format

Markdown z YAML frontmatter; rozszerzenie .mdc jest wymagane. Reguła z alwaysApply: true jest zawsze dołączana. Reguły z globs i alwaysApply: false są dołączane, gdy pasujący plik znajduje się w kontekście. Jeśli podano tylko description, Agent sam decyduje. Gdy nie ustawiono żadnej z tych opcji, reguła obowiązuje tylko wtedy, gdy zostanie wskazana przez @.

Klucze 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.

Priorytety i scalanie

Zasady zespołu, następnie zasady projektu, a na końcu zasady użytkownika. Wszystkie mające zastosowanie zasady są łączone, a w razie konfliktu pierwszeństwo ma wcześniejsze źródło; wymuszonych zasad zespołu nie można wyłączyć. Zagnieżdżone pliki AGENTS.md łączą się z plikami nadrzędnymi, a w razie konfliktu pierwszeństwo ma bardziej szczegółowy plik.

Narzędzia, które go odczytują

Wskazówki

• Rozdzielaj kilka wzorców glob przecinkami w polu globs.
• Każda reguła powinna mieć mniej niż 500 wierszy. Odwołuj się do plików za pomocą @filename zamiast wklejać ich zawartość.
• Reguły nie wpływają na Cursor Tab, a User Rules nie mają zastosowania do Inline Edit.
• Plik .cursorrules nie jest już wymieniany w dokumentacji Cursor. Przenieś go do .cursor/rules/.

Inne pliki z instrukcjami