齋藤 勉/TsutomuSaito

組込プログラマ→オンプレ系インフラSE→Web(フロント、バック)エンジニア
Oracle9i/10g/11g/Apache/Weblogic/JBoss/Enginx/NNM/HULFT/...etc
C/PHP/Laravel/Nuxt.js/Vue.js/Flutter
気がつけばインフラも開発もやってた。

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

⚡️ "所信表明"

https://t.co/SXJmNUbxNG

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

結局、AI に読ませる Markdown は人間向けの文書ではなく、ビルド成果物として扱うほうが実態に合っています。

手で置いたファイルは、構造を変えた瞬間から嘘になる。

記事に詳しく書きました。
https://t.co/qi46gX8Mgv

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

ディレクトリを1つリネームした瞬間に、AIの規約が静かに死ぬことがあります。

paths: や globs: でスコープした規約は、グロブが一致しなくなっても**エラーになりません。**
ただ適用されなくなるだけ。

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

対策は「規約をマスタ1つに集約して生成物にする」こと。

構造を変えたら再生成が必要になり、再生成し忘れは CI の --check で落ちる。
人間が覚えておく必要をなくすのが目的です。

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

モノレポで nested な AGENTS.md を使っているなら、
Claude Code 側には別途 CLAUDE.md か .claude/rules/ が要ります。

読み込まれたかは /context で確認できます。

https://t.co/EA2IuN8NpN

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

AGENTS.md を置いてるリポジトリで Claude Code も使いたいとき、
`ln -s AGENTS.md CLAUDE.md` が出てきます。公式が案内している手順です。

ただしこの1行で繋がるのは、ルートの1ファイルだけです。

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

agents.md 側は60k超のプロジェクトで使われていて、対応表明ツールは20以上。
そのリストに Claude Code は入っていません。公式ドキュメントも明示しています。

> Claude Code reads CLAUDE.md, not AGENTS.md.

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

エージェントに何を伝えたかを測るなら、自分が打った文字ではなく、
自分が打っていない文字のほうを読んだほうがいい。そちらが99%を占めています。

https://t.co/uy9LgX237E

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

エージェントに送られた user メッセージ588件を数えたら、人間が打ったのは282件（48.0%）でした。

半分は人間。ここまでは想像どおりです。

文字量で数え直すと、0.63%になりました。

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

問題は、ログ上でこの2つが**同じ形のメッセージとして並ぶ**こと。

見分けられるのは promptSource というフィールドだけで、
これを見ずに「ユーザー入力」を集計すると、桁が2つ違う数字が出ます。

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

固有なのは1点だけで、規約の効果を正解データなしで測るコマンド。

ai-rules stability --runs 3 -- <レビューコマンド>

同じ入力でN回走らせて、High/Critical が一致するかだけ見る。ブレたらモデルじゃなく入力を疑う。MIT。
https://t.co/f6SM1fVul7

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

Claude Code の .claude/rules/ は公式でよくできてる。paths: でディレクトリごとに規約をスコープできる。

問題は、Cursor が .cursor/rules/*.mdc の globs:、Copilot が .github/instructions/*.instructions.md の applyTo: で、同じことをやるのに置き場所も拡張子もキー名も全部違うこと。

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

そのうえで、Python だけで完結させたい用の最小版を書いた。rules のみ・依存は PyYAML 1つ。

ai-rules build / check（古かったら exit 1）

Pythonリポジトリの CI に npx を足したくない、くらいの理由でしか要りません。

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

詳しい話と、実際に配布する仕組みを記事に書きました。

記事: https://t.co/SF2DjxqxNf
ガイド本（第3章「規約が効かなくなる4つのパターン」まで無料）: https://t.co/UNh54LVocZ

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

「CLAUDE.md に書いたのに守られない」の原因、たいてい書き方じゃなくて置き場所です。

ルートの CLAUDE.md は /compact 後にディスクから再読込されて再注入されます。
されないのはサブディレクトリの CLAUDE.md と、paths: 付きのルール。

[齋藤 勉/TsutomuSaito @Tsutomu_eng]

なので運用ルールは1つでいい。

**足すときは削る。**

守られない「なるべく」「できれば」で終わる行は、書いてあるだけ他の行を薄めるので、真っ先に消す対象です。