戻る

Claude Codeにブログの改修を任せる前に用意した「ルール」と「安全装置」

#AstroPaper#Blog
目次
  1. 用意したものは3つ
  2. CLAUDE.md:ルールを文章で伝える
    1. 「絶対に守ること」を最初に書く
    2. 理由も一緒に書く
    3. 手順を決めておく
    4. AIならではの禁止事項
  3. 権限設定:許可・確認・禁止を分ける
  4. フック:実行する前に機械的に止める
    1. 止められたときの動き
  5. 記録を残してもらう
  6. まとめ

ブログのリニューアルを、Claude Codeに丸ごと任せました。
全体の流れは前回の記事に書いています。

AIに作業を任せるのはラクです。
ただ、任せっぱなしにするのは怖い。

どれも、起きてから気づいたのでは遅いものばかりです。

なので作業を始める前に、ルールと安全装置を用意しました。
この記事では、その中身と、実際に役に立った場面をまとめます。

用意したものは3つ

何を役割
CLAUDE.mdルールを文章で伝える
権限設定(settings.json)コマンドごとに「許可・確認・禁止」を決める
フック(実行前のチェック)ルール違反の操作を、実行する前に機械的に止める

文章のルールだけでは足りないので、機械的な仕組みを重ねる。
これが基本の考え方です。

CLAUDE.md:ルールを文章で伝える

CLAUDE.mdは、Claude Codeが作業のたびに最初に読むファイルです。
ここにプロジェクトの決まりごとを書いておきます。

ちなみにこのCLAUDE.md、僕が一から書いたわけではありません。
チャットのClaudeに、やりたいことと心配なことを伝えて、書いてもらいました。
AIに守ってほしいルールを、AIと相談しながら作った形です。

何を書けばいいのかわからない、という方は、まず「こういうことをされると困る」をチャットで伝えるところから始めるのがおすすめです。

「絶対に守ること」を最初に書く

いちばん上に、最優先のルールをまとめました。

  1. URLを変えない
  2. 記事の本文とfrontmatterの値を書き換えない
  3. 土台にしたテーマ(AstroPaper)の機能はすべて残す
  4. ライセンス表記を消さない
  5. ファイルを勝手に削除しない
  6. 依存パッケージを勝手に追加しない
  7. main に直接コミットしない
  8. SEOに直結する設定を勝手に変えない

理由も一緒に書く

ルールには、できるだけ理由を添えています。
たとえばURLのルールは、こう書きました。

URLを変えない。 過去の移行でURLが変わりアクセスが大きく落ちた経緯がある。

理由があると、ルールに書いていない場面でも、AIが同じ方向で判断してくれます。
実際に、ページのファイルを別の場所へ移す作業のときには「この移動でURLは変わりませんが、構成の変更にあたるので承認をください」と、先に確認が来ました。

手順を決めておく

「禁止」だけでなく、「やるならこの手順で」も決めておきます。
ファイルの削除は、こうしました。

不要ファイルの整理は「候補リスト提示 → 承認 → 削除」の順で行う。
候補リストには、パス・判定理由・参照チェックの結果・確信度(高/中/低)を載せる。

この手順のおかげで、最初の整理では284件の不要ファイルを安心して消せました。
一覧に理由と確信度が付いているので、こちらは「確信度が低いもの」だけを重点的に見ればいいんです。

AIならではの禁止事項

人間の開発者には言わなくてもいいことも、AIには書いておきます。

2つ目は、実際に効いていました。
表示速度を測るLighthouseが作業環境に入っていなかったとき、Claude Codeは「入れるには外部パッケージの取得が必要で、ルールに当たるので実行していません」と報告してきました。
推測の数字を書くことはせず、計測は僕に依頼してきたので、僕がPageSpeed Insightsで測っています。

権限設定:許可・確認・禁止を分ける

Claude Codeには、コマンドごとに権限を決める設定があります。
3段階に分けました。

段階例
許可(確認なし)ビルド、差分や履歴の表示、ブランチ作成、コミット
毎回確認push、マージ、ファイルの削除・移動、パッケージの追加
禁止強制push、main へのpush、秘密情報の読み取り

よく使う安全な操作は確認なしにして、取り返しのつきにくい操作だけ確認を挟みます。
全部に確認を入れると、確認すること自体が作業になってしまい、だんだん読まずに許可するようになるからです。

フック:実行する前に機械的に止める

3つ目がフックです。
Claude Codeがファイルを編集したりコマンドを実行したりする直前に、小さなスクリプトを挟んで内容をチェックします。

たとえば記事ファイルの保護は、こう書いています。

if (/\/src\/content\/.+\.(md|mdx)$/i.test(p))
  block("記事ファイル(src/content 配下の .md/.mdx)の変更は禁止です。");

main ブランチへのコミットも、同じように止めます。

if (has(/\bgit\s+commit\b/) && branch === "main")
  block("main ブランチへの直接コミットは禁止です。");

ほかにも、ライセンスファイルの変更、安全設定そのものの変更、チェックを飛ばすオプション(--no-verify)などを止めるようにしています。

止められたときの動き

ルールに当たる操作をしようとすると、実行される前に止まり、理由が表示されます。

[guard] ブロックしました: 記事ファイル(src/content 配下の .md/.mdx)の変更は禁止です。

このときClaude Codeは、別の方法で回避しようとはせず、止められたことを報告してきました。
止まること自体よりも、止まったあとの動きが大事だと感じます。

CLAUDE.mdにも、こう書いてあります。

機械的なブロックは完全ではないため、ブロックされなかったことを「許可された」と解釈しない。

フックが判定しているのは、ファイルの場所やコマンドの文字列だけです。
見張れる範囲には限りがあるので、文章のルールと両方で支える形にしています。

記録を残してもらう

もうひとつ、やって良かったのが記録です。

AIとの会話は、区切りごとにリセットされます。
昨日話したことを、今日のAIは覚えていません。

そこで「決定事項は必ずドキュメントに記録する。会話だけで決めたことを放置しない」とルールに書きました。
進捗、決めたこと、計測した数字、次にやること。すべてファイルに残っています。

おかげで、日をまたいでも、作業するパソコンが変わっても、続きから再開できました。
この連載で紹介している数字や経緯も、その記録がもとになっています。

まとめ

承認の回数は、もっと減らすこともできます。
ただ僕は、決めるところは自分で決めたかったので、このくらいがちょうど良いバランスでした。

次回は、いちばん大事にしたルール「URLを変えない」を、どうやって確かめたかを書きます。