CLAUDE.mdとAGENTS.mdを削ったら、AIコーディングがグンと賢くなった｜白井暁彦 aka しらいはかせ

最近、AIにプログラムを書いてもらうのが当たり前になってきましたよね。ChatGPTやGitHub Copilotのようなツールは、私たちの代わりにコードを生成してくれるので、開発スピードが格段に上がりました。

でも、ちょっと待ってください。これらのAIコーディングアシスタントを使い続けていると、どうもAIが「賢くなくなる」というか、期待通りの動きをしなくなってくることがあるんです。

その原因の一つとして、AIが参照する「補助ファイル」がどんどん大きくなってしまうことが指摘されています。例えば、Claude CodeやCodexといったAIには、プログラムの全体像を理解してもらうために、たくさんの情報（CLAUDE.mdやAGENTS.mdといったファイル）を読み込ませます。ところが、開発を進めるうちに、これらの補助ファイルに本来不要な情報や、AIが混乱するような情報が蓄積されてしまうことがあるんです。

まるで、たくさんの本を机に積み重ねすぎて、本当に読みたいページが見つけにくくなってしまうような状態ですね。AIも、情報が多すぎると、どこに注目すれば良いのか分からなくなってしまうのかもしれません。

今回、ある開発者の方（白井暁彦さん）が、こうした「巨大化しすぎた補助ファイル」を整理し、不要な情報を削ってみたところ、AIコーディングの精度が驚くほど向上した、という体験を共有してくれました。具体的には、AIがより的確なコードを生成するようになったり、意図した通りの修正をしてくれるようになったりしたそうです。

この経験は、AIを効果的に使う上で非常に示唆に富んでいます。AIに丸投げするのではなく、AIが理解しやすいように「情報整理」をしてあげることの重要性を示しています。これは、AIとの共同作業において、人間側の「情報設計」や「チューニング」が、いかに大切かということでもあります。

AIは万能ではありません。私たち人間が、AIの能力を最大限に引き出すための工夫をすることで、より強力なパートナーになってくれる、ということを教えてくれるエピソードと言えるでしょう。皆さんも、AIコーディングで「なんかうまくいかないな」と感じたら、AIに与える情報を見直してみると、ブレークスルーがあるかもしれませんね。