スシロー

Posted on Jun 27

• Edited on Jul 2

なぜルールファイルがAIエージェントに効くのか

AIエージェント(Claude Code / Cursor / OpenAI Codex CLI など)はプロジェクトルートの設定ファイルを毎セッション読み込む。指示が無い状態では、エージェントは汎用的なコーディング規約を適用するため、React + TypeScript(Vite)特有の慣習——たとえば src/features/ 単位のコロケーション構成や zod によるバリデーション層——が守られないコードを生成しやすい。ルールファイルを置くことで「このプロジェクトにおけるデフォルト判断」を明文化できる。副次効果として、レビューコメントの繰り返しが減り、PR差分が一貫したスタイルに収束しやすくなる。効果は「書いた分だけ」であり、魔法的な品質向上ではない点に注意。