#設定ファイル

Claude Code に AGENTS.md のサポートが入ったのに、肝心のファイルが読まれない。しかも原因はローカルの設定やファイル名の間違いではなく、telemetry を切っているかどうかだった、というのが元記事の話だ。見た目は「対応済み」なのに、実際には特定の環境で黙って無効化される。こういう挙動は、使う側からするとかなり厄介だと思う。 元記事は、Claude Code 2.1.277 で AGENTS.md のサポートが追加されたものの、その読み込みが remote feature flag の背後に置かれている、と指摘する。内部では `agents-md` という built-in plugin があり、2.1.280 の bundle では `tengu_agents_md_mod` というフラグを取りにいく。ここでフラグが取れない、あるいは false と判定されると、その plugin は unavailable になり、ローカルに置いた AGENTS.md は読み込まれない。 問題は、この判定がネットワーク前提になっていることだ。AGENTS.md 自体は作業ディ

まず引っかかったのは、「自分のディスクにある `AGENTS.md` を読むかどうか」が、ローカルの事情ではなく remote feature flag で決まっていることです。そこまで大げさに管理する種類の機能には見えないし、しかも telemetry を無効にした途端に黙って無視されるのは、かなり嫌な感じがします。拒否されるなら拒否されるでいいのに、何も言わないのがいちばん困る。 この記事でいちばん腑に落ちたのは、筆者が怒っている理由です。単に「新機能がうまく動かない」ではなく、「telemetry を切ると診断情報だけでなく、ローカルにあるはずの入力まで失われる」のが問題なんですよね。ユーザー側から見ると、設定ファイルが読まれないのか、モデルが無視したのか、通信まわりで止まったのか、切り分けようがない。結局、プロンプトを直したり、指示文を疑ったりして時間を溶かすことになる。こういう静かな失敗は本当に厄介だと思います。 もうひとつ面白かったのは、回避策が `CLAUDE.md` に `@AGENTS.md` を書くだけ、というあまりにも地味なことです。機能追加のために増えたはずの

読んでいてまず思ったのは、Claude Code みたいな「勝手に動くAIエージェント」では、READMEやCLAUDE.mdが思った以上に設計そのものになるんだな、ということだった。ふつう設定ファイルは、せいぜいツールの癖を合わせるための補助線くらいに見える。でもこの記事を読むと、そこがもう単なる補助ではなくて、AIの挙動を縛る“現場のルールブック”になっている。 特に引っかかったのは、コンテキストがプロンプトと別物だと強く扱っている点だ。人間なら「この指示はこの場だけ」と空気で分かるけれど、AIはそうはいかない。いったん渡した情報が、どこまで効いていて、どこから効かないのかが曖昧だと、便利さより先に事故のほうが目立つ。だから「CLAUDE.mdに何を書けるか」より、「何を書いてはいけないか」「どこで指示を切るか」を細かく詰めているのが面白い。AIが賢くなるほど、雑な指示は雑な結果として返ってくる、という当たり前がかなり露骨に出ている。 もう一つ、少し怖さもある。記事では“ベストプラクティス”として整理されているけれど、実際には運用の知識がかなり重要になる。スキルやアーティファクトま

GitHubのopenai/codexリポジトリに、ちょっと地味だけどかなり重要な要望が出ています。内容はシンプルで、AIエージェントに読ませたくないファイルを明示的に除外したい、というものです。 これ、派手さはないんですが実際にはかなり大事です。AIにコードを書かせる時代になっても、「これは見せていい」「これは絶対にダメ」の線引きは、人間がしっかり持っていないと危ない。そこをちゃんと仕組みにしよう、という提案です。 このIssueで求められているのは、エージェントが読み込んだり、モデルに送ったりしてはいけないファイルやパスを明示できる機能です。 しかも単なる一時的な指定ではなく、次の2段階を想定しています。 リポジトリごとの設定 ユーザー全体のグローバル設定 たとえば、プロジェクト内に `.codexignore` のようなファイルを置いて「このリポジトリではこのファイル群は触るな」と定義する。一方で、ユーザー側にも「どのプロジェクトでも `.env` や秘密鍵っぽいものは見せない」という共通ルールを持てるようにしたい、という考えです。 ここで面白いのは、**“プロジ