Cursor ルールの設定: Project・User・Team Rules、.mdc frontmatter、globs、AGENTS.md

• Project Rules: .cursor/rules 内の .mdc ファイル。バージョン管理され、コードベースにスコープされます。サブフォルダにも対応しています。
• User Rules: Cursor のルール設定で設定するグローバルな好み。すべてのプロジェクトに適用されます。
• Team Rules: Team および Enterprise プランで、Cursor ダッシュボードから管理します。
• AGENTS.md: メタデータなしのプレーンな Markdown 指示。

プロジェクトルールには .mdc 拡張子が必須です。.cursor/rules 内のプレーンな .md ファイルはルールシステムに無視されます。

• Always Apply: alwaysApply: true。すべてのチャットセッションに含まれます。
• Apply to Specific Files: alwaysApply: false と globs。一致するファイルがコンテキストにあるときに添付されます。
• Apply Intelligently: alwaysApply: false と description、globs なし。関連があるときに Agent が取り込みます。
• Apply Manually: description も globs もなし。@ メンションしたときだけ使われます。

複数の glob パターンはカンマで区切ります。例えば src/**/*.tsx は src/ 以下の .tsx ファイルに一致します。

---
globs: src/components/**/*.tsx
alwaysApply: false
---

- Use named exports, not default exports
- Keep components under 200 lines
- Prefer composition over prop drilling

---
alwaysApply: true
---

- Read the relevant source files before proposing changes
- Never modify generated files in dist/ or build/

ルール内の @file 参照は、Agent にどこを見るべきかを伝えます。ファイルはインライン展開されないため、常にコンテキストに必要な内容はルール本文に書きます。

• Team および Enterprise プランで利用できます。管理者が Cursor ダッシュボードで作成・管理します。
• Team Rules は自由形式のテキストで、.cursor/rules のフォルダ構造は使いません。
• 各ルールは強制またはオプションにできます。ユーザーは Customize の Team Rules で、強制されていない Team Rule をオフにできます。強制されたルールはそこで無効化できません。
• glob パターンのあるルールは、一致するファイルがコンテキストにあるときだけ適用されます。glob のないルールはすべての会話に適用されます。
• 有効化のチェックボックスをオフのままにすると、ルールを下書きとして保存でき、有効化するまで適用されません。
• 有効な Team Rules は、チームのすべてのリポジトリとプロジェクトで Agent (Chat) のコンテキストに含まれます。

Cursor は、強制ルールであっても、AI へのガイダンスを唯一のセキュリティ対策にすべきではないとしています。

AGENTS.md はプロジェクトのルートに置きます。サブディレクトリ内のネストされた AGENTS.md ファイルは、そのディレクトリで作業するときに適用されます。親ファイルと組み合わされ、より具体的なファイルが優先されます。

• 優先順位は Team Rules、Project Rules、User Rules の順です。すべてのルールはマージされ、競合時は先のものが優先されます。
• User Rules は Agent にのみ適用され、Inline Edit には適用されません。
• ルールは Cursor Tab には影響しません。
• 各ルールは 500 行未満に抑え、大きなルールは小さなルールに分割します。