CLAUDE.mdの書き方｜ブログ運営で毎回守らせる決まりと、書かない方がいいこと（Codexでも同じ）

CLAUDE.mdは「毎回最初に読む、前提のメモ」

CLAUDE.mdは、Claude Codeが作業を始めるたびに、頭から全部読むファイルです。Codexでは、同じ役目のファイルをAGENTS.mdと呼びます。

中身はふつうの日本語の箇条書きで大丈夫。特別な書き方はありません。

大事なのは、ここに書いた1行が、記事を書くときにも、画像を作るときにも、リンクを点検するときにも、毎回効くということ。だから、何を書くかより先に、何を書かないかが大事。

開発の例を、ブログに置き換えるとこうなる

検索で出てくる開発の例を、ブログ運営に置き換えると、こうなります。

開発なら、AIはフォルダのプログラムを読めば使っている言語くらいは自分で分かります。でもブログは、下書きを何十本読ませても、「このサイトは初めての人向け」「この言い回しは使わない」は伝わりません。書いておくしかないんです。

ブログ運営の決まりに書く5つのこと

ブログ運営で決まりのファイルに入れているのは、この5つです。

1つずつ、書くときのコツを書きます。

① 読者は「検索する直前に何に困っていたか」で書く

年齢や年収まで決めなくていいです。書くのは2〜3行。

「キャンプを始めたい家族向け。道具を買う前に、何が要って何が要らないかを知りたい人が来る」くらいで十分。その人が検索する直前に何に困っていたかが分かれば、AIは書き出しも言葉の選び方も合わせてきます。

② 書き方は「やめてほしいこと」より「代わりにどうするか」

一人称、です・ます調かどうか、使わない言い回し。ここで一番大事なのは、禁止だけで終わらせないことです。

これは後の「守られないとき」でくわしく書きます。

③ 数字は「どこにある数字なら使っていいか」を書く

AIは、材料にない数字でも、文の流れに合わせて「〇か月で」「〇割の人が」と書いてきます。自分のサイトに、自分が出したことのない数字が載る。体験を出すブログだと、これが一番怖いです。

なので「数字は、材料のフォルダのメモにあるものだけ使う。無ければ書かずに報告する」と書いておきます。商品の価格や仕様のように変わるものは「書かずに公式のページへ案内する」も、ここに入れています。

④ 置き場所は、フォルダとファイル名まで

下書きはこのフォルダ、ファイル名は「日付_記事の短い名前」、公開済みの記事の控えは読むだけで書き換えない。

チャットのAIには要らない項目です。ファイルを直接いじるClaude CodeとCodexだから意味が出てくる。ここが空っぽだと、AIはその場で分かりやすい場所に保存して、1か月後にはどれが最新か分からなくなります。

⑤ 報告は「自分で判断したところ」を分けて書かせる

「終わったら、変えたファイルの一覧と理由を1行ずつ。迷って自分で決めたところは分けて書く」。

効くのは後半です。AIが自分で判断したところだけを見に行けば済むので、全部を読み直さなくていい。

例：キャンプ道具のブログなら、これで全部

5つを入れると、こうなります。この記事のために作った、架空のブログの例です。

• このサイト：キャンプを始めたい家族向けのブログ。道具を買う前に、何が要って何が要らないかを知りたい人が来る。
• 書き方：一人称は「僕」。です・ます調で、ときどき話し言葉を混ぜる。専門用語は初めて出たところで言い換える。
• 書き方：「おすすめ10選」のように数だけを並べる見出しにしない。読者が迷っている理由を見出しにする。
• 数字と事実：使う数字は「材料」フォルダのメモにあるものだけ。無いときは数字を書かず、報告で知らせる。
• 数字と事実：道具の価格と仕様は記事に書かない。メーカーの公式ページへ案内する。
• ファイル：下書きは「下書き」フォルダに、「日付_記事の短い名前」で保存する。
• ファイル：「公開済み」フォルダのファイルは読むだけで、書き換えない。
• 報告：終わったら、変えたファイルの一覧と理由を1行ずつ。自分で判断したところは分けて書く。

これで全部です。短すぎると思うかもしれませんが、最初はこのくらいのほうが、どの行が効いているのかを追えます。

自分で書かずに、聞き取りで作ってもらう

上の例を自分のブログ版にするなら、一から書かずに聞き取ってもらうのが早いです。送る文は、これだけ。

このブログのCLAUDE.mdを作りたい。「読者」「書き方」「使っていい数字」「ファイルの置き場所」「終わったときの報告」の5つについて、1つずつ質問して。答えたら、1項目1〜2行でまとめて。

「/init」と打てばフォルダを見て自動で作ってもくれます。ただ、ブログのフォルダで試したら、中身はフォルダの並びの説明ばかりでした。読者や書き方はフォルダのどこにも無いので、当然といえば当然です。

書かない方がいいこと

決まりのファイルは毎回全部読まれるので、要らない1行は、毎回の作業に要らない前提を混ぜることになります。

公式の説明でも、1つのファイルは200行以内が目安で、長いほど守られにくくなる、とされています。

2つ目は、僕がやらかしたことです。決まりのファイルに記事の一覧を書いておいて、関連記事のリンクを出してもらっていた。ところが一覧を直し忘れていた時期があって、新しく書いた記事が候補にまったく出てこなかったんです。

AIは、決まりのファイルに書いてあることを疑いません。変わるものは中身ではなく、見に行く場所を書く。これなら一覧を直すだけで済みます。

特定の作業の手順をどう分けるかは、Skillの記事に書きました。

» Claude CodeのSkillでブログの書き方を覚えさせる｜自分で書かずに作る方法と、最初に作る3つ

書いたのに守られないとき

決まりを書いたのに、守ったり守らなかったりする。これはAIの気まぐれというより、書き方に原因があることがほとんどです。僕がつまずいたのは、この4つでした。

1つ目は、公式の説明にも「矛盾する決まりがあると、AIはどちらかを勝手に選ぶことがある」と書かれています。書いた時期が違うと、自分では矛盾に気づきません。

3つ目の「理由」が一番効きます。理由が書いてあると、決まりに書いていない場面でも、AIがその理由に合わせて判断できる。何をするかと、なぜそうするかをセットで書くのがコツです。

矛盾や古い行は、AIに探させる

決まりが増えてきたら、Claude Codeに「/doctor prompt-audit」と打ってみてください。決まりのファイルを読んで、ぶつかっている行、古くなった行、もう無いファイルの話をしている行を探して、直し案を出してくれます。

直すのは、こちらが「直して」と言ったときだけ。勝手には書き換えないので、気軽に試せます。

公開や削除のように、戻せない操作を止めたいなら、決まりのファイルに書くだけでは足りません。公式の説明でも、決まりのファイルは「守らせる設定」ではなく「前提」とされています。確実に止めるのは、許可の設定のほうです。

» Claude Code・Codexでブログを始める準備｜最初の30分でAIに頼む5つのこと（そのまま使える頼み方つき）

決まりのファイルを育てる

決まりのファイルは、最初に完成させるものではありません。作業しながら育てるものです。僕のやり方は3つだけ。

1行足すときは、AIに下書きさせています。「この会話で僕が直したことを、決まりのファイルに足す1行にして」。ただ、そのまま入れずに、今回の記事の話に寄りすぎていないかだけ見てから入れます。

ちなみに、いまのClaude Codeには、注意されたことをAI自身がメモしておく「自動の記憶」の機能もあります。同じ注意を何度もしなくて済むことが増えますが、メモの中身はAIが決めたものです。毎回絶対に守ってほしいことは、自分で決まりのファイルに書いておくほうが確実です。