Cursor Rulesの書き方：プロジェクト規則ファイルとAgentの使い方

.cursor/rules に .mdc を置き、適用方法を選び、実行可能な本文を書く。一致した規則は文脈の先頭に入る。

Cursor Agent はチャットをまたいで口頭の制約を記憶しない。「ルーターを書き換えるな」を三度貼るなら、プロジェクト規則に置き、次の会話の冒頭から効かせる。

公式はこの仕組みを Cursor Rules と呼ぶ。プロジェクト規則は .cursor/rules に置き、拡張子は .mdc 必須。同フォルダの素の .md は無視される。編集器の手順であり、ブレインストーム製品の説明ではない。

プロジェクト規則とは

cursor.com/docs/context/rules を対照する。四つの出所のうち、入門はリポジトリ内のファイルで足りる。適用時、本文はモデル文脈の先頭に出る。

最初の規則を四手順で書く

1. 1

   ファイルを作る

   リポジトリに .cursor/rules/your-name.mdc を置く。Agent で /create-rule と打つか、Customize → Rules → Add Rule でもよい。フォルダ分けは可。拡張子は .mdc 必須。

2. 2

   適用モードを選ぶ

   alwaysApply: true は毎回。globs は一致ファイルが文脈にあるとき。description のみなら Agent が判断。いずれも空ならチャットで @規則名 のときだけ。

3. 3

   実行可能な本文を書く

   内部文書として書く。禁止、命名、ディレクトリ境界。@filename.ts で例を指し、ファイル全文は貼らない。公式は 500 行未満。

4. 4

   コミットして確認する

   git に入れ、チームで同じ制約を共有する。Customize で状態を見る。まだ漏れるなら会話でその規則を @ する。

本文に書くこと

---
description: TypeScript conventions for this repo
globs: **/*.{ts,tsx}
alwaysApply: false
---

# TypeScript
- Prefer named exports
- Do not edit files under dist/
- New API clients follow @src/api/client.ts

Agent が規則を使う仕方

一致後、本文は文脈先頭に入り、コード生成・差分説明・作業手順に使われる。衝突時の公式順は Team Rules → Project Rules → User Rules。先の出所が優先。Rules は Cursor Tab に影響しない。User Rules は Inline Edit（Cmd/Ctrl+K）に使われない。

AGENTS.md との使い分け

読めるメモだけでよければ、ルートまたは下位に AGENTS.md。入れ子は、その木を触るとき親と合わさり、より具体的な方が優先。glob や手動 @ が必要なら .mdc を使う。

規則を置いたあと短いスケッチが必要なら wbstorm の部屋 ID で足りる。部屋の作成と参加とホワイトボードの基礎も参照。