1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

AIエージェントのルール管理は、マトリクス組織で破綻する。CLAUDE.mdを「多重継承」させる4つの方法

1
Posted at

はじめに

Claude Codeをはじめ、ローカルで動くAIが浸透しつつありますね。基本的には、フォルダを指定して、AIはそれ以下を触ります。

その際のシステムプロンプトのようなものとして、CLAUDE.mdやAGENTS.mdのような、起動時に読み込まれるルールファイルがあります。この考え方は、どのAIエージェントでも、ファイル名などは違えど、考え方は一緒。

起動時のルールは、厳密に言うとシステムプロンプトではなく、システムプロンプトの後ろにユーザーメッセージとして配置されます。なので、確実に守られるルールではありません。

これで進めていくと、割とすぐ当たる課題について説明し、解決案を出してみます。

生じる課題:マトリクス組織的なときのルール管理

  • ケース
    • 「事業部A、B」と、「開発部、営業部」のマトリクスルール
    • さらに全社で守らないといけないルール
    • 使用するPCでは、他にもAIを使ったいろいろな作業をする
      • なので、マシン全体やユーザー全体に効かせる方法は取れない
company/
├── CLAUDE.md              # 全社ルール
├── division-a/
│   ├── CLAUDE.md          # 事業部Aルール
│   ├── engineering/
│   └── sales/             # ← ★ここに営業部ルールも効かせたい
└── division-b/
    ├── CLAUDE.md          # 事業部Bルール
    ├── engineering/
    └── sales/             # ← ★ここにも同じルールを
  • こういうときにどうする?
    • 「事業部A」という軸は、ディレクトリの階層でそのまま表現できる
    • しかし「営業部」という軸を置く枝が、この木のどこにもない
      • division-a/sales/ と division-b/sales/ は、木の上では遠い場所にある
  • これは「ファイルシステムは単一継承の木だが、ルールは多次元(ファセット)である」というミスマッチ。クラスの単一継承 vs ミックスイン、Kubernetes の Namespace vs Label/Selector、図書分類の階層分類 vs ファセット分類と、まったく同じ構造の問題

ルールをコピーする案は、すぐ破綻するから避ける

  • すぐ思いつくのが、それぞれで定義したルールを、プロジェクトにコピーして使う方法
  • それだと、ルールが古い(古いかどうか判断できない)、不統一などの問題が生じる
  • やるならせめて、ルール自体をgit管理して、利用側はバージョンを書いておくべき

マトリクスの1つのセルの存在意義

  • 「事業部Aの営業部」フォルダの存在意義は、両方のルールを持つことではなく、そのセルでしか成立しない例外や読み替えを書くこと
    • それはそれで必要だし、重要

解決方法

解法A:参照で合成する

  • @../../rules/division-a.mdなどを使う
  • Claude CodeでAGENTS.mdを読ませるためには、@AGENTS.mdとしておくとよい、という公式の推奨もある
  • 注意点:
    • ルールのフォルダ階層を変えると全部壊れる
    • カレントフォルダ外のファイルを読むので、最初だけ確認が出る
    • 再帰importは、最大4ホップが上限

解法B:シンボリックリンクで実体をひとつに保つ

  • 解法Aと類似
  • Windowsでも管理者権限または開発者モードで一応できる
ln -s ../../rules/sales.md .claude/rules/sales.md
  • 注意点:
    • ルールのフォルダ階層を変えると全部壊れる
    • リポジトリ外を指すリンクを他人と共有するときは、まったく同じディレクトリ構造が必要

解法C:セレクタ方式。ルール側に「どこに効くか」を宣言させる

  • 引力の向きを逆にする
  • プロジェクトの .claude/rules/ にルールを置き、paths で適用先を宣言させる
    • 配下は再帰的に読まれるので、rules/division-a/ のようにフォルダで整理してもよい
company/
├── .claude/
│   └── rules/
│       ├── division-a.md      # paths: "division-a/**/*"
│       ├── division-b.md      # paths: "division-b/**/*"
│       ├── engineering.md     # paths: "*/engineering/**/*"
│       └── sales.md           # paths: "*/sales/**/*"
├── CLAUDE.md                  # 全社ルール(このリポジトリ配下にだけ効く)
├── division-a/
│   ├── engineering/
│   └── sales/
│       └── CLAUDE.md          # このセル固有の例外・読み替えだけを書く
└── division-b/
    ├── engineering/
    └── sales/
company/.claude/rules/sales.md(ルール内の書き方)
---
paths:
  - "*/sales/**/*"
---
# 営業部 共通ルール
  • 事業部ごとの CLAUDE.md が消え、ルールはすべて .claude/rules/ に集約された
  • どの軸のルールも、自分がどこに効くかを paths で宣言している
    • ディレクトリの木は「事業部」の1軸だけを表し、「職能」の軸はセレクタで重ねる
  • マトリクスの各セルの CLAUDE.md に残るのは、そのセルでしか成立しない差分のみ
link(B)として、salesルールを読む(C)
# 実体はひとつ(B)、適用先はルール自身が宣言(C)
ln -s ~/company-rules/sales.md .claude/rules/sales.md
  • 注意点:
    • paths付きルールは、Claudeがマッチするファイルを実際に読んだときに発火する。触られなければ効かない
    • /compact の後、ルートのCLAUDE.mdは再注入されるが、paths付きルールとサブディレクトリのCLAUDE.mdは再注入されない(次にマッチするファイルを読むまで復活しない)
    • 利用するプロジェクトのフォルダ階層を変えると適用されない

解法D:あえてコピーに近いルール生成

  • ルール集から、今のプロジェクト用のルールを生成(ビルド)する
  • 使える場面
    • Claude Code、Codex、Cursor、と様々なツールを横断するとき
    • 組織のポリシーとして、「ルールを1つで監査したい」というとき
  • 注意点:
    • 元のルール集のバージョンアップ時に再ビルドが必要
      • CIで、「生成物が最新か」確認することもあり
    • このファイルを直接編集しないよう工夫が必要
      • .gitignore、ルールとして書いておくなど

注意点(落とし穴)

衝突管理。矛盾するルールがあったときの優先順位を決めておく

  • 決まっていないと、AIは任意に選ぶ
    • 複数のルール群は、後に読んだもので上書きされるのではなく、コピペで直列に並べて利用される
  • なので、衝突時のルールの明文化が大事

importでもコンテキストを食う

  • @../../rules/division-a.mdなどと書いてあると1行だが、ファイルは展開される
  • 公式の目安は「1ファイル200行未満、超えると遵守率が落ちる」
    • ただし import しても総量は変わらないので、実際に効くのは(おそらく)展開後の合計量
  • 本当にコンテキストを減らせるのは、paths で必要なときだけ読ませる解法C

まとめ

  • 基本的にはコピーせず、宣言
  • 解法はケースバイケースなので、思い付きで始めず、検討して選ぼう
  • 軸が2本で小規模ならA+B、3本以上か長期運用ならC(+B)、ツール横断や監査要件があるならD、がよいのでは

おわりに

組織に限らず、このようなマトリクス的な情報はよくあるなぁと昔から感じていました。共有フォルダを作るときなど。

階層的なタグを付けてビューを切り替えたいと思っていました。でもそれはそれで、きっと煩雑で大変なんでしょう。(タスク管理システムでたまに見ますが、すごく理解しづらい)

AIは、チャットツールから開発支援、そして身近なタスクのサポートと、次第に仕事や生活にうまく溶け込める手段が増えてきましたね。ステップが進んだからこそ、今回のような課題が浮かび上がります。さらなる発展を望みます!

それではよきマトリクスライフを!

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?