変更先を一つ選んで、食い違いを直してみる。
実装担当に任せた範囲は src/**。依頼の変更先をその中に戻すと、この例の結果がFAILからPASSに変わります。
固定サンプルの結果を切り替える体験例です。実際の検査は、下のコマンドで試せます。
- 実装する担当
implementer- 設定した変更範囲
src/**
FAIL変更範囲の外を指定しています
secrets/production.txt は、実装担当に設定した src/** の外です。
サンプルの出力を見る
FAIL: explain (declarations only; execution NOT authorized)
TASK_WRITE_SCOPE_OUTSIDE_AUTHORITY task/inputs/scope:
Task scope is outside declared write scopes for role implementer: secrets/production.txtARCは設定と依頼内容の整合性を検査します。実際の操作権限は、利用中の実行環境で管理します。
ARC 1.0.0のstandalone consumer starterを架空・非機密のタスクで試した、本人による感想です。本番導入の報告ではありません。このページの対象は1.0.1です。
It still catches declaration vs write-scope mismatches that prompt instructions alone miss.こんな役割設定の食い違いを見つけます
以下の結果は、1.0.1 stable releaseパッケージに同梱のサンプルで得られたものです。
AUTHORITY_CONTRADICTION
読み取り専用なのに、書き込みも許可していた
filesystem.write.scoped を許可と禁止の両方に挙げている役割や、読み取り専用なのに書き込みを持つ役割を指摘します。
SELF_REVIEW_DECLARED
実装した担当を、そのままレビュー担当にしていた
同じ役割を実装担当とレビュー担当の両方に置いたルートや、読み取り専用でないレビュー担当を拒否します。
ROLE_REFERENCE_UNKNOWN
引き継ぐ相手が、チームの設定にいなかった
バンドルにない役割(例: ghost)を指す関係は、見逃さずに報告します。
同じ検査を、手元で動かす。
Git・Node.js 22.5以上・npmが入っていれば試せます。agent-role-contracts フォルダがない場所で実行してください。APIキーやアカウント登録は不要です。
git clone --depth 1 --branch v1.0.1 https://github.com/suirindo/agent-role-contracts.git
npm --prefix agent-role-contracts run demo --silentPASS → 範囲外の依頼でFAIL → 修正してPASS、の順に実行します。依存パッケージのインストールは不要です。ソースの取得時には通信します。
次は、下のnpmパッケージで自分のタスクを検査できます。役割の設定を残して、依頼内容を変えるたびに同じチェックを使えます。
自分のタスクでも、検査してみる
空のフォルダに公開版パッケージを入れ、同梱のスターター用サンプルをチェックします。
mkdir agent-role-contracts-first-check
cd agent-role-contracts-first-check
npm init --yes
npm install --ignore-scripts @netsujo/agent-role-contracts@1.0.1
npx --no-install agent-role-contracts explain \
--bundle node_modules/@netsujo/agent-role-contracts/examples/starter-bundle.json \
--task node_modules/@netsujo/agent-role-contracts/examples/starter-task.json \
--format text出力の例(Example・抜粋)
PASS: explain (declarations only; execution NOT authorized)
Accountable: implementer
Reviewers: reviewer
Human approval required: true- validate はバンドルだけを検査します。
- explain は1つのタスクの書き込み範囲も検査します。
- handoff は別に渡した引き継ぎ文書を検査します。
終了コード: 0 は PASS、1 はルール違反、2 はCLI・ファイルの問題で判定なしです。
FAIL を見るには、starter-task.json を starter-task-outside-scope.json に差し替えます。
PASS が意味すること
意味すること
- 渡された宣言が、このバージョンが適用するルールのもとで矛盾していない。
- 実行したコマンドが行った検査だけが対象です。validate はバンドル、explain は渡されたタスクも、handoff は渡された引き継ぎ文書も検査します。
意味しないこと
- 何かが実行・隔離・強制されたこと。エージェントの実行基盤でもサンドボックスでもありません。
- 本人性や証跡が検証されたこと、ファイルシステムが走査されたこと。
- エージェントの出力がスキーマに合うこと、マージやデプロイが承認されたこと。
- 作業が安全であること。コマンドの出力にも、実行は許可されていない(NOT authorized)と必ず表示されます。
自社の一つの業務で、導入する意味を確かめる
サンプルのPASSを確認したら、変更依頼から実装、別担当のレビュー、受入、引き継ぎまで、普段の業務を一件選びます。 機密を含まない入力や架空データから始め、実装者・レビュー担当・変更範囲・人だけが判断する操作を書き出してください。
- スターターのタスクをコピーし、自社の役割と対象範囲に合わせます。
- 範囲外のパスや同じ役割による自己レビューなど、前提を意図的に変え、対応するコマンドが拒否するか確認します。
- 二つの実タスクで、準備・保守にかかった時間、見つかった矛盾、表現できない条件、再確認の負担を記録します。既存CIや権限管理で十分なら、追加しない判断もできます。
詳細は1.0.1に固定した業務評価手順に沿って進めます。 このページとインストール例の対象は安定版1.0.1です。0.5.0は互換性の基準で、30秒動画は0.5.0公開時の紹介です。
現行の業務評価キット(実験用)では、mainの現行helperを置くarc-kitと、評価対象をv1.0.0に固定するarc-v1の2つをcloneします。helperのコミットはcoreの版と分けて記録してください。
宣言の整合性はARC、本人確認は認証基盤、実際の操作制限はIAM・CI・サンドボックス、業務の完了は受入確認で別々に確かめます。 評価のために本番権限を与えたり、PASSを実行許可へ読み替えたりする必要はありません。
既存環境への接続を相談する
一つの業務フロー、最近起きた失敗や再確認の負担、利用中のCI・権限設定・レビュー手順をご用意ください。 どの宣言をどこで検査し、実際の制限を既存環境のどこで担うかを整理する相談です。 個別環境への適用や設定変更が必要な場合は、作業範囲を別途確認します。
ARCを既存の開発・運用へ適用する相談相談内容に「ARCの業務評価」と、確認したい一件の流れをお書きください。機密情報や認証情報の送付は不要です。
公開検証・外部掲載と、使い方の資料
- 1.0.1 の READMEコマンド、スキーマ、サンプル。
- 自分のリポジトリで使う(実験用)公開版1.0.0を使うソース専用の設定例です。必要な入口を一つ選びます。
- 現行の業務評価キット(実験用)2つのcheckoutを使います。arc-kitはmainの現行ソース専用helper、arc-v1は評価対象の固定v1.0.0 coreです。helperのコミットを別に記録し、合成ベースラインから一件の実業務と既存の制御の比較へ進みます。
- 1.0.1に固定した業務評価手順安定版に同梱された手順です。2つのcheckoutの準備は上の現行キットで確認できます。
- npm パッケージ@netsujo/agent-role-contracts@1.0.1
- 30秒の紹介動画0.5.0公開時の紹介です。このページの対象は1.0.1です。
- GitHub リポジトリ公開ソースとIssue。ShipRules-freeとの合成4ケース比較はメンテナーが実行済みで、相手側の実行・レビューは待機中です。役割・パスの説明に関する公開フィードバックも評価手順に反映しました。
- openPR プレスリリース公開済みの英語プレスリリース。
- AIエージェント信頼インフラR&Dこの宣言レイヤーをNetsujo Agent OSと信頼インフラ全体の中で位置づけます。
- 公開議論から見直した3つの条件公開フィードバックから権限の出所、証拠の帰属、再実行の条件を見直しました。10月31日の追記では、限定的な実行環境の観測とARCの強制力を区別。ARCによる追加の実行制限は実証されておらず、別々の実業務2件での価値測定も未達です。
- PASS は何を示すかチェッカーの限界まで書いた技術記事。
- awesome-agent-trust での掲載自薦による申請後、2026年10月30日、第三者のOSSリストに、リスト管理者のレビューを経て掲載されました。セキュリティ監査や認証、実業務での採用を示すものではありません。
- awesome-ai-coding-tools での掲載2026年10月30日、launchapp-devのOSSリストに、ボットの自動マージで掲載されました。
- awesome-ai-agent-tools での掲載2026年10月19日、michielhdotethのOSSリストに、ボットの自動マージで掲載されました。
- SilentStars での掲載2026年10月31日、OSSディレクトリの自動審査を経て掲載されました。専門家による推薦ではありません。
- AlternativeTo の製品ページ公開製品プロフィール。2026年10月31日に公開を確認。現行仕様は上のREADMEで確認できます。
- SaaSHub の製品ページソフトウェア比較サービス。2026年10月31日に公開を確認。
- ITreview の製品ページ国内のIT製品レビューサイト。2026年10月31日に公開を確認。
