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

Claude CodeやCodexのようなコーディングエージェントを使い続けていると、いつの間にかCLAUDE.mdやAGENTS.mdが巨大化していきます。 最初は数十行だったはずなのに、注意事項を追加し、作業手順を書き足し、引き継ぎ事項を残し、過去のトラブルを記録しているうちに、数百行の「何でも帳」になってしまいます。 情報をたくさん渡したほうが、AIは賢く動いてくれそうに思えます。しかし実際には、長い指示書が常に有効とは限りません。古い進捗、すでに完了した作業、特定のプロジェクトだけで使うルールまで毎回読み込ませると、重要な指示が埋もれてしまいます。 そしてよく見ると長く使い込まれたCLAUDE.mdは禁止事項やトラウマの塊のようになっていきます。過去に起こした迂闊な事故、失敗、勘違い…。新入社員ならそれで育っていくのでしょうが、この半年で学びながら次世代のクラウド環境で開発ししてく

[monorod]

そもそも次の作業とか書かなくない？ どういう運用してたんだろ

[qpci32siekqd]

効いているか、効いてないか、悪さしていないかをデバッグ出来ない今の環境は良くないと思っている

[rkosaka]

こういう再現性のない話題を気にするの時間の無駄な気がしてて、ぜんぶAIに任せてる。

[Listlessness]

私はAGENTS.mdもCLAUDE.mdもGEMINI.mdも全部AIに書いてもらってます。やりたいこと伝えたり判断したりは私がするけど、他のことは全部AI任せです。ディレクトリ構造もドキュメント配置もよしなにやってくれる。

[hagane]

AIのモデルがアップデートされてなにが変わりましたと言われても、ユースケース次第で結果は変わりそう。*.mdの書き方も都度アップデートしなきゃいけないだろうけど、どう書き換えるか考えるのは大変そう。

[versatile]

人間ごときがよかれとおもって足す AGENTS.md はAI をバカにするだけってことか。さもありなん

[ejointjp]

クライアントがプロのデザイナーにあれこれクソ指示してどんどんおかしくなるやつだ。

[klaps]

過渡期。ゴールだけ伝えて他はマジで何も書かない日がやってくる。いや、ゴールすら怪しくなってきた。

[l_etranger]

「流動的なものは外す。やらないことを残す。長い仕様は別文書にして読むタイミングつきで案内する。」ってだけのことをずいぶん長くかけるものだ。AI slopしてる感。

[ee83jaige]

本当にこのAIでダラダラ生成させて、資源の無駄ばかりやってイキってる界隈を見ると「自称AIを使いこなしてるプログラマーの人間」がいかに不要で、もはやAIだけがあればよいのかがわかる。

[nowrika]

いつも雰囲気でやって上手くいくので検証したりしないし、これからもそんな感じがする

[netafull]

“AIにとって重要なのは「できることの一覧」よりも、「できるけれど実行してはいけない境界」であり、その理由を明確に示すことが大事です。”

[Lumin]

最近のフロンティアモデル使ってると、人間ごときがちまちまCLAUDE.mdとかskillsとか管理して書くの傲慢にも程があると思うよ

[rdlf]

この手の工夫が必要なの本当に嫌い。とはいえ経緯というか暗黙知を適切に伝えるのはどうしたらいいんかね…ずっとClaude使うわけでもないし。過渡期なんだろうけど、誰か賢い方法を見つけてくれ。

[sugadesu]

スクロールバーちっちゃいから期待したけどopus5君への処方箋ではなかった。

[soybeancucumber]

書いてる内容が悪かっただけでは・・・

[sionsou]

最初は新卒1年目、初期配属くらいの知識だったが、モデルアップグレードに連れて中堅、シニアになってきた感あるなｗ 下手に指示入れるとそのとおりにしか動かないとか融通がきかない可能性が出てきた

[kaz_hiramatsu]

自分も最近はほぼ書かないようにしてる。ここに書くのは基本的にバッドノウハウだから、エージェントが賢くなった今、それほど必要性がない。

[takashiski]

少なくとも半年は遅れている内容だと思う。各サービスのベストプラクティスを追いかけよう。 https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices https://learn.chatgpt.com/guides/best-practices

[otihateten3510]

なんども言うが、LLMは多重制約問題が苦手だ。これは本人も肯定するし公式もそれっぽいことを言う。じゃあどうすんの？がマジで皆話せていない（自分は答えを見つけたが）

[mska]

全まかせだが(手で書かない)、メモ周り肥大してきた時どうなるかだな

[toaruR]

無きゃないで、何度も同じコードを掘るんだよなぁ（´－｀）最近進捗はデフォルトのmemoryに入ってるよね

[satmat]

このエントリーがというか、AI界隈で何が効いてるのか個人では比較しにくいのでカーゴカルトみたいになってるのがなあ…

[plank]

こういうのは今後もまだまだ試行錯誤が必要そう

[kakedashicoder]

ブログ運営でClaudeに渡す引き継ぎファイルが同じ状態になっていた。禁止事項ばかり増えて、絶対命令が20項目超。進捗と設計思想を分ける話が刺さった。

[shion214]

“ます。 進捗”

[circled]

昨年有効だったスキルとかが今は邪魔になって削除しまくってる

[leiopathes]

人によってはセッション毎に当たり外れがあると感じるレベルで評価不能だと思うけどなあ

[letsspeak]

読んでないけどAI活用はやり方よりもAIの脳内空間デザインを意識したほうがいい

[ftype]

こんな今更なこと書いてるのが未来から来たAIはかせなのか…

[uunfo]

「最初にまず知って欲しい」はずの新しくなった doctorコマンドの説明がなくてびっくりした

[s17er]

Claude Codeと一緒に改善していけばいいよね、中のこと一番知ってるの彼らだから

[jb8079431525325]

どの層に向けた情報なんだ？初学者向けか？でももしそうならこんな長々と書くべきじゃないし、かといって書いてあることは今や常識レベルのことばかりだし、本当に誰をターゲットにしているのやら

[sakuro]

元々入れる内容が不適切だったので削ったという話。