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

CLAUDE.md は LLM にコードベースを理解させる最重要ファイル。WHY/WHAT/HOW の3要素を300行以内で簡潔に書き、指示は最小限に。段階的開示で詳細は別ファイルに分離し、リンターや自動生成には頼らないのがベストプラクティス Claude Code を使っていて、なんか思い通りに動かんなって感じたことない？指示を書いてるはずなのに無視される、毎回同じことを説明し直さなあかん、コードスタイルがバラバラになる こういう問題の多くは、実は CLAUDE .md の書き方に原因があったりするんよね X で 毎日 AI 情報を配信してるコムテです。Agentic AI / AI 駆動開発などを中心に情報を配信しています この記事は HumanLayer のブログ記事「Writing a good CLAUDE .md」をベースに、Anthropic の公式ドキュメントと最新の学術研

[asahiufo]

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

[tofu-kun]

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

[n314]

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

[htamaaki]

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

[takafumiat]

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

[ihirokyx]

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

[mayumayu_nimolove]

ああああ

[hamichamp]

面白い

[misshiki]

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

[narukami]

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

[FreeCatWork]

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

[strawberryhunter]

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

[jintrick]

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

[pwatermark]

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

[gratt]

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

[atsushieno]

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

[himanahitodesukun]

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

[okupro]

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

[RATCHO]

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

[karatte]

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