ルール

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

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

ルールの仕組み

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

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

プロジェクトルール

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

プロジェクトルールを使用すると、次のことができます:

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

ルールファイルの構成

各ルールは .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---- すべてのソースファイルには会社の著作権ヘッダーを含める必要があります- 実装の詳細について不明な場合は、変更を提案する前に関連する  ソースファイルを読んでください- `dist/` または `build/` ディレクトリ内の生成されたファイルは絶対に変更しないでください

---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---- Every database migration must have both `up` and `down` functions  so it can be fully reversed- Never alter a column type in-place. Add a new column, backfill,  then drop the old one in a separate migration- Reference the template for the expected file structure@migration-template.sql

グロブパターンの例

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

ルールの作成

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

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

ベストプラクティス

よいルールは、的が絞られていて、実行可能で、スコープが明確です。

• ルールは 500 行以内に収める
• 大きなルールは、複数の組み合わせ可能なルールに分割する
• 具体的な例や参照ファイルを提示する
• あいまいな指示は避け、社内ドキュメントのように明確にルールを書く
• チャットで同じプロンプトを繰り返す場合は、ルールを再利用する
• ファイルの内容をコピーするのではなく、ファイルを参照する — そうすることでルールを短く保ち、コード変更によって古くなりにくくできる

ルールで避けるべきこと

• スタイルガイドを丸ごとコピーすること: 代わりに linter を使ってください。Agent は一般的なスタイル規約をすでに理解しています。
• 考えうるすべてのコマンドを網羅して書くこと: Agent は npm、git、pytest などの一般的なツールを知っています。
• ほとんど発生しないレアケース向けの指示を追加すること: よく使うパターンに絞ってルールを定義してください。
• すでにコードベースにある内容を重複させること: コードをコピーする代わりに、正とするサンプルへの参照を示してください。

ルールは git にコミットして、チーム全体が活用できるようにしてください。Agent がミスをしたら、そのたびにルールを更新しましょう。GitHub の issue や PR で @cursor をメンションすれば、Agent にルールの更新を任せることもできます。

ルールファイル形式

各ルールは、frontmatter メタデータと本文からなる Markdown ファイルです。frontmatter メタデータは、そのルールの適用方法を制御するために使用されます。本文がルールそのものです。

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

alwaysApply が true の場合、そのルールはすべてのチャットセッションに適用されます。false の場合は、そのルールの説明が Cursor Agent に渡され、適用すべきかどうかが判断されます。

例

<SettingsSubSection  label="機能名"  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) 、そのルールは、一致するファイルがコンテキストに含まれているときにのみ適用されます。グロブパターンがないルールは、すべての会話に適用されます。
• 適用範囲: チーム ルール が有効で (強制でない限りユーザーによって無効化されていない場合) 、そのチームのすべてのリポジトリとプロジェクトに対して、Agent (Chat) のモデルコンテキストに含まれます。
• 優先順位: ルールは次の順序で適用されます: チーム ルール → プロジェクトルール → ユーザールール。該当するすべてのルールがマージされ、指示が競合する場合は、先に適用されるソースが優先されます。

ルールのインポート

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

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

アクセス権のある任意の GitHub リポジトリ (パブリック／プライベート) から、ルールを直接インポートできます。

1. サイドバーで Customize を開く
2. Rules に移動し、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 の代わりとして使えます。

Project Rules と異なり、AGENTS.md はメタデータや複雑な設定を持たないプレーンな markdown ファイルです。構造化されたルールのオーバーヘッドなしに、シンプルで読みやすい指示が必要なプロジェクトに最適です。

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

# Project Instructions## Code Style- Use TypeScript for all new files- Prefer functional components in React- Use snake_case for database columns## Architecture- Follow the repository pattern- Keep business logic in service layers

改善点

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

ユーザールール

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

Please reply in a concise style. Avoid unnecessary repetition or filler language.

FAQ

関連

• ルールのヘルプ