AIコーディングエージェントに同じ間違いをさせない方法
Claude CodeやCursorのようなAIコーディングエージェントは、しばしば同じエラーを繰り返します。テストランナーを間違えたり、インポートのスタイルを間違えたりします。チャットで修正を伝えても、次のセッションではその修正を忘れてしまいます。
チャット履歴は「メモリ（記憶）」ではありません。セッションが終了すると、あなたの修正内容は消えてしまいます。
解決策は簡単です。エージェントが実行されるたびに読み込むファイルに、ルールを書き込んでおきましょう。
ほとんどのツールがプロジェクトルートの指示ファイルをサポートしています： • Claude CodeはCLAUDE.mdを読み込みます。 • Cursorは.cursor/rules/*.mdcを使用します。 • 多くのツールがAGENTS.md標準を使用しています。
これらのファイルはモデルのコンテキストの先頭に追加されます。つまり、モデルがコードを書く前に、ルールが既に存在している状態になります。
曖昧な目標を書かないでください。エージェントに「クリーンなコードを書いて」と指示しても意味がありません。曖昧なルールは機能しません。代わりに、具体的でテスト可能なルールを使用してください。
ルールファイルには、以下の構造を使用してください：
• Commands（コマンド）: テストや型チェックをどのように実行するかを正確に定義します。 • Style（スタイル）: CommonJSよりもESMを、デフォルトエクスポートよりも名前付きエクスポートを指定します。 • Boundaries（境界）: フォルダを読み取り専用としてマークしたり、シークレット（機密情報）の保存場所を定義したりします。 • Definition of Done（完了の定義）: すべての新機能には、まず失敗するテストが必要であることを明記します。
優れたルールファイルは「傷跡のログ（scar log）」として機能します。エージェントが間違いを犯すたびに、そのセッション内で、ファイルに1行のルールを追加してください。
ファイルは短く保ってください。ルールファイルが長すぎると、モデルの注意力がコードではなくルールの方に向いてしまいます。ルールが200行を超えるようなら、整理（prune）してください。不要になったルールは削除しましょう。
エージェントがファイルを読んでいると決めつけず、テストしてください。タスクの開始時にテストコマンドを宣言させるルールを追加してみましょう。もしエージェントがそれを実行すれば、システムは機能しています。
チャットでエージェントを修正するのはやめましょう。ファイルを使って設定するようにしましょう。
実装方法：
- プロジェクトのルートにCLAUDE.mdまたはAGENTS.mdを作成します。
- 具体的で、確認可能なルールのみを記述します。
- 間違いが発生したら、すぐにルールを追加します。
- 簡潔に保ち、古いルールは削除します。
オプションの学習コミュニティ: https://t.me/GyaanSetuAi