ルール

ルールを使うと、エージェントにプロジェクトに関する永続的な指示を与えられます。チャットで毎回繰り返し伝えなくても、エージェントはコーディングスタイル、パターン、ワークフローに従えます。

ルールとは？

ルールとは、プロジェクト内で作業する際にエージェントが従う永続的な指示のセットです。ルールはグローバル、プロジェクト単位、または特定のファイルに適用できます。

プロジェクトルールを作成するには？

プロジェクトルールはコードベース内に保存され、バージョン管理されます。git にチェックインすれば、チーム全体で活用できます。

1. コマンドパレットを開きます。
   • Mac: CmdCtrl + Shift + P を押します
   • Windows/Linux: Ctrl + Shift + P を押します
2. 「New Cursor Rule」と入力して選択します
3. ルールに名前を付けます (例: react-patterns)
4. Markdown で指示を記述します。例:
   - 新しいファイルにはすべて TypeScript を使用する- React では関数コンポーネントを優先する- データベースのカラムには snake_case を使用する

5. ルールタイプのドロップダウンから、ルールを適用するタイミングを選択します。
   • 常に適用: すべての会話に含まれます
   • インテリジェントに適用: 関連するかどうかをエージェントが判断します
   • 特定のファイルに適用: パターンに一致するファイルにのみ適用されます (例: *.tsx)
   • 手動で適用: チャットで @メンションした場合にのみ使用されます
6. ファイルを保存します。プロジェクト内の .cursor/rules/ に保存されます。

ユーザールールを設定するには？

ユーザールールは、すべてのプロジェクトに適用されるグローバル設定です。デバイス間でCursor アカウントと同期されます。

1. サイドバーでカスタマイズするを開きます
2. ルールをクリックします
3. 設定を追加します。例：「簡潔なスタイルで返信する。不要な繰り返しは避ける。」

AGENTS.md の使い方

プロジェクトルートに AGENTS.md ファイルを作成し、標準的な Markdown 形式で指示を記述します。Cursor が自動的に読み取ります。

# プロジェクトの指示- 新規ファイルはすべて TypeScript を使用する- データアクセスにはリポジトリパターンに従う- コンポーネントは 200 行以内に収める

ルールを適用するタイミングをより細かく制御するには、代わりに .cursor/rules/ のプロジェクトルールを使用してください。

ルール作成のベストプラクティスは？

• ルールは500行未満に抑えてください。大きなルールは、より小さく目的を絞ったファイルに分割します。
• ルールの内容には、具体例や @filename で参照するファイルを含めてください。
• まずは小さく始めましょう。エージェントが同じ間違いを何度も繰り返すようなら、ルールを追加します。
• チームメイトも活用できるよう、ルールはGitにコミットしてください。

ルールファイルを整理するには？

すべてのルールは、フラットな .cursor/rules/ ディレクトリに配置してください。Cursor はこのフォルダーをスキャンしてルールを検出するため、ネストしたサブフォルダーも使用できますが、フラットな構造のほうがシンプルで管理しやすくなります。ファイルには内容がわかる名前を付けてください (例: react-patterns.mdc、api-validation.mdc) 。

大規模なプロジェクトでは、1 つの長いルールにまとめるのではなく、目的ごとにルールを分けてファイルにしてください。各ファイルでは、スタイル規約、テストパターン、API ガイドラインなど、1 つの関心事のみを扱うようにします。

ルールはどこに保存されますか？

• プロジェクトルール は、プロジェクトフォルダー内の .cursor/rules/ に保存されます。git でバージョン管理されます。
• Cursor の設定の ユーザールール は、Cursor アカウントに保存されます。すべてのプロジェクトに適用され、別のマシンでサインインすると同期されます。
• ~/.cursor/rules (Windows: %USERPROFILE%\.cursor\rules) 内の ユーザールールファイル はマシン上に保持され、同期されません。
• チーム ルール は Cursor のサーバーに保存され、チームダッシュボードから管理されます。すべてのチームメンバーに自動的に同期されます。チーム ルールはグロブパターンに対応しているため、特定のファイル���イプ (例：**/*.py) にルールを適用できます。

ユーザールールとチーム ルールはプロファイルのエクスポートには含まれません。新しいマシンでサインインすると、アカウントのユーザールールが同期されます。

チーム ルールの仕組み

Team プランおよびエンタープライズプランでは、Cursor ダッシュボードから組織全体に適用するルールを作成・強制できます。

• 強制ルールはすべてのメンバーに必須で、各自の設定から無効にすることはできません。
• 任意ルールはデフォルトで有効ですが、メンバーは カスタマイズする > ルール で無効にできます。
• チーム ルールではグロブパターン (例: **/*.py) を使用して、ルールの適用対象を特定のファイルタイプに限定できます。
• ルールが競合した場合の優先順位は、チーム ルール > プロジェクトルール > ユーザールールです。

チーム ルールは自由形式のテキストです。プロジェクトルールのフォルダー構造は使用せず、すべてのメンバーに自動的に同期されます。

.cursorrules から移行するには？

プロジェクトルートにある .cursorrules ファイルは旧式で、今後非推奨となる予定です。移行するには：

1. コマンドパレットで「New Cursor Rule」を検索し、新しいルールを作成します
2. .cursorrules の内容を新しいルールファイルにコピーします
3. ルールタイプを Always Apply に設定します (従来と同じ挙動になります)
4. プロジェクトルートから .cursorrules ファイルを削除します

Cursor で CLAUDE.md はどのように機能しますか？

Cursor は CLAUDE.md ファイルを AGENTS.md と同様に読み込みます。プロジェクトルートに CLAUDE.md ファイルを配置すると、Cursor が自動的に読み込みます。

CLAUDE.md ファイルは、alwaysApply フロントマターの設定にかかわらず、すべての会話に常に適用されます。これにより、Claude Code も使用しているプロジェクトとの互換性が確保されます。条件付きのルールが必要な場合は、代わりに .cursor/rules/ のプロジェクトルールを使用してください。

異なるフォルダー内に同じ名前のルールがある場合、どのように動作しますか？

Cursor はルールを名前だけでなく、完全なファイルパスで識別します。異なるフォルダーに同じファイル名のルールがある場合でも、条件に一致すれば両方が適用されます。ファイル名に基づく競合や上書きはありません。

ルールが適用されないように見える場合

ルールタイプを確認してください。インテリジェントに適用 では、エージェントがいつ関連するかを判断できるよう、説明が追加されていることを確認してください。特定のファイルに適用 では、ファイルパターンが作業中のファイルと一致していることを確認してください。

ルールはエージェント (チャット) にのみ適用されます。Tab completion、Inline Edit、Bugbot の PR 確認には適用されません。

関連

• ルールリファレンス
• スキル
• 無視ファイル