オープンソースのCLAUDE.mdにより、Claude Codeエージェントがループすることなく何時間も生産的に動作

自律型Claude Codeセッションを実行したことがある人なら、壁にぶつかったことがあるでしょう。エージェントは最初は鋭いものの、2時間目には語りに迷い込み、3時間目には同じ修正をループし、何も出荷せずに終了します。何百ものセッションを費やしたある開発者は、原因がフレームワークやツールではなく、プロジェクトルートにCLAUDE.mdファイルがないことだと突き止めました。

運用ファイルの機能

このファイルは70行、MITライセンスで、./CLAUDE.mdに配置します。Claude Codeは起動時にこれを読み込み、動作が即座に変わります。主要な指示は以下の通りです。

• 語りよりも行動を強制。 エージェントがツールを呼び出す代わりに「今から～します」と書いていることに気づいたら、それを止めてツールを実行します。
• 完了を主張する前に証拠を要求。 テスト出力なしに「修正されたはず」は認められません。
• 計画言語を排除。 有効な出力は、完了したアクション、質問、または要約のみです。
• コンテキスト圧力時に自己監査。 静かに劣化するのではなく、自己監査を行います。

セッションへの影響

ファイルを配置した結果、セッションは3時間の語りループから、完全な生産的ライフサイクルに変わりました。エージェントはコードを出荷し、それが適用されたことを確認し、コンテキスト圧力が高まるまで動作を続けます。その後状態を保存し、次のセッションがクリーンな状態で引き継ぎます。

使用方法

GitHubリポジトリからファイルをコピーし、プロジェクトルートに配置します。セットアップや依存関係は不要です。Claude Codeが自動的に読み込みます。リポジトリには正確なCLAUDE.mdが含まれています。取得してドロップするだけです。