CLAUDE.md / AGENTS.md は「リポジトリの概要」を消し、「〜しない」ルールとプロジェクト固有の違いだけを残す
投稿者が論文や公式資料をたどってまとめた結論：効いたルールは「〜しない」型、悪化させたのは「〜する」型だった。
何が分かったと言っているか
投稿者（@Voxyz_ai）が、調べものスキルで元の論文・公式ドキュメントまでさかのぼって整理した内容として、次を挙げている。
/initで自動生成した CLAUDE ファイルは、エージェントの消費を平均2割以上増やし、課題の解決率は上がらなかった。- 手書きのものも効果はわずか。
- 専門家が選んだルールと、ランダムに選んだルールで効果に差がなかった。
- ルールを1つずつ試すと、効いたのは「関係ないコードをリファクタしない」のような禁止（don't）型で、悪化させたのは「コードスタイルに従う」のような指示（do）型だった。
やり方（デザインのルールファイルにも当てはめる）
- リポジトリ構成やプロジェクト概要の説明は削る（エージェントは自分で読める）。
- 残すのは「〜しない」ルール（例：紫のグラデーションを使わない、既存トークン以外の色を直書きしない、関係ない画面を触らない）。
- もう1つ残すのは「このプロジェクトが普通と違うところ」（例：角丸は8に統一、和文の行間は1.8）。
- 「きれいに」「スタイルに従って」のような一般的な指示は消す。
注意点
- 数字や結論は投稿者の要約で、元の研究の条件（対象タスク、モデル）はここでは確認していない。うのみにせず、自分のプロジェクトで消してみて差を見るのが確実。
- 投稿では、調べものに使ったスキル
npx skills add MaryCache/imozuruも紹介されている（PDFを読むには poppler が必要）。 - 削り方の基準は CLAUDE.mdは200行未満を目安に「この行を消したらAIは間違えるか？」で削り、使いながら育てる と合わせて使う。
出典
- 投稿者: @Voxyz_ai
- 投稿: @Voxyz_ai · 2026-10-20
- 収集日: 2026-10-21（JST）