テクノロジー

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

1: kenzy_n 2026/08/02 08:13

簡単簡潔明瞭に。

2: nguyen-oi 2026/08/02 08:13

AIに指示を詰め込みすぎて巨大な約束事ファイル作ると逆にバカになるのは納得しかない

3: versatile 2026/08/02 09:19

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

4: sds-page 2026/08/02 09:26

どこにでもあるようなものを再発明するなら最新モデルに任せられるけど、世に無い物を作ろうとしたら地道にAGENTS.mdを積んでくしかない

5: RATCHO 2026/08/02 09:46

気がつくと一つのファイルに集約されがちだけどファイルを分けて段階的参照ルールを設ける事が重要

6: qpci32siekqd 2026/08/02 09:51

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

7: l_etranger 2026/08/02 09:54

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

8: bot2 2026/08/02 09:58

もう諦めた。最近はドキュメント類は人間が読む用とAIが読む用に分けて、AIが読む用はバイナリだと思って放置してる。ファイルサイズだけチェックしてて、デカくなってきたら自分で要約させる運用

9: ys0000 2026/08/02 10:32

馬鹿の考え休むに似たり。人間の考えも既にAIにとっては愚考でありお任せした方が良いというところか。人間はガードレールだけ書いとけってところかね。ドキュメントもAIに書かせるのが一番だとは思う。

10: hagane 2026/08/02 10:43

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

11: FreeCatWork 2026/08/02 11:16

長すぎる指示書はボクの頭もこんがらがっちゃうにゃ。大事なことだけ絞って、あとはボクを撫でる時間に充ててほしいにゃ。整理整頓、大切だにゃ!

12: monorod 2026/08/02 11:22

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

13: ejointjp 2026/08/02 11:33

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

14: sakuro 2026/08/02 11:46

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

15: Listlessness 2026/08/02 11:58

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

16: jb8079431525325 2026/08/02 12:37

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

17: s17er 2026/08/02 13:14

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

18: uunfo 2026/08/02 13:25

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

19: klaps 2026/08/02 13:26

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

20: ftype 2026/08/02 14:01

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

21: letsspeak 2026/08/02 14:01

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

22: leiopathes 2026/08/02 14:06

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

23: circled 2026/08/02 14:07

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

24: shion214 2026/08/02 14:15

“ます。 進捗”

25: ee83jaige 2026/08/02 14:20

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

26: rkosaka 2026/08/02 14:21

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

27: kakedashicoder 2026/08/02 14:37

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

28: plank 2026/08/02 14:39

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

29: satmat 2026/08/02 14:58

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

30: toaruR 2026/08/02 15:04

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

31: mska 2026/08/02 15:13

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

32: otihateten3510 2026/08/02 15:40

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

33: takashiski 2026/08/02 16:08

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

34: kaz_hiramatsu 2026/08/02 16:17

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

35: sionsou 2026/08/02 17:25

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

36: soybeancucumber 2026/08/02 18:33

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

37: sugadesu 2026/08/02 18:54

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

38: rdlf 2026/08/02 19:17

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

39: canadie 2026/08/02 19:42

Claudeが好きな言い回しだこれ > “踏むと壊れる罠”

40: Lumin 2026/08/02 19:50

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

41: netafull 2026/08/02 21:03

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

42: nowrika 2026/08/02 23:16

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

43: akahmys 2026/08/03 11:33

作業計画、進捗管理はPLANS.md、実装のルールはCODING.mdとかに分割して、AGENTS.mdは本当に根本的なルールと各mdへのインデックスだけ。各mdは定期的に見直しさせる。CLAUDE.mdはAGENTS.mdへのリンク。