AIコーディングエージェントが動作中のコードを壊さないようにするルール

AIコーディングエージェント（Claude Code、Cursor、Codexなど）は、プロジェクト初期には魔法のように機能しますが、コードベースが成長すると、修正AがBを壊すという問題が頻発します。これはスキルの問題ではなく構造の問題であり、プロンプトを強めても解決せず、制約が必要です。

今夜すぐできることとして、プロジェクトルートにCLAUDE.mdファイルを作成し、次の内容をペーストします（Cursorの場合は.cursorrules、Codex/Copilotの場合はAGENTS.md）。

• プロジェクトの一言説明
• 現在の状態（動作しているもの、まだ動かないもの）
• 触ってはいけないファイル/フォルダとその理由
• ルール：依頼されていないファイルを変更しない；依頼なしにリファクタリングしない；不明なら「わからない」と言う；確認なしに完了と報告しない

「しないでください」と「してください」の違い：「きれいなコードを書いてください」は効果がないが、「私が依頼していないファイルを変更しないでください」は明確な境界を持ち、即座に効力を発揮します。

破壊を防ぐ5つのプロンプト：

1. 変更を許可する前に、どのファイルに触れるか、リスク箇所を説明させる。
2. 壊すのが怖いとき：これによって何が影響を受けるか尋ねる。
3. 「完了」と言われたら：テストを書いて合格を示させる。
4. 新しいチャットを始める前に：完了したこと、次にすること、試して放棄したことを要約させる。
5. ルールファイルの中でも最も価値の高い一文：「私が依頼していないファイルを変更しないでください。」

コンテキストは劣化します。長いセッションほど精度が落ちるため、3〜5タスクごとに新しいセッションを開始し、終了前にプロンプト#4を実行します。同じことを3回要求しているなら、言い回しを変えるのではなく、ウィンドウを変更します。

すべてを可逆的に：gitが障壁に感じられるなら、「現在の状態を保存」、「壊れたら保存した状態を復元」と指示します。権限の段階設定：Ctrl+Zで元に戻せる操作は自由に実行、元に戻せない操作は確認を求めます。ルールファイルに「STOP.txt」ファイルが存在する場合はすべての作業を即座に停止するキルスイッチを設定します。

失敗はトレーニングデータ：AIが誤ったことをするたびに、その文をルールファイルに追記します。事前に想像したルールはほとんど役に立たず、実際の破壊から抽出したルールだけが有効です。既知の罠の例：order_service.pyの在庫控除がトランザクション外にある、test_payment.pyが本番APIを叩くなど。

まとめ：説明はCLAUDE.mdに保存；コードの前に計画を得る；状態を保存してロールバック可能に；構築者自身が採点しない；不可逆な操作だけをゲートする；「完了」は主張ではなく証拠。今晩CLAUDE.mdを作成するだけで、明日が変わります。

より深い内容として、25ページのフィールドマニュアル（有料）では、承認ゲート、フック、キルスイッチ、スキル管理、コスト制御などが詳述されています。実際のコードベースで検証されたルールの投稿を歓迎します。