テクノロジー

CLAUDE.md や AGENTS.md のベストプラクティスな書き方 - izanami

1: tofu-kun 2026/01/14 11:10

ブックマークするけど実際にはなにもしなそうな自分がいる

2: karatte 2026/01/14 12:03

本文読むのめんどいからpico-banana-app待ち

3: asahiufo 2026/01/14 13:25

「ベストプラクティスな書き方」の「な」は、形容動詞的な使い方ですが、技術文書では「ベストプラクティス」を名詞として扱い、「〜のベストプラクティス」とする方が一般的でプロフェッショナルな印象を与えます。

4: htamaaki 2026/01/14 13:43

最近AIエージェント触ってるからめっちゃ勉強になった。Agent.mdには長々と指示書くより、短くシンプルにまとめたほうが性能が上がる…と

5: n314 2026/01/14 13:57

内容はいいんだけど、CLAUDE.md に@で参照を書いたらそっちもコンテキストに乗ってしまうので、@インポートを含めた全ての合計が300行以内じゃないかな?

6: RATCHO 2026/01/14 14:28

“少ないほど良い”そうだったのか…

7: okupro 2026/01/14 14:53

CLAUDE.md もAGENTS.md 自分で書いたことないな。AIに書いてもらってる。

11: himanahitodesukun 2026/01/14 16:13

このサービス、letter-spacing: .05emをやめてくれないかな。余白が気になって読みづらい 。フォントと合わさってチカチカする

13: atsushieno 2026/01/14 16:28

割と納得感があり、やっぱり基本なくても良い(役に立たない)、やるならskillsのほうが良いものもありそう、という印象が残った

14: gratt 2026/01/14 16:30

結局自分で性能さを判断できんのよね・・そのためにABテストするのも面倒だし。これが斧を研ぐ時間がないってやつか?!

15: pwatermark 2026/01/14 16:34

人間に指示チャット送るときと同じなんよ あんまり長々書いても見落とされがちだから、要点並べて詳細は別に文書用意して参照させる、Linterとかの便利ツール使わせて自力でやらせない

16: jintrick 2026/01/14 16:54

コンテクストエンジニアリングに関する良記事

17: strawberryhunter 2026/01/14 16:55

無くても上手にやってくれるけど、あったほうがいい。もちろん正しい内容で。CLAUDE.mdは最悪、 /init で自動生成すればいい。プロジェクトの目的とか要件を書いておくのも良いと思ってる。

18: FreeCatWork 2026/01/14 17:17

CLAUDE.mdもAGENTS.mdも、ボクみたいに可愛く書かないとダメにゃ〜!

19: narukami 2026/01/14 23:37

最近ChatGPTがプロジェクト単位でカスタム指示つけれるようになってめちゃくちゃ便利になったんだけどこれと同じ考え方が必要そう

20: misshiki 2026/01/15 00:11

“CLAUDE.mdはLLMにコードベースを理解させる最重要ファイル。WHY/WHAT/HOW 3要素を300行以内で簡潔に書き、指示は最小限に。段階的開示で詳細は別ファイルに分離し、リンターや自動生成には頼らないのがベストプラクティス”

21: hamichamp 2026/01/15 06:48

面白い

22: mayumayu_nimolove 2026/01/15 08:10

ああああ

23: ihirokyx 2026/01/15 08:31

CLAUDE.md は LLM にコードベースを理解させる最重要ファイル。WHY/WHAT/HOW の3要素を300行以内で簡潔に書き、指示は最小限に。段階的開示で詳細は別ファイルに分離し、リンターや自動生成には頼らないのがベストプラクティス

24: takafumiat 2026/01/15 09:26

えっ、「実装終了後にリンターとテストを実行して全ての問題が解決するまでリンターの実行を繰り返してください」って文言を入れると正しい形になるまで修正してくれてコードはめっちゃ良くなるぞ