メインコンテンツへスキップ

Agent Role Contracts · オープンソース

AIの役割分担を、実行前にテスト。

変更してよい場所、実装する担当、レビューする担当。ARCは、決めたルールと依頼内容の食い違いを見つけます。

リリース
npm latest の 1.0.1
ライセンス
MIT
動作環境
Node.js 22.5 以上
通信
ソース・パッケージの取得時。検査はオフライン

安定版 1.0.1 · MITライセンス。公開フィードバックを評価手順と設計文書へ反映。awesome-agent-trustに、リスト管理者のレビューを経て掲載されました。

Netsujo Agent Role Contracts badge

変更先を一つ選んで、食い違いを直してみる。

実装担当に任せた範囲は src/**。依頼の変更先をその中に戻すと、この例の結果がFAILからPASSに変わります。

固定サンプルの結果を切り替える体験例です。実際の検査は、下のコマンドで試せます。

実装する担当
implementer
設定した変更範囲
src/**
依頼の変更先を選ぶ

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.txt

ARCは設定と依頼内容の整合性を検査します。実際の操作権限は、利用中の実行環境で管理します。

ARC 1.0.0のstandalone consumer starterを架空・非機密のタスクで試した、本人による感想です。本番導入の報告ではありません。このページの対象は1.0.1です。

It still catches declaration vs write-scope mismatches that prompt instructions alone miss.
— Prashant Chaurasiya, founder of Aryabhatt AI

こんな役割設定の食い違いを見つけます

以下の結果は、1.0.1 stable releaseパッケージに同梱のサンプルで得られたものです。

  1. AUTHORITY_CONTRADICTION

    読み取り専用なのに、書き込みも許可していた

    filesystem.write.scoped を許可と禁止の両方に挙げている役割や、読み取り専用なのに書き込みを持つ役割を指摘します。

  2. SELF_REVIEW_DECLARED

    実装した担当を、そのままレビュー担当にしていた

    同じ役割を実装担当とレビュー担当の両方に置いたルートや、読み取り専用でないレビュー担当を拒否します。

  3. 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 --silent

PASS → 範囲外の依頼で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を確認したら、変更依頼から実装、別担当のレビュー、受入、引き継ぎまで、普段の業務を一件選びます。 機密を含まない入力や架空データから始め、実装者・レビュー担当・変更範囲・人だけが判断する操作を書き出してください。

  1. スターターのタスクをコピーし、自社の役割と対象範囲に合わせます。
  2. 範囲外のパスや同じ役割による自己レビューなど、前提を意図的に変え、対応するコマンドが拒否するか確認します。
  3. 二つの実タスクで、準備・保守にかかった時間、見つかった矛盾、表現できない条件、再確認の負担を記録します。既存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の業務評価」と、確認したい一件の流れをお書きください。機密情報や認証情報の送付は不要です。