なぜルールファイルが「効く」のか
Node.js + Express のコードベースは、ルーティング・ミドルウェア・エラーハンドリングの慣習がプロジェクトごとに微妙に違います。AIエージェント(Claude Code / Cursor など)は優秀でも、その「あなたのプロジェクト固有の暗黙ルール」を毎回ゼロから推測します。結果、res.send と res.json が混在したり、独自のエラーラッパーを無視した素の throw を書いたりします。
CLAUDE.md / .cursorrules / AGENTS.md といったルールファイルは、この暗黙知をリポジトリ直下に明文化し、エージェントの初期コンテキストへ毎回自動で読み込ませる仕組みです。プロンプトに毎回貼る手間が消え、人間レビューで何度も指摘していた事項を「最初から守らせる」方向に変えられます。効果は環境依存ですが、少なくとも指摘の往復回数を減らす狙いがあります。
実例:Express プロジェクト向けの最小ルール
ファイル名はツールで異なります(Claude Code = CLAUDE.md、Cursor = .cursorrules、横断標準を狙うなら AGENTS.md)。中身はプレーンな Markdown / テキストで構いません。






