概要
https://qiita.com/WdknWdkn/items/bc2546ba3aba74c87146
詳細内容
## rules原文掲載：「rulesのメンテナンスrules」で、Cursor/Claudeドキュメントがめっちゃ整理できた話
https://qiita.com/WdknWdkn/items/bc2546ba3aba74c87146
CursorのAIルールファイルが肥大化・複雑化する問題を解決するため、ディレクトリ構造、命名規則、frontmatterの統一された管理規約を策定し、AIの判断精度向上と開発効率化を実現する方法を解説します。
**Content Type**: 📖 Tutorial & Guide
**Language**: ja
**Scores**: Signal:4/5 | Depth:4/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:4/5
**Main Journal**: 88/100 | **Annex Potential**: 85/100 | **Overall**: 84/100
**Topics**: [[Cursor, AIコーディング, ルール管理, 開発ワークフロー, ディレクトリ構造]]
AIペアプログラミングツールCursorの利用が日常となる中で、`.cursor/rules/`ディレクトリ内のルールファイルが「命名規則の不統一」「`alwaysApply: true`の乱用」「参照ドキュメントとルールファイルの混在」などによりカオス化し、AIの判断を混乱させパフォーマンスを悪化させる問題が頻発します。本記事では、この課題を解決するために、実践的な「.cursor/rulesディレクトリ管理規約」を策定し、その詳細を提示しています。
この規約は主に三つの柱から構成されます。第一に**ディレクトリ構成の分離**で、実行可能なルールファイル（.mdc）を`.cursor/rules/`に、技術参照資料（.md）を`.cursor/reference/`に明確に分け、AIの処理効率を高めます。これにより、AIは不要なコンテキストを参照せずに済みます。
第二に**体系的な命名規則**です。ファイル名を`NN-category-topic.mdc`形式に統一し、2桁のカテゴリ番号（`00-core`、`10-coding`、`20-workflow`など）で重要度や適用範囲を直感的に示します。これにより、ファイル一覧からルールの意図や優先順位が容易に把握できます。
第三に**適切なfrontmatter設計**です。すべてのルールファイルに`description`、`globs`、`alwaysApply`を必須とし、`description`は「[トリガー条件]時に参照する[内容キーワード]」形式で記述します。特に重要なのは、`alwaysApply: true`をプロジェクト全体の基本ルールである`00-core.mdc`に限定する原則です。これは、無関係なルールがAIの判断を混乱させるのを防ぎ、パフォーマンスを改善し、ルールの保守性を高めるためです。
さらに、AI自身がこの規約に従ってルールファイルを作成・管理できるよう、`.cursor/rules/90-meta-rules-management.mdc`として「ルール管理のメタルール」を定義・公開しています。これにより、AIエージェントへのルール追加依頼時にも命名規則やfrontmatterのガイドラインが自動適用され、一貫した運用が可能になります。
著者は、この規約を導入することで、AIの判断精度向上、パフォーマンス改善、保守性向上、そしてチーム開発の効率化といったメリットが得られると主張しています。AIとのペアプログラミングが当たり前になる時代において、「ルールファイル自体にも設計思想が必要」という認識が、開発効率を大きく左右する鍵となると結論付けています。