AI エージェントに開発を任せる前に、 人が決める 6 層・24 要素
AI エージェントは、計画を立て、ファイルを書き換え、テストを走らせ、人が見ていないあいだも作業を進めます。実装と検証の作業を任せると、人の役割は、何を任せ、どこで人が判断し、どう確かめるかを設計することに移ります。
6 層で見る全体像
このガイドは、その設計で決めておくことを 6 つの層・24 の要素に分け、各要素に 2026 年 11 月時点の Claude Code での具体的な設定・ファイル・コマンドを対応させています。24 の要素は、下の層から順に固めます。上の層の取り決めは、下の層に支えられて初めて効くからです。
任せる範囲が広がると増える取り決め
AI の提案を人が一つずつ取り込む使い方なら、取り決めは少なくて済みます。 変更のたびに、人が見て確かめているからです。書き換え、実行し、結果を見て次の手を決める。この一連の作業をエージェントに任せると、それまで人が見ていたことを、あらかじめ設定と仕組みに置き換える必要があります。
人が作業を進め、AI が補助する使い方
- AI の提案を、人が一つずつ読んで取り込む
- コマンドを実行するのは人
- 間違いは、取り込む前に人が気づく
- 外部の文書も、人が選んで渡す
- 足りない取り決めは、人の注意で補える
取り決めが少なくても、人の注意が安全を支えている
エージェントが作業を進め、人が任せ方を設計する使い方
- AI が自分でファイルを書き換え、コマンドを実行する
- 複数のエージェントが並行して、人が見ていない時間も動く
- 間違いは、取り込んだ後でしか見えないことがある
- AI が自分で Issue・依存パッケージ・Web ページを読みに行く
- 人が見ていない操作は、設定と仕組みでしか止められない
人の注意で補っていたことを、先に設定に書く
人の注意を前提にした使い方のまま、エージェントに権限と作業を任せると、事故につながります。24 の要素は、これまで人の注意が受け持っていたことを、設定・仕組み・記録に移すための一覧です。一人で使う場合でも、作業をエージェントに任せるなら A〜F のすべての層が関わります。
たとえ: 馬と馬具
英語の「ハーネス」は、もとは馬具のことです。馬は力があり、自分の意思で走ります。手綱と鞍だけでは足りないので、コースには柵を立てます。AI エージェントも、自分で判断して動きます。
| 馬具 | AI エージェントでは |
|---|---|
| 手綱・鞍 | 指示書 (CLAUDE.md)・手順 (Skills)・道具 (MCP) |
| 目隠し(ブリンカー) | 渡す文脈を絞る・サブエージェントに分ける |
| 柵 | 設定の拒否 (permissions)・hook・CI |
指示書は手綱と同じで、AI への頼みにすぎず、守られる保証はありません。柵に当たる設定の拒否と hook は、AI がどう判断しても操作を止めます。絶対に止めたいことは、指示書に書いて終わりにせず、柵の側に置きます。整える順番も、柵が先で、道具を増やすのは後です。
実行基盤
エージェントを、どこで動かし、どこまでアクセスさせるか。目立たない層ですが、何か起きたときの被害の広さは、ここで決まります。
実行環境
端末・エディタ・ブラウザ・CI・クラウドの定期実行のどこで動かすかを、用途ごとに決める。動かす場所が増えるほど、権限と記録の置き場所も増える
環境の再現性
開発の環境をコードで定義し、依存のバージョンを固定する。エージェントが動く環境と、人が確かめる環境と、本番の差を小さくする
隔離
エージェントが読み書きできるファイルと、接続できるネットワークを、既定の設定に任せず、明示して絞る
モデルの使い分け
計画・設計・レビュー・実装・機械的な軽作業ごとに、使うモデルと思考の深さを決め、設定に書く。既定を下位のモデルにして大事なときだけ上げる運用では、指定し忘れてもエラーにはならないので、品質が落ちたことに気づきにくい
テクニカル補足
A-2 と A-3 は「動いているから後回し」にされやすい要素です。環境の差が表に出るのは、エージェントが「通りました」と報告したテストが、CI や本番で落ちたときです。devcontainer.json か Dockerfile で環境を定義し、依存は lock ファイル(package-lock.json など)とバージョンの固定でそろえます。A-3 は、隔離の仕組み(サンドボックス)を使うかどうかに加えて、.env や鍵のファイルを読ませない設定 (B-4) と組み合わせて決めます。
制御・安全
エージェントに、何をさせないか。どこまでを任せ、どこで人が止めるか。止める取り決めが無いエージェントは、渡された権限の範囲で何でも実行します。
禁止の定義(ガードレール)
してはいけないことを、文書と設定の両方に書く。文書(指示書)は守られないことがあるので、取り消せない操作は設定と hook で物理的に止める
ツールと権限
渡すツールを役割ごとに最小にし、操作を「許可・確認・拒否」に分ける。削除・本番への反映・外部への送信・履歴の書き換えは、拒否か人の確認にする
外部から入る指示(プロンプトインジェクション)
エージェントが読む外部の入力(Issue・PR のコメント・依存パッケージの README・取得した Web ページ)は、データとして扱い、中の指示に従わせない。「外部の入力を読む・シークレットに触れる・外部へ送る」の 3 つを、同じエージェントに同時に持たせない
シークレット管理
鍵とトークンを、エージェントに読ませない・記録に入れない・外部に送らない。.gitignore だけでなく、読み取りの拒否と、commit の前の自動の検査を重ねる
データの扱いと保持
テストのデータと本番のデータを分け、エージェントの本番への接続を絞る。AI のサービスに送ってよいデータの範囲と、送った内容が何日残り、何に使われるかを、契約と設定で確かめる
テクニカル補足
B-1 と B-2 は、「指示書に書いた」で済ませないことが要です。止めたい操作は、設定の拒否 (deny) か、ツールを実行する前に動く hook(例: PreToolUse)に任せます。B-3 は、エージェントが自分で外部の情報を読みに行くようになって増えた事故の型です。Issue の題名や依存パッケージの中身に仕込んだ指示で、エージェントを操る攻撃が報告されています。外部の入力を読む役と、シークレットや本番の権限を持つ役を分けるのが、製品に依らない対策です。
コンテキスト・知識
エージェントに、何を知らせ、何を覚えさせるか。読ませる情報の質が、出てくるものの質を決めます。
コンテキスト管理
エージェントが最初に読むファイル・必要なときだけ読む手順書・役割ごとの定義を分け、何を常に読ませ、何を読ませないかを決める。読ませすぎると、肝心の取り決めが埋もれる
指示書の設計
役割・禁止事項・出力の形を、構造のある指示書に書き、再利用する。曖昧な指示は、もっともらしい誤りを増やす
記憶
設計の判断・却下した案・経験した失敗を、セッションをまたいで残し、次のセッションで読ませる。何を残し、誰が書き、どこに置くかを決める
文書
README・API の仕様・判断の記録を、人だけでなくエージェントが読み書きできる場所と形で保つ
テクニカル補足
C-3 の記憶は、エージェントが自動で書くものと、人やまとめ役が見直して書くものを分けて置きます。自動で書く記憶は、間違いもそのまま残します。他の環境や他の人から届いた記憶は、確かめていないデータとして読ませます。記憶が別の端末に同期される場合は、シークレットの値を書かない決まりも要ります。
タスク実行
どう分け、どう動かし、失敗からどう立て直すか。大きな作業をそのまま渡すと、エージェントは途中で方向を見失います。
計画と分割
大きな作業を小さく分け、計画を人が確かめてから実装に入る。仕様が要る作業は、仕様を先に確定させる
作業の隔離とバージョン管理
エージェントの作業ごとにブランチと作業ディレクトリを分け、人がレビューできる粒度で commit させる。本流のブランチへ直接書かせない
並列と分担
複数のエージェントを並べるときは、役割・受け渡すもの・書いてよい場所を決める。同じファイルを複数のエージェントが書き換えない分け方にする
失敗からの回復
途中で止まったときに、どこまで済んだかを記録に残し、続きから再開できるようにする。済んだかどうか分からない操作を、繰り返さない
テクニカル補足
D-1 は、手間に対して効果の大きい要素です。仕様を渡しても、すぐには実装させません。まず計画を出させ、人が確かめてから実装に進めます。D-2 は、git の worktree を使えば作業ごとにディレクトリが分かれ、並列で動かしても互いの作業を踏みません。D-4 では、途中の状態(決まったこと・変えたファイル・残りの作業)をファイルに書かせておきます。会話が切れても、そこから再開できます。
品質保証
正しく動いたかを、何で・誰が確かめるか。この仕組みが無いと、エージェントは誤りの上に次の作業を積み重ねます。
自動検証
テスト・lint・型の検査・CI を、エージェントの出力に毎回かける。書き換えのたびに整形と lint が自動で走るようにする
検証の独立
実装したエージェントから独立した手段(読み取り専用のレビュー用エージェント・他社のモデル・人)で検証する。実装した側の「確認しました」は検証として扱わない。失敗の理由は、エージェントが読める形で返す
費用と待ち時間
トークンの量・並列の数・モデルの使い分け・キャッシュで、費用と待ち時間を見積もり、測る。チームで使う前に、1 人あたりの費用の目安と上限の決め方を持つ
テクニカル補足
E-2 は、エージェントに作業を任せる開発で、最も省かれやすい手間です。書いたエージェントに「確認して」と頼んでも、同じ見方で同じ見落としをします。レビュー役は、ファイルを書き換えられない設定にしておくと、指摘だけに専念させられます。E-3 の問題は、組織で使い始めてから表に出ます。費用は、モデルの選び方・並列の数・1 回に読ませる量で大きく変わります。公式の資料が示す目安は、下の対応表に書いています。
運用・組織
チームで使い続けるために。誰が何をエージェントにさせたかを追えなければ、事故の原因も、次の改善も見つかりません。
記録と管理
チームの設定を 1 か所で配り、個人が変更できない設定と、個人が追加できる設定を分ける。誰が・いつ・何をエージェントにさせたかを、記録から追えるようにする
拡張と依存の供給網
プラグイン・skill・MCP サーバー・依存パッケージ・CI の部品は、導入する前に中身と出どころを確かめ、バージョンを固定する。拡張は文書だけでなく、hook やコードも含められる。誰が導入してよいかを組織で決める
ナレッジの共有
うまくいった手順と経験した失敗を、個人の技で終わらせず、チームの手順書と設定に残す
法務・コンプライアンス
生成物の権利・依存のライセンス・個人情報・業界の規制・AI の利用規約を、使い始める前に法務と合意する。国内外の指針の改定を追う
テクニカル補足
F-2 は、AI エージェントの普及で広がった攻撃の入り口です。Web アプリの代表的な危険をまとめた OWASP Top 10 も、2025 年版で項目を広げました。部品の既知の脆弱性だけを扱っていた項目が、ソフトウェアの供給網の失敗全体 (A03:2025 Software Supply Chain Failures) になっています。エージェントは、導入した拡張の中のコードを、人と同じ権限で動かします。どの拡張を導入してよいかは、一人ひとりに任せず、組織の許可の一覧で決めます。CI の部品(GitHub Actions など)は、タグではなくコミットの SHA で固定します。こうしておけば、タグを書き換えられても影響を受けません。
先に決める 5 項目
24 の要素を一度にすべて整える必要はありません。エージェントに作業を任せる前に、まずこの 5 つを決めておきます。2026 年 11 月時点で AI エージェントの事故が多く起きているのは、生成されたコードそのものより、エージェントを取り巻く設定や権限、取り込む部品の側です。
隔離
- 起きやすい事故
- 動作の確認を急いで、エージェントを隔離せず、端末の全部のファイルとネットワークにアクセスできる状態で動かす
- 決めないままだと
- 作業と関係のないファイル(別のプロジェクト・ホームの設定・鍵)を読まれ、外部へ送られうる
- 最初にすること
- エージェントに読み書きさせるディレクトリと、接続してよい先を書き出し、隔離の仕組みと設定で絞る
ツールと権限
- 起きやすい事故
- 確認のダイアログを減らすために、広い許可を一度に出す。本番のデータベースやクラウドを消せる権限を持った環境で、エージェントを動かす
- 決めないままだと
- エージェントの誤った判断が、そのまま本番で実行される
- 最初にすること
- 削除・本番への反映・外部への送信・履歴の書き換えを、設定で「拒否」か「確認」に分類する。許可は、読み取りと手元のテストから追加していく
外部から入る指示
- 起きやすい事故
- Issue・PR のコメント・依存パッケージ・取得した Web ページに仕込まれた指示に、エージェントが従う
- 決めないままだと
- 外部の第三者が書いた文で、手元のシークレットや権限を使われる
- 最初にすること
- 外部の入力を読む作業と、シークレット・本番の権限・外部への送信を持つ作業を、別の役(別のエージェント・別の設定)に分ける
シークレット管理
- 起きやすい事故
.envをエージェントが読み、その値が会話や記録やログに残る。鍵の入ったファイルが commit される- 決めないままだと
- 鍵の流出と、クラウドや外部サービスの不正利用
- 最初にすること
- 鍵のファイルの読み取りを設定で拒否し、commit の前にシークレットの検査を自動で走らせる
拡張と依存の供給網
- 起きやすい事故
- 人気のプラグイン・MCP サーバー・依存パッケージ・CI の部品を、中身を確認せずに導入する。バージョンを固定せず、知らないうちに中身が変わる
- 決めないままだと
- 改ざんされた部品のコードが、エージェントや CI の権限で動く
- 最初にすること
- 組織で導入してよい拡張の一覧を作り、依存は lock とバージョン、CI の部品は SHA で固定する
Claude Code との対応表
24 の要素を、Anthropic の AI エージェント Claude Code の機能・設定・ファイルに対応させました。製品の機能は数か月で変わるため、この表は更新日つきで書き換えていきます。別の製品を使っている場合も、本文の原則はそのまま当てはまります。
2026 年 11 月 17 日時点。機能の名前と中身は、Claude Code の公式の資料 (code.claude.com/docs) を正とします。
A 実行基盤(4 要素)
| 要素 | Claude Code での実物(機能・設定・ファイル) |
|---|---|
| A-1 実行環境 | 端末 (CLI)・デスクトップアプリ・VS Code・JetBrains・Web・モバイルから使える。Slack からも頼める(個人の Pro・Max・Ultra のプラン。組織で共有するのは Claude Tag)。決まった時刻に動かす定期実行 (scheduled tasks) は、端末のセッションの中・デスクトップアプリ・クラウドの 3 か所にある。クラウドのもの(旧名 routines)は研究プレビュー |
| A-2 環境の再現性 | 製品の外で決める(devcontainer・Dockerfile・lock ファイル) |
| A-3 隔離 | 組み込みのサンドボックスがある(既定では無効で、/sandbox か設定 sandbox.enabled で有効にする)。囲むのはシェルのコマンドと、そこから起きた処理。書き込みは作業のフォルダなどに限られ、外部への通信は許可したドメインだけになる(許可の一覧は空から始まる)。ファイル編集のツール・MCP サーバー・hook はサンドボックスの外で動く。macOS・Linux・WSL2 で動き、Windows のネイティブ環境では動作しない |
| A-4 モデルの使い分け | モデルは Fable 5.2・Opus 5.5・Sonnet 5.5・Haiku 5.5 の 4 つ(いずれも文脈 1M トークン・adaptive thinking あり)。サブエージェントの定義ファイルに model: と effort: を書いて役割ごとに固定できる |
B 制御・安全(5 要素)
| 要素 | Claude Code での実物(機能・設定・ファイル) |
|---|---|
| B-1 禁止の定義(ガードレール) | 規範は CLAUDE.md・.claude/rules/*.md に書く。強制は .claude/settings.json の permissions.deny と hook(PreToolUse など) |
| B-2 ツールと権限 | permissions の allow / ask / deny(同じ操作に複数当たれば deny > ask > allow)。権限のモードは 6 つ。端末と VS Code では、別のモデルが操作を事前に審査する auto mode が最初に選ばれるようになった(v2.1.283 以降)。6 つは、Manual(設定の値は default。読むだけ自動)・acceptEdits(ファイル編集と基本のファイル操作も自動)・plan(計画だけ)・auto(別のモデルが事前に審査)・dontAsk(許可済み以外は断る)・bypassPermissions(全部通す。隔離したコンテナ向け)。サブエージェントごとに tools: で渡すツールを絞れる |
| B-3 外部から入る指示(プロンプトインジェクション) | 製品側: auto mode は 2 段の守り(読んだ内容を検査する仕組みと、操作を事前に審査するモデル)をプロンプトインジェクション対策として持つ。ただし公式も、これで安全とは保証していない。設計側: 外部の入力を読む役(サブエージェント)に書き込みと Bash を渡さない |
| B-4 シークレット管理 | permissions.deny に Read(**/.env) などを書いて読み取りを拒否。PreToolUse の hook で git commit の前に検査を走らせる(forva AI の開発では、公開されている検査ツールと独自の検査を併用) |
| B-5 データの扱いと保持 | データの保持は、商用(Team・Enterprise・API)の標準が 30 日。Fable 5.2 は 30 日の保持が前提で、ゼロデータ保持 (ZDR) では使えない(Anthropic が認めた場合を除く)。商用の規約のもとでは、送ったコードやプロンプトをモデルの学習に使わない(自分から提供の仕組みに参加した場合を除く)。個人のプラン(Free・Pro・Max・Ultra)は、学習への利用を許すと 5 年、許さないと 30 日。Claude Enterprise では、Enterprise のアカウントで使った Claude Code のセッションの記録を、Compliance API で取り出せる |
C コンテキスト・知識(4 要素)
| 要素 | Claude Code での実物(機能・設定・ファイル) |
|---|---|
| C-1 コンテキスト管理 | CLAUDE.md(常に読む)・.claude/rules/(常に読む。読む条件をパスで絞れるものもある)・skill(必要なときに読む手順書)・サブエージェントの定義。AGENTS.md は、CLAUDE.md が無いときに代わりに読む(設定で両方読ませることもできる) |
| C-2 指示書の設計 | .claude/agents/<役割>.md(役割の定義)・.claude/skills/<名前>/SKILL.md(手順書)。Agent Skills の形式は 2026-10-22 に Linux Foundation の下の Agentic AI Foundation (AAIF) へ寄贈された |
| C-3 記憶 | auto memory(Claude が自分で書く記憶。既定で有効)。既定の置き場は ~/.claude/projects/<プロジェクト>/memory/ で、マシンごと(ほかのマシンとは共有されない)。設定 autoMemoryDirectory で置き場を変えられる |
| C-4 文書 | 製品の外で決める(README・設計書・判断の記録をリポジトリに置く) |
D タスク実行(4 要素)
| 要素 | Claude Code での実物(機能・設定・ファイル) |
|---|---|
| D-1 計画と分割 | plan mode(6 つの権限のモードの 1 つ plan。調べて計画を出させ、承認してから実装へ。Shift+Tab か /plan で入る) |
| D-2 作業の隔離とバージョン管理 | claude --worktree <名前> で、作業ごとに git の worktree とブランチを作って起動する |
| D-3 並列と分担 | サブエージェント・複数のセッションを一画面で管理する agent view・dynamic workflows・Projects。エージェント同士が直接やり取りする Agent Teams は試験的な機能で、既定では無効。agent view は研究プレビュー、Projects は Pro・Max・Ultra で公開ベータ(Team・Enterprise はまだ) |
| D-4 失敗からの回復 | checkpointing(プロンプトを送るたびに、Claude のファイル編集の前の状態を自動で残す)。/rewind か Esc を 2 回で、コード・会話・その両方を戻せる。Bash のコマンドだけで変えたファイル・外での変更・多くのサブエージェントの編集は戻らず、git の代わりにはならない。製品の外: 途中の状態をファイルに書かせる |
E 品質保証(3 要素)
| 要素 | Claude Code での実物(機能・設定・ファイル) |
|---|---|
| E-1 自動検証 | PostToolUse の hook で、Edit / Write の後に整形と lint を自動で走らせる。CI は GitHub Actions など |
| E-2 検証の独立 | レビュー役のサブエージェントに tools: Read, Grep, Glob だけを渡し、書き換えられないようにする |
| E-3 費用と待ち時間 | 公式の資料によると、企業での導入全体で見た開発者 1 人あたりの平均は、使った日 1 日に約 $13、月に $150〜250。利用者の 90% は 1 日 $30 未満(API のトークンの量で数えた額。モデル・コードの規模・使い方で大きく変わる)。どのプラン・期間・何社の集計かは書かれていない。Team・Enterprise の席のプランでは、使用量は席ごとの枠から引かれ、枠の中はドルで数えないため、この数字は当てはまりにくい 公式の資料 (Costs) |
F 運用・組織(4 要素)
| 要素 | Claude Code での実物(機能・設定・ファイル) |
|---|---|
| F-1 記録と管理 | 組織は managed settings(利用者・プロジェクトの設定より優先する設定)を配れる。配り方は、claude.ai の管理画面 (server-managed settings)・MDM や OS のポリシー・各マシンの managed-settings.json のいずれか。ほかに既定で導入する拡張・必須の指定・Compliance API がある。プロジェクトの設定は .claude/settings.json を git で配る |
| F-2 拡張と依存の供給網 | プラグインは hook・MCP サーバー・実行ファイルなどのコードを含められ、利用者の権限で動く。組織は managed settings で、許可するマーケットプレイス・強制で有効にするプラグイン・禁止するプラグインを決められる。Enterprise のプランでは、メンバーがアップロードした外部の skill とプラグインに悪意の検査をかけられる(MCP サーバーは対象外。安全の保証ではない)。MCP は仕様 2026-07-28(状態を持たない作り) |
| F-3 ナレッジの共有 | skill とプラグインで、手順をチームに配る |
| F-4 法務・コンプライアンス | OWASP Top 10:2025・AI 事業者ガイドライン(第 1.2 版) |
forva AI のハーネス設計
forva AI の開発では、実装とテストをエージェントが担い、人はお客さまの課題と向き合い、業務に合う設計に時間を使います。これを支えるのが、AI に任せる範囲と人が判断する範囲を、指示書の文面に頼らず、権限の設定・hook・役割の分離で強制する設計です。
設計の原則
- 権限は、許可・確認・拒否の 3 区分で定めます。どの区分にも当たらない操作は、auto mode の事前審査に委ね、人の確認を待つ回数を減らします。ただし審査は安全を保証するものではないため、取り消せない操作は審査に委ねず、拒否と hook で止めます。
- 役割ごとに、使うモデルと思考の深さを定義ファイルで固定し、指定漏れによる品質の低下を防ぎます。
- 作業を任せたエージェントには、履歴を変える git の操作を許しません。commit と push は、まとめ役のセッションだけが行います。
- シークレットの検査は、commit の前に、複数の方式を重ねて行います。
切り分けの考え方
| 切り分け | 対象の操作 | 仕組み |
|---|---|---|
| AI に任せる | 読む・調べる操作(git status・git log --oneline など) | allow に指定し、確認なしで通す |
| 人が判断する | 外部への反映(git push) | ask に指定し、実行のたびに人が確認する |
| 仕組みで止める | 鍵のファイルの読み取りと、取り消せない操作 | deny で拒否する。commit の前には、シークレットの検査を hook で走らせる |
| 仕組みで整える | ファイルを書き換えた後の整形と lint | PostToolUse の hook で、書き換えのたびに自動でかける |
| 役割で分ける | 成果物の検証 | 書き換えの権限を持たないレビュー用のエージェントが独立して検証し、指摘だけを返す |
以下は、この設計を実装した設定から B-2・B-4・E-1・E-2 に当たる所を抜き出したものです(公開用に編集し、短くしています)。チームで設定を書くときの下敷きとしてお使いください。
1. 取り消せない操作を、設定で止める(B-2・B-4)
.claude/settings.json の一部:
{
"permissions": {
"deny": [
"Read(**/.env)",
"Bash(rm -rf *)",
"Bash(git push --force *)",
"Bash(git reset --hard *)"
],
"ask": [
"Bash(git push *)"
],
"allow": [
"Bash(git status)",
"Bash(git log --oneline *)"
]
}
}
読むだけの操作は確認なしで通し、外部への反映 (git push)
は実行のたびに人が確かめます。鍵のファイルの読み取りと、取り消せない操作は拒否します。
実際の設定では、オプションの書き方の違い(-f・-fr
など)も並べています。パターンによる拒否は、書き方を変えると一致しなくなることがあるため、hook
による検査と組み合わせます。
2. commit の前にシークレットを検査し、書き換えの後に整形する(B-4・E-1)
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "<commit 前の秘匿情報の検査スクリプト>"
}
]
}
],
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "npx prettier --write <書き換えたファイル>"
},
{
"type": "command",
"command": "npx eslint --fix <書き換えたファイル>"
}
]
}
]
}
}
エージェントが commit
しようとするたびにシークレットの検査が走り、見つかれば commit
を止めます(スクリプトの中で、git commit
のときだけ検査します)。ファイルを書き換えた後には、整形と lint が自動でかかります。
3. 検証の独立: レビュー役から、書き換える権限を外す(E-2)
.claude/agents/reviewer.md の先頭:
---
name: reviewer
model: opus
effort: high
tools: Read, Grep, Glob
--- レビュー用のエージェントには、読み取りと検索のツールだけを渡します。ファイルを変更できないため、実装した側から独立した立場で指摘を返します。
この設計の狙いは、AI に任せる範囲を広げても、人が判断すべき所を人の手元に残すことです。定型の確認は仕組みが受け持ち、人はお客さまの業務に合う設計を考えることに時間を割きます。
24 項目のチェックリスト
現在の設定で満たしている項目にチェックを入れてください。★ は「先に決める 5 項目」です。チェックの内容はこのページの中だけで扱い、外部には送信しません。
A 実行基盤(4 項目)
B 制御・安全(5 項目)
C コンテキスト・知識(4 項目)
D タスク実行(4 項目)
E 品質保証(3 項目)
F 運用・組織(4 項目)
未チェックの項目(24項目)
6 層・24 要素を、お客さまの開発に合わせて設計します。
お客さまの開発体制の現状を踏まえ、最初に整える層と、エージェントに任せる範囲をご提案します。IT コンサルティングのご契約で承ります。