CLAUDE.mdに書くこと・書かないこと(恒久ルールだけ短く、詳細はknowledgeへ)

参考 AI活用公開・保守・運用 更新 2026-09-26
要点

CLAUDE.mdは作業フォルダで毎回守るプロジェクト固有ルールの置き場。変更禁止・作業範囲・検索/検査ルール・noindexなどの恒久ルール・優先順位を短く書き、手順や詳しい知識は knowledge に置いてリンクや検索で参照させる。

役割

  • Claude Code が作業フォルダで毎回読むルール。毎回の依頼に長い説明を書かなくて済む。
  • 「このプロジェクトでは必ずこうする/絶対にしない」を書く場所。

書くこと

項目例(このプロジェクト)
変更禁止事項既存ページを勝手に編集・削除・公開しない、CSSを変えない、プラグイン・テーマ・設定変更は禁止
作業範囲・単位1カテゴリ単位、初回は3ページ以下、WordPress登録は下書きから
恒久ルールguidepocket.net は blog_public=0 / noindex を維持(gp-noindex-rule)
検索ルール作業前に knowledge を search.ps1 で検索し、必要なMarkdownだけ読む(Claude Code が作業前にナレッジを検索・追加する手順)
検査ルール生成後にテンプレートとの差分確認、CSS差分はエラー扱い
優先順位新しい明示指示 > 確定事項 > 参考(確定事項の優先順位(最終・採用 > 案・試行、新しい明示指示が最優先))
不明時の動き設計変更せず停止して確認
文章・命名ルール日本語で簡潔、スラッグはタイトル由来 など

書かないこと(knowledge に置く)

巨大化させない理由

  • 毎回すべて読み込まれるので、長いほど消費が増え、重要なルールが埋もれる。
  • 古い手順が残って、新しい決定と矛盾しやすい。
  • 目安: 1画面〜数画面で読める量。ルールは短い命令文で、理由や経緯は knowledge 側に。

更新するとき

  • ユーザーが「今後は〜」と恒久ルールを決めたときに追記する。1回だけの指示は書かない。
  • 追記したら既存ルールと矛盾がないか確認し、古いルールは消すか書き換える(経緯は knowledge の rules/ に残す)。