CLAUDE.mdに書くこと・書かないこと(恒久ルールだけ短く、詳細はknowledgeへ)
要点
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 に置く)
- 手順の詳細、コマンド集、トラブルの解決方法、デザイン仕様の細部 → knowledge に置き、CLAUDE.md からは「knowledge を検索する」ルールだけ書く。
- 一時的な作業メモ・進捗 → 作業ファイル(例: ページ一覧.csv、進行状況.md)。
- 認証情報(認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない)。
巨大化させない理由
- 毎回すべて読み込まれるので、長いほど消費が増え、重要なルールが埋もれる。
- 古い手順が残って、新しい決定と矛盾しやすい。
- 目安: 1画面〜数画面で読める量。ルールは短い命令文で、理由や経緯は knowledge 側に。
更新するとき
- ユーザーが「今後は〜」と恒久ルールを決めたときに追記する。1回だけの指示は書かない。
- 追記したら既存ルールと矛盾がないか確認し、古いルールは消すか書き換える(経緯は knowledge の rules/ に残す)。