ルールは文書にあり、読んだ人だけが守っていた
連載「AX の旅」の 2 本目です。薬局向けサービスをつくる開発組織で私が AX を担当し、2026 年 6 月から 10 月にかけて敷いた 5 つのうち、1 つ目の共通 AI ルールを扱います。
最初はよくある方法を使いました。守るべきことを文書にまとめて周知しました。結果もよくあるものでした。文書を読んだ人の AI はルールどおりに動き、読んでいない人の AI は好き勝手に動きました。同じ依頼でも人によって結果が違いました。
8 月 27 日に残した一文が方向を変えました。「人の行動パターンの変更は最小限にし、AI でカバーするように」。人にルールを覚えさせる代わりに、AI が作業のたびに自分でルールを読めばよいのです。
CLAUDE.md——AI が作業のたびに最初に読むメモ
Claude Code は、ターミナルで対話しながらコードを読み書きする Anthropic の AI ツールです。作業フォルダの一番上に CLAUDE.md というファイルがあれば、セッション開始のたびにまずそれを読んでから作業します。新しく来た同僚の机に貼る業務メモに似ていますが、違うのはこの同僚が一度もメモを読み飛ばさないことです。
そこでルールの置き場所を掲示板から CLAUDE.md に移しました。人が覚えていなくても、そのフォルダで働くすべての Claude が同じルールを読みます。
問題はフォルダが 1 つではないことでした。この組織のサービスのコードは 7 つのリポジトリに分かれています。リポジトリ（repo）とは、1 つのプロジェクトのコードと変更履歴を入れておく共有フォルダです。薬局サイト、管理者サイト、アプリの画面とサーバー、広告サーバーの 7 か所に同じルールを手でコピーすれば、1 か所だけ直して残りを忘れることが必ず起きます。
ルールリポジトリ 1 か所から 7 つの repo へ、そしてすべての PC へ
そこで原本を 1 か所に集めました。ルールだけを入れるルールリポジトリを別につくり、7 つのサービスリポジトリには誰も直接書かないコピーだけを置きます。直す場所は常に 1 つです。
コピーは人がしません。ルールリポジトリの共有の作業ライン（develop ブランチ）に変更を上げると、GitHub Actions が「Sync AI rules」という作業を実行して 7 つのリポジトリにルールをコピーします。GitHub Actions は、リポジトリに変化があると決めておいた作業を代わりに実行してくれる GitHub の自動実行機能です。画面のとおり 1 回 2〜5 分ほどで、10 月 21 日時点で直近 95 回がすべて成功しました。
メンバーの PC では、最新版を取り込むコマンド（git pull）を 1 回実行すれば、新しいセッションから新しいルールが適用されます。ルールを直した人がすべきことは周知ではなく、変更を 1 つ上げることだけです。
画面に見える 10 月 20 日夜から 21 日までの 2 日間だけで、ルールを 5 回直しました。周知で回していたら、5 回の告知と 5 回の「読みましたか」が必要だったはずです。
core ルール 8 つには何を書くか
ルールリポジトリは 2 層です。core にはすべてのリポジトリに同じように入る共通ルール文書が 8 つあり、その下にリポジトリごとに異なる内容（使う技術、デプロイ方法）を書いたプロジェクトルールが 7 つあります。共通ルールは作業の順序、AI の行動原則、課題の書き方、レビュー、セキュリティ、コードスタイルといったテーマに分かれています。
AI が毎回読むルールのうち、最も効果が大きかったのは 3 つです。下の表に意味と理由を書きます。コミットとは変更を 1 つのまとまりとして保存すること、ブランチとは原本に触れずに作業するために切り分けた系統です。
ルールの文は短く、確かめられるように書きます。「慎重に作業する」は守ったかどうか分かりませんが、「依頼なしに push しない」は守ったかどうかが明確です。確かめられて初めて、次回扱う自動チェックに移せます。
| ルール | 意味 | なぜ入れたか |
|---|---|---|
| 依頼なしに push しない | 自分の PC の変更を共有リポジトリに上げること（push）は人が指示したときだけ行う | 共有リポジトリに上がった変更は、他の人の作業とサービスにすぐ届く |
| 課題 1 件 = ブランチ 1 = コミット 1 = push 1 | やること 1 つに作業系統 1 つ、保存 1 つ、アップロード 1 つ | 何がなぜ変わったかを課題番号 1 つでさかのぼれる |
| 完了条件ごとにテストを先に書く | 完了の基準をコードで確かめるテストを、直す前に書く | AI が「終わりました」と言ったとき、その言葉をテストが代わりに確かめる |
ルールはお願いだ——だから次の段階が必要だった
ルールリポジトリで変わったのは仕事の形です。ルールを変えたい人は、周知の代わりに変更の提案を 1 つ上げます。画面の変更メッセージに「AI レビューの繰り返し指摘を反映」が何度も見えるのはそのためです。AI レビューで同じ指摘が繰り返されると、それが翌日ルールの 1 行になります。この循環は連載 6 本目「毎日の振り返り」で詳しく扱います。
限界もはっきりしていました。CLAUDE.md は AI へのお願いです。ほとんどは守られますが、必ず守られる保証はなく、個人が自分の PC で別の設定を足せば結果はまた変わります。
そこで第 2 段階に進みました。必ず守るべきルールは、お願いではなく切ることのできない設定に変えました。次回「Claude Team 管理設定」がその話です。
今日試せること——CLAUDE.md にルールを 3 行
Claude Code を使っているなら、作業フォルダの一番上に CLAUDE.md ファイルをつくり、下の 3 行を入れてみてください。Claude Code の中で /init と入力するとフォルダを読んで CLAUDE.md の下書きをつくってくれるので、その末尾に足しても構いません。
保存したら新しいセッションを開き、「いま読んだこのプロジェクトのルールを言って」と聞いてみてください。3 行をそのまま答えれば適用されています。
フォルダが複数あり、すべての作業に同じルールを使いたいなら、PC 全体に適用される ~/.claude/CLAUDE.md に入れれば済みます。チーム単位に広げた瞬間に必要になるのが、本稿のルールリポジトリです。
# このプロジェクトのルール
- 私が指示するまで push しない。
- 直す前に、完了条件を確かめるテストを先に書く。
- 知らない事実はつくらず「未確認」と書く。