2026年版 Expressエージェントを動かすルールファイル実践ガイド

なぜルールファイルが効くのか

Node.js + Express でAIエージェント(Claude や Cursor など)に開発を手伝わせると、最初は快適でも、規模が大きくなるほど「同じ指摘を毎回し直す」「プロジェクト規約を無視したコードが返る」といった摩擦が増えます。原因はシンプルで、エージェントは毎回の文脈をゼロから推測しているからです。

CLAUDE.md / .cursorrules / AGENTS.md といったルールファイルは、この推測を減らすための「常に読まれる前提知識」です。リポジトリ直下に置くだけで、エージェントはタスクのたびに規約・ディレクトリ構成・禁止事項を読み込みます。プロンプトに毎回貼り付ける手間が消え、チーム内で挙動が揃うのが実利です。効果は環境やモデルに依存するため万能ではありませんが、指示の再現性は明確に上がります。

実例:Express プロジェクト向けルール

ポイントは「抽象論を書かない」ことです。ファイル構成・コマンド・具体的な禁止事項を書きます。

# CLAUDE.md

## プロジェクト構成
- Node.js 20 + Express 4。ESM(`"type": "module"`)を使用。
- ルーティングは `src/routes/`、ビジネスロジックは `src/services/` に分離。
- ルートハンドラに DB クエリを直書きしない。必ず service 層を経由する。

## コマンド
- 開発起動: `npm run dev`
- テスト: `npm test`(変更後は必ず実行し、緑を確認してから完了とする)
- Lint: `npm run lint`(コミット前に通すこと)

## 規約
- 非同期ハンドラは `asyncHandler` でラップし、エラーは中央の
  エラーミドルウェア(`src/middleware/error.js`)へ委譲する。
- 環境変数は `process.env` を直接参照せず `src/config/env.js` 経由で読む。
- レスポンスは `res.json()` を使い、ステータスコードを明示する。

## 禁止事項
- `console.log` でのログ出力(代わりに `logger` を使う)。
- 新規依存パッケージの無断追加。提案時は理由を添える。