ルール

ルールはエージェントに対するシステムレベルの指示です。プロンプトやスクリプトなどをまとめ、チーム全体でワークフローを簡単に管理・共有できます。

Cursor は4種類のルールをサポートしています。

ルールの仕組み

大規模言語モデルは、補完ごとに記憶を保持しません。ルールは、プロンプトレベルで永続的かつ再利用可能なコンテキストを提供します。

ルールを適用すると、その内容がモデルコンテキストの先頭に含まれます。これにより、AI はコードの生成、編集内容の解釈、ワークフローの支援において、一貫した指針に従えます。

プロジェクトルール

プロジェクトルールは .cursor/rules に .mdc ファイルとして保存され、バージョン管理されます。パスパターンで適用範囲を指定でき、手動で呼び出したり、関連性に応じて含めたりできます。

プロジェクトルールでは、次のことができます。

• コードベースに関するドメイン固有の知識を記述する
• プロジェクト固有のワークフローやテンプレートを自動化する
• スタイルやアーキテクチャに関する方針を標準化する

ルールファイルの構造

各ルールは、任意の名前を付けられる .mdc ファイルです。プロジェクトルールには .mdc 拡張子が必要です。.cursor/rules 内の通常の .md ファイルは、description、globs、alwaysApply を指定するフロントマターがないため、ルールシステムでは無視されます。プレーンな markdown を使用したい場合は、代わりに AGENTS.md を使用してください。

.cursor/rules/  react-patterns.mdc       # プロジェクトルールとして認識される  api-guidelines.md        # 無視される（拡張子が異なるため）  frontend/                # ルールをフォルダーで整理    components.mdc

ルールの構成

各ルールは、フロントマターのメタデータとコンテンツを含むMarkdownファイルです。タイプのドロップダウンで、description、globs、alwaysApply プロパティを変更し、ルールの適用方法を制御できます。

内部では、3つのフロントマターフィールドが連携して、ルールを含めるタイミングを決定します。

---alwaysApply: true---- All source files must include the company copyright header- When you are unsure about implementation details, read the relevant  source files before proposing changes- Never modify generated files in the `dist/` or `build/` directories

---globs: src/components/**/*.tsxalwaysApply: false---- Use named exports, not default exports- Co-locate styles in a module CSS file next to the component- Keep components under 200 lines. Extract subcomponents into the same  directory when a file grows beyond that- Prefer composition over prop drilling. Pass children or render props  instead of threading data through multiple layers

---description: RPC service conventions and patterns for the backendalwaysApply: false---- Define each service in its own file under `src/services/`- Always validate inputs at the service boundary before passing data  to internal functions- Return structured error objects with a `code` and `message` field,  never throw raw strings- Add a `@service-template.ts` reference file when creating a new  service for the standard boilerplate

---alwaysApply: false---- すべてのデータベースマイグレーションには `up` と `down` の両方の関数を用意し、  完全に元へ戻せるようにする- カラムの型を直接変更しない。新しいカラムを追加してバックフィルし、  古いカラムは別のマイグレーションで削除する- 想定されるファイル構成はテンプレートをリファレンスとして参照する@migration-template.sql

glob パターンの例

globs を使用すると、ルールの適用対象を特定のファイルやディレクトリに絞り込めます。複数のパターンはカンマで区切ります。

ルールを作成する

ルールの作成方法は2つあります。

• チャットで/create-ruleを使う: エージェントで/create-ruleと入力し、作成したい内容を説明します。エージェントが適切なフロントマターを含むルールファイルを生成し、.cursor/rulesに保存します。
• Customizeから: サイドバーでCustomizeを開き、ルールに移動してAdd Ruleをクリックします。.cursor/rulesに新しいルールファイルが作成されます。Customizeでは、すべてのルールとそのステータスを確認できます。

ベストプラクティス

よいルールは、焦点が明確で、実行可能かつ適用範囲が限定されています。

• ルールは500行未満に抑える
• 大きなルールは、組み合わせ可能な複数のルールに分割する
• 具体例や参照ファイルを示す
• 曖昧な指示は避ける。明確な社内ドキュメントのようにルールを記述する
• チャットで同じプロンプトを繰り返す場合は、ルールを再利用する
• 内容をコピーする代わりにファイルを参照する。これによりルールを短く保ち、コードの変更に伴って古くなるのを防げる

ルールで避けるべきこと

• スタイルガイド全体をコピーする: 代わりにリンターを使用してください。エージェントは一般的なスタイル規約をすでに把握しています。
• 考えられるすべてのコマンドを文書化する: エージェントは npm、git、pytest などの一般的なツールを把握しています。
• めったに該当しないエッジケース向けの指示を追加する: ルールは頻繁に使うパターンに絞ってください。
• コードベースにすでにある内容を重複して記載する: コードをコピーする代わりに、正式な例を参照してください。

チーム全体が活用できるよう、ルールを git にコミットしてください。エージェントがミスをしたら、ルールを更新してください。GitHub の issue や PR で @cursor をタグ付けすれば、エージェントにルールを更新させることもできます。

ルールファイルの形式

各ルールは、フロントマターのメタデータと本文で構成されるMarkdownファイルです。フロントマターのメタデータは、ルールの適用方法を制御するために使用されます。本文がルール本体です。

---description: "This rule provides standards for frontend components and API validation"alwaysApply: false---...rest of the rule content

alwaysApply が true の場合、ルールはすべてのチャットセッションに適用されます。それ以外の場合は、適用すべきかどうかを Cursor Agent が判断できるよう、ルールの説明が提示されます。

例

<SettingsSubSection  label="Your feature name"  description="Your feature description"  value={    vsContext.reactiveStorageService.applicationUserPersistentStorage      .myNewProperty ?? false  }  onChange={(newVal) => {    vsContext.reactiveStorageService.setApplicationUserPersistentStorage(      "myNewProperty",      newVal,    );  }}/>

const flagIsEnabled =  vsContext.reactiveStorageService.applicationUserPersistentStorage    .myNewProperty;

プロバイダーやフレームワークの例を利用できます。コミュニティ提供のルールは、オンラインのクラウドソーシングコレクションやリポジトリで見つけられます。

チーム ルール

Team および Enterprise プランでは、Cursor ダッシュボードから組織全体に適用・強制するルールを作成できます。管理者は、各ルールをチームメンバーに必須にするかどうかを設定できます。

チーム ルールは他のルールタイプと併用でき、優先して適用されるため、すべてのプロジェクトで組織の標準を維持できます。個別のセットアップや設定を行うことなく、チーム全体で一貫したコーディング標準、プラクティス、ワークフローを確保できる強力な方法です。

チーム ルールの管理

チーム管理者は、Cursor ダッシュボードから直接ルールを作成・管理できます。

チーム ルールを作成すると、すべてのチームメンバーに自動的に適用され、ダッシュボードに表示されます。

有効化と強制適用

• このルールをすぐに有効にする: オンにすると、ルールは作成直後から有効になります。オフにすると、ルールは下書きとして保存され、後で有効にするまで適用されません。
• このルールを強制適用する: 有効にすると、ルールはすべてのチーム メンバーに必須となり、Customize で無効にできなくなります。強制適用しない場合、チーム メンバーは Customize の チーム ルール でルールをオフにできます。

形式とチーム ルールの適用方法

• 内容: チーム ルールは自由形式のテキストです。プロジェクトルールのフォルダー構造は使用しません。
• グロブパターン: チーム ルールでは、ファイル単位で適用するためにグロブパターンを使用できます。グロブパターン (例: **/*.py) を設定すると、一致するファイルがコンテキストに含まれる場合にのみルールが適用されます。グロブパターンがないルールは、すべての会話に適用されます。
• 適用範囲: チーム ルールが有効になっている場合 (強制ルールでない限り、ユーザーが無効にしていない場合) 、そのチームのすべてのリポジトリとプロジェクトにおけるエージェント (チャット) のモデルコンテキストに含まれます。
• 優先順位: ルールは次の順序で適用されます: チーム ルール → プロジェクトルール → ユーザールール。該当するすべてのルールがマージされ、ガイダンスが競合する場合は、先に記載されたルールが優先されます。

ルールのインポート

外部ソースからルールをインポートして、既存の設定を再利用したり、他のツールのルールを取り込んだりできます。

リモートルール (GitHub 経由)

アクセス可能な任意の GitHub リポジトリ (パブリックまたはプライベート) からルールを直接インポートできます。

1. サイドバーで Customize を開く
2. ルール に移動し、Add Rule をクリックする
3. Remote Rule (Github) を選択する
4. ルールを含む GitHub リポジトリの URL を貼り付ける。Cursor がリポジトリ内のすべての .mdc ファイルをスキャンします。
5. Cursor がルールをプロジェクトにプルして同期します

ルールは .cursor/rules/imported/<repoName> に配置されます。ルールの相対パスも維持されるため、dir/rule.mdc は .cursor/rule/imported/<repoName>/dir/rule.mdc としてインポートされます。

AGENTS.md

AGENTS.md は、エージェント向けの指示を定義するためのシンプルな markdown ファイルです。シンプルな用途では、.cursor/rules の代わりにプロジェクトルートに配置できます。

プロジェクトルールとは異なり、AGENTS.md はメタデータや複雑な設定を含まないプレーンな markdown ファイルです。構造化されたルールのような手間をかけずに、シンプルで読みやすい指示を必要とするプロジェクトに最適です。

Cursor は、プロジェクトルートおよびサブディレクトリ内の AGENTS.md をサポートしています。

# プロジェクトの指示## コードスタイル- すべての新規ファイルにTypeScriptを使用する- Reactでは関数コンポーネントを優先する- データベースの列名にはsnake_caseを使用する## アーキテクチャ- リポジトリパターンに従う- ビジネスロジックはサービス層に配置する

改善

project/  AGENTS.md              # グローバルな指示  frontend/    AGENTS.md            # フロントエンド固有の指示    components/      AGENTS.md          # コンポーネント固有の指示  backend/    AGENTS.md            # バックエンド固有の指示

ユーザールール

ユーザールールは、Customize → ルール で定義する、すべてのプロジェクトに適用されるグローバルな設定です。エージェント (チャット) で使用され、好みのコミュニケーションスタイルやコーディング規約を設定するのに適しています。

簡潔に回答してください。不必要な繰り返しや冗長な表現は避けてください。

よくある質問