学習ゴール
- プロジェクトにルールファイル(例:
.cursor/rulesやレガシーな.cursorrules)を置く目的と守備範囲を説明できる。 - 言語・フレームワーク・コーディング規約・禁止事項を短い条文化ルールに落とし、AI出力のブレを減らせる。
前提知識
- リポジトリのディレクトリ構造を把握していること。
- チームで既存のスタイルガイドやLint設定があると、ルールに転記しやすいです。
キーコンセプトと用語
- システムレベル指示:ワークスペース全体に効くマナー。長すぎると逆効果。
- スコープドルール:特定フォルダだけに効かせるルール(環境により機能差あり)。
- Lint/Formatter:ルールを機械的に補強する第二の防壁。
- DRYすぎるルール:あらゆるケースを書きすぎるとモデルが読み落とす。
手順(ステップバイステップ)
- 既存規約を棚卸:README、Contributing、ESLint設定などを集める。
- 最頻失敗トップ3:レビューで毎回指摘される内容を書き出す。
- ルールv0.1:A4半分以内に圧縮。箇条書き最大15行目安。
- カテゴリ分割:フロント/バック/インフラでファイルを分けるか検討。
- AIに自己検証させる:「このルールに反するコード例」を出させ、穴を埋める。
- PRでバージョン管理:ルール変更もdiffとセットでレビュー。
実践ミニ演習
- 演習1:禁止したいパターン(例:直書きSQL)を1行ルールにし、実際の生成コードで違反が減るか見る。
- 演習2:ルールを倍にした版と半分にした版で同じ依頼を比較。
- 演習3:新メンバーが読んでも曖昧な行に下線を引き、言い換え。
セルフチェックリスト
- [ ] ルールは短く、衝突しない用語で書いた
- [ ] 公式ドキュメントへのリンクを併記した
- [ ] 秘密情報をルール内に書いていない
- [ ] Lintと矛盾していない
- [ ] 変更履歴に日付を残した
つまずきポイントと対処
- 効いていない気がする → 依頼文にも同じ制約を1行足し、差分を観察。
- ルール戦争 → 「必須10行」に絞り、残りは任意ベストプラクティスへ。
- 環境差 → 利用中のCursorバージョンと公式ドキュメントでルールの場所を再確認。
深掘り:良いルールのパターン
「必ず○○テストを追加」「このディレクトリではインポート順」「エラーは握り潰さない」など、検証可能な宣言が強いです。「きれいに」だけは弱いので、具体例を1つ。
チーム展開
ルールはコードレビューと同じく合意形成が大事です。チーム運用 と合わせ、オーナーを置くと更新が止まりません。
運用ノート:ルールと人間のジレンマ
ルールが増えると「読まれない」より先に「守れない」が起きます。違反してよい例外手続きを1行で書いておくと現場が止まりません。三半期ごとにルールの廃止審査を開き、使われていない条を削る勇気も必要。オーナーはエンジニア1名に固定せず、フロント/バックでローテすると偏りが減ります。上位組織のコーディング規約が更新されたら、差分だけをAIに取り込ませ、人は衝突解消に集中すると効率的です。
(学習の定着)
組織学習の観点では、週次15分の振り返りをカレンダーに固定し、うまくいった依頼文や依頼テンプレは共有ドライブへコピーして資産化します。四半期ごとに公式の利用規約と社内ポリシーを突き合わせ、差分があれば短いチケットで追記してください。個人メモでも「日付・用途・入力の要点・出力の使い道」を1セットで残すと検索性が上がり、異動時の引き継ぎもスムーズです。ステークホルダー別の典型的な懸念(経営はROI、情シスは漏洩、現場は手間と心理的負担)を箇条書きで持っておくと、同じ学びを説明する場面でも言い換え疲れが減ります。公開可否が曖昧な資料はそもそもAIに入力しない、と自分で宣言しておく線引きメモがあると、日々の判断が速くなります。
なお学習効率を上げるには、「読む→15分で演習→翌週に同じ手順でもう一度」をカレンダーに3連続で置き、忘却曲線を意識するのがコツです。複数人で進めるときは教え合うペアと日時を先に仮押さえし、片方が欠席しても演習PDFだけで進められるようにリンク集を1枚添えておくと属人化が進みにくくなります。最後に、成果が出た週は短いログ(良かった依頼1行)を残し、出なかった週は「阻害要因」を1語だけメモして次週の設計に回すと改善が続きます。
まとめ:次に何をするか
v0.1ルールをコミットし、来週のPR2本で「ルールにしたおかげで省けた指摘」をメモしてください。
ツール情報(公式リンク)
権利表記・引用について
Cursorは各社の商標または登録商標です。本記事は各社の公式提供ではなく、一般的な情報提供を目的としています。機能や提供条件は変更される場合があるため、最新情報は公式ページをご確認ください。
画像クレジット
サムネイル/本文画像はUnsplashの写真を使用しています(ライセンス:Unsplash License)。
お問い合わせ
AIツールの導入・活用支援のご相談はお気軽にどうぞ
📞 090-6262-3842