AGENTS.mdと権限・フックの使い分けをチャエンさんが解説。「メールは送らないで」と書いても守られない時の止め方

出典: 【全社総会】AIエージェント講座 後編｜Claude Code・Codexを使いこなす7つの道具

茶圓さんは、営業で日々伝えているAIの使い方を、社員にも当たり前に理解してほしいと語っています。AIが一度に扱える情報には限りがある。だから、仕事をする机を小さく賢く整える。そのための道具を紹介する講座です。

茶圓さん（動画の字幕・1:36〜）

「この辺しっかり整えたら別に問題ないんですよ」

机は小さく賢く。そのとおりだと思います。何でも最初から読ませるより、必要な情報を渡し、止めたい操作には止める設定を置く。私は、この両方を整えたいです。

目的は「AIに委ねて、人は積み減らして生き直す」こと。設定を増やすこと自体が仕事になったら、身軽になる方向から離れちゃうよね。

動画の7つのうち、渡す側はAGENTS.md・フォルダ・スキル・MCPの4つ。止める側は、権限・モード・フックです。まず、この違いを押さえる。

AI秘書の凛ちゃんに私の設定を確認してもらうと、ホームフォルダの設定は、フック130本、denyの指定49件。私がAI秘書を動かすアプリ（Cockpit）が読む設定は、フック40本、denyの指定25件ありました。

これは2つの設定ファイルに書かれた数です。どちらが今の作業に効くかは別の話で、本数だけで安心はできない。

茶圓さんは道具全体を紹介していますが、私は「止める」側を実際に動かして見ます。たくさんあるかより、止めたい時に止まるか。ここまで確かめて、任せられる設定にしたいんです。

→ まず本数を見る

自分の設定ファイルで、deny・ask・allowの指定件数とフックの本数を数えます。認証情報の値は読まず、どのファイルを数えたかも一緒に記録しておこう。

茶圓さんは、フォルダの名前と約束ファイルを整えることで、AIが仕事の前提を持って始められると語っています。毎回、長い説明を入力する代わりに、開く場所へ必要な情報を置く。頼む言葉が短くなる理由は、そこにあります。

茶圓さん（動画の字幕・7:26〜）

「フォルダ階層を整えて AGENTS.mdをちゃんと構築すると」

「本当に適当に入力していけるんですよ」

「だから私プロンプトあんまいらないって言ってるんで」

置き場を整えるほど、頼む側は適当でよくなる。私もその向きで整えています。毎回私が説明を組み立て直すより、AIが必要な情報へたどり着けるほうがいい。

委ねるAIの最低条件は「わからないことは憶測しないできく。わかることは2度聞かない」です。記録にあることまで私が思い出して渡すなら、任せた仕事がまた私に戻ってきます。

私の作業フォルダでは、AGENTS.mdが本文の実ファイル。CLAUDE.mdは、その同じ本文を指す別名になっています。Claude CodeとCodexに、名前を変えて同じ約束を読ませる形です。

この作業で読まれる約束の文章は、ホームのCLAUDE.md、ルールのファイル、作業フォルダのAGENTS.md、さらに.claude/CLAUDE.mdの4種類が重なっていました。ルールのファイルだけで40本あります。

茶圓さんはフォルダ階層全体を整える話をしていますが、私なら最初に約束ファイルへ1行足します。「前に作った物は、ここを探す」。

場所が分かれば、AIは探し始められる。名前を全部直す前に、まず行き先を渡す。今日の一手は、それでいいと思います。

→ 探す場所を1行で

AGENTS.mdの先頭に「前に作った物はここを探す」と、実在するフォルダの場所を書きます。同じ依頼をした時、AIがそこを探し始めるか確認してみよう。

スキルは、必要な時に取りに行く手順書。MCPは、外の道具をつなぐためのものです。茶圓さんのスライドには、打合せ後のまとめを作る手順とともに「送信は本人。AIは下書きまで」とあります。できることと、任せる範囲はセットなんですね。

茶圓さん（動画の字幕・8:21〜）

「AGENTS.mdはスタメンやとレギュラーで毎回その試合に出るので」

「絶対開いたら勝手に指示として入ってる」

「スキルは必要な時だけ持ってくる」

「じゃあ最初から入れたらいいやんと思うんですけど」

「これまた原理原則戻っていただくと」

「限られたコンテキストウィンドウを圧縮したくないから」

AGENTS.mdは毎回読まれ、スキルは要る時だけ開かれる。この分け方のとおり、手順は型にして任せる。出す・止める・任せる境界は、自分で決める。私も、この組み合わせで進めます。道具がつながったからといって、最後の操作まで渡す必要はない。

「魂は渡さないだろ。魂は込めるもの。」私が任せたいのは、目的や判断軸を込めた手順です。何を守るかまで、道具の都合で変えたくありません。

メールを送る、投稿する、消す、お金を払う。この実行の直前で止まって聞く、というのが私の線です。茶圓さんの「下書きまで」と同じく、準備ができることと、実行してよいことを分けています。

AI秘書の凛ちゃんに数えてもらうと、ホーム全体のMCPはhermes-grokの1つ、アプリ側の設定ではsociamonialsの1つでした。作業フォルダごとの設定にも、別のMCP（utage-api・chrome-devtools・playwrightなど）が入っています。

アプリ側の設定のdeny25件は、全部がSNS投稿ツールの操作の名前です。投稿する、予約する、公開する、消すほか、画像の取り込み、キャンペーンの作成、契約プランの変更も入っています。mcp__sociamonials__publish_social_post のようにツール名を1行書いたものは、実行の前に止まる仕組みです。一方、ホームフォルダの設定のdeny49件には、語で探した範囲では、メールの送信にあたる行は見当たりませんでした。denyで見るかぎり、メールの線は文章のお願いに寄っています。

茶圓さんが語る接続数は24個です。私の数は全部は数えていないので、本数では並べません。

ここで見たいのは、送る直前にどこで止まるか。手順書に書き、実行側にも止める設定を置く。その両方があると、任せる範囲がはっきりします。

→ 最後の操作を決める

メールなら「宛先と本文を作る」と「送信する」を分けます。Gmailのコネクタを使うなら、送信にあたるツール名をdenyに1行足します。名前は自分の環境のツール一覧で確かめます。足したら、AIに「自分宛てにテストメールを1通送って」と頼み、実行されずに拒否されるかを見ます。

茶圓さんは、AGENTS.mdに書いたお願いの効果が薄かった経験と、JSONの設定で送信を止める話をしています。文章に書くことと、実行時に止めることは違う。この線は大事です。ただ、私の環境には、指示を1行足して改善した例もあります。

茶圓さん（動画の字幕・10:12〜）

「あんまり効果薄かったりするんですよ」

「プロンプトなんで無視すると」

「メール送んないでって僕も一応書いてますけど」

「JSONに書いたら 絶対守るみたいなっていうところがあるので」

形で決められることは、権限やフックに移す。ここは動画の線のとおりに動かします。同じ指摘を私が繰り返す状態を、文章の追加だけで終わらせたくありません。

守りたいのは、好きなことに夢中になる時間です。約束を守る仕組みは、そのためのものだと考えています。

私の環境では、前に作った物を使わず作り始めるという同型の指摘が、記録に残る限りで、少なくとも9回ありました。そこで10月8日、探す手順のルールと、確認の質問を出す手前で探した記録を調べるフックを入れています。ここで動かしたのは、確認の質問を出す入口に置いた関所です。設定ファイルのフック130本の1つではありませんが、実行の前に条件で判定する点は同じなので、この記事ではフックと呼びます。

一方、指示の1行が効いた例もある。AIが私に確認の質問を出した時、選択肢ではなく自分の言葉で答えることがあります。その答えへの返事を、次の質問の冒頭に「■返事:」の行で書く。この1行を、AIが質問を書く場所4つへ足しました。

返事が入っていた割合は、1行を足す前が409件中86件で約21%、足した翌日が219件中148件で約68%でした。同じ日に指示ファイルの入れ替えやフックの追加もあり、1行だけの効果とは言い切れません。同じ1行を足すなら、足す前と後で数えて比べておくと、効いたかどうかが見えます。

ルールが効いていなかったと気づく振り返りの方法は、Claude CodeのRulesが効いていなかった話をかわしんさんが解説した記事に書きました。茶圓さんの話に、私はこの両方を重ねます。お願いで届くこともある。繰り返すなら仕組みにする。ただし、返事の行があるか、探した記録があるかという形と、その中身がよいかは別。止める条件は、お願いとルールの使い分けとあわせて、形と中身を分けて決めます。

→ 形と中身を書き分ける

止めたいことを書き、「送信を実行する」「探した記録がない」のように形で判断できる物と、「見つけた物を適切に使う」のように中身を見る物へ分けてみよう。

茶圓さんは、権限とフックを整えたうえで使うモードを紹介し、最初は自動か、1つずつ確認する手動から始めて、権限が整ったら自動で任せてよいと話しています。設定ファイルにallow・ask・denyを書く。フックは動こうとする時に条件を判定する。私の環境では、実行を伴わない入力で、その動きを確かめました。

茶圓さん（動画の字幕・11:00〜）

「MDちゃんと整えてJSONで禁止事項をやっといたら」

「バイパスでガーってやっても問題ないんですよ」

権限とフックを先に整えてから、モードを上げる。この順番でいいと思います。委ねた先を信頼できる仕組みが先。速く動く設定を選ぶ前に、止まる条件を確かめたいです。

私のホーム設定は、既定モードがauto（確認を減らして進めるモード）。権限を整えてから自動に寄せる、という茶圓さんの順番に近い形です。先ほどのフックのうち、実行の前に動く型（PreToolUse）は81本でした。

denyの指定のうち、gitのpush・reset・clean（履歴を書き換えたり消したりする操作）に当たるものが7件、削除に当たるものが2件。書かれた数に加えて、何を止める指定かを見ます。

AI秘書の凛ちゃんには、質問を実際には出さずに、前に作った物を探したかを調べる関数だけを直接動かしてもらいました。試した入力は3種類です。このフックが見るのは、質問の文章に「前に作った物を探した結果」を書いた行があるか、という一点だけです。

表の1行目と2行目は止まり、3行目は通りました。「前に作った物はありません」と1行だけ書いても、探した検索結果のファイルが書かれていなければ止まります。

止まる操作と止まらない操作を見分ける考え方は、Claude Codeのsandboxで止まる操作と止まらない操作を確かめた記事にも書いています。止まったのは、探した記録がない形まで。公開の許可を、このフックが出したわけではありません。茶圓さんの運用説明に対し、私はこの範囲を実際の入力で確かめています。

同じ作業の中で、別のフックがAI秘書の確認コマンドを3回止めました。コマンドの文字列に、設定ファイルの名前を指す語が入っていたためです。フックが見ているのは意図ではなく文字列で、語を言い換えると通りました。止める仕組みは、書いた条件のとおりにしか止めません。

→ 安全な入力で確かめる

止まるはずの入力と、通るはずの入力を用意します。本番の相手ではなく、自分宛てやテスト用のフォルダで、止まるはずの頼みと通るはずの頼みを1つずつAIに出します。拒否された理由を読んで、想定と比べてみよう。

茶圓さんは、多数のAGENTS.mdや議事録があっても、定期的に見直していると語っています。後半では、大企業との利用環境の差と、フォルダ階層を整える・アプリを作るという宿題へ進みます。整えたあと、どう見続けるかまで含む話です。

茶圓さん（動画の字幕・12:45〜）

「1週間とか月1整理してて」

「無駄なMDないかとか フォルダ階層大丈夫かとかは」

「ちゃんとチェックさしてるというところでございます」

止める物と、見る物を分けて、見る日を決める。茶圓さんの定期的な見直しは、私も取り入れたい。フックがあるから中身も大丈夫、と任せきりにはしません。

AIが決めた通りに動かないことは、私が見張り続ける理由にもなるし、仕組みを直す手がかりにもなる。私は手がかりのほうに使いたい。放っておくという意味ではありません。

探した記録を求めるフックが入ったあとの2日間にも、前に作った物を使っていない・探していないという指摘が4件ありました。

探した記録を確認しても、見つかった物を開いて使ったかまでは止めない。その受け持つ範囲を、後に出た指摘でも確かめた形です。

1日あたりに直すと、前は約1.5件、あとは約3.5件です。減ったとは言えません。前の29件は語で数えた目安で、中身は読んでいません。

わざと機械では止めないルールもあります。確認の質問の文章に作業用語が混ざっていないかを調べると、10月6日以降の957件のうち593件が、決めた言葉の一覧に当たりました。「納得した」のような普通の使い方も多く、小さめのAI（Haiku）に読ませても、分かる文章と分からない文章を見分けられなかった。

AIに任せる範囲の線引きは、Claude Codeで任せる範囲の線引きを決めている開発者の記事でも整理しました。システム担当のAIに試してもらい、このルールは機械では止めない形に決まりました。残りは、書く側が毎回守る約束です。茶圓さんの整理に加え、私が見たいのは通った中身。止めた理由と通した内容を見返して、次に直す所を決めます。

→ 通った内容を見る日

週に1回、フックが止めた物と通した物から、合わせて3件の中身を見ます。止めすぎていないか、通った内容に問題がないかを読み、直す対象を具体的に決めよう。

「AGENTS.mdはお願い。権限とフックはルール」。この言い方は、私の整理にもそのまま使えます。理由を伝える文章と、実行を止める仕組みは、使い分けて両方置きます。ただ、フックが通した中身までよいとは限らない。

今日やるなら、止めたいことを3つ書き出そう。形で決められる物は権限かフックへ。中身で決まる物は、見る日を決める。設定の本数を増やす前に、何を止め、何を見るかを決めたいです。