開発者のRaplsは、AIコーディング支援における巨大な指示ファイルへの過度な依存が抱える限界に直面した。同氏のWordPress.orgプラグインが、禁止されている試用版（トライアルウェア）の機能制限コードを含んでいたとして審査チームに拒否されたことが発端である。開発者は、設計規約やガイドラインを網羅した長大なCLAUDE.mdファイルを維持しており、そこには問題の試用版機能の実装を防止するルールも明記されていた。しかしAIエージェントはその明示的な指示に反するコードを生成し、このエラーは数週間後の外部審査まで発覚しなかった。

この事例は、長大で複雑な構成ファイルがしばしば密かに機能不全に陥ることを示している。指示セットが数千行規模に膨らむと、モデルが埋もれた要件よりも直近の指示を優先する「注意の希薄化」が生じ、ルールが形骸化しやすい。さらに「コンテキストドリフト」により、技術的負債が蓄積されたファイルを参照し続けることで、エージェントの動作が古いままで固定されるリスクもある。文書による指示は、モデルの出力に対する強制力を自動的に保証するものではない。

これらの問題に対し、開発者は設定ファイルへの盲信を捨て、能動的な測定とメンテナンスを行う手法へと転換した。具体的には、指示の希薄化を防ぐために構成ファイルを意図的に短く保ち、セクションごとに所有者や最終確認日などのメタデータを付与して関連性を追跡している。また、重要なルールを適用する前に新規セッションを開始し、エージェントが現在どのような規約に従っているかを明示させる検証ステップを設けた。構成ファイルそのものは自身のAIへの影響力を保証できないという前提のもと、指示が確実に反映されているかを確認する仕組みを構築している。

開発者のRaplsは、AIコーディング支援における巨大な指示ファイルへの過度な依存が抱える限界に直面した。同氏のWordPress.orgプラグインが、禁止されている試用版（トライアルウェア）の機能制限コードを含んでいたとして審査チームに拒否されたことが発端である。開発者は、設計規約やガイドラインを網羅した長大なCLAUDE.mdファイルを維持しており、そこには問題の試用版機能の実装を防止するルールも明記されていた。しかしAIエージェントはその明示的な指示に反するコードを生成し、このエラーは数週間後の外部審査まで発覚しなかった。

この事例は、長大で複雑な構成ファイルがしばしば密かに機能不全に陥ることを示している。指示セットが数千行規模に膨らむと、モデルが埋もれた要件よりも直近の指示を優先する「注意の希薄化」が生じ、ルールが形骸化しやすい。さらに「コンテキストドリフト」により、技術的負債が蓄積されたファイルを参照し続けることで、エージェントの動作が古いままで固定されるリスクもある。文書による指示は、モデルの出力に対する強制力を自動的に保証するものではない。

これらの問題に対し、開発者は設定ファイルへの盲信を捨て、能動的な測定とメンテナンスを行う手法へと転換した。具体的には、指示の希薄化を防ぐために構成ファイルを意図的に短く保ち、セクションごとに所有者や最終確認日などのメタデータを付与して関連性を追跡している。また、重要なルールを適用する前に新規セッションを開始し、エージェントが現在どのような規約に従っているかを明示させる検証ステップを設けた。構成ファイルそのものは自身のAIへの影響力を保証できないという前提のもと、指示が確実に反映されているかを確認する仕組みを構築している。