Collaborative Human Agent Protocol (CHAP)
Collaborative Human Agent Protocol (CHAP) (github.com)
要約
CHAP (Collaborative Human-Agent Protocol) は、人間とエージェントが協力して作業を行うためのプロトコルです。エージェントが作成したドラフトと人間の編集内容を、クエリ、再生、検証可能な「エンベロープ」として保存します。これにより、問題発生時の原因究明が容易になり、開発プロセスにおけるエージェントの意思決定の履歴を追跡・分析することが可能になります。
全文翻訳
協調型人間・エージェントプロトコル (CHAP)
仕事は、数百のエージェントと数百人の人々が参加するチームへと移行しています。エージェントはドラフトを作成し、トリアージし、推奨します。人間は承認し、修正し、却下し、エスカレートします。これらの人間の決定は作業に説明責任を持たせますが、通常はチャットスレッド、チケットコメント、記憶の中にしか記録されません。
CHAPは、これらの決定に明確な構造と監査可能な記録を提供します。エージェントが生成したもの、人間が決定したもの、そしてその理由を、クエリ可能で検証可能な1つのログに記録します。
- 構造化されたオーバーライド。人間がエージェントの作業を編集する場合、その編集は、差分、理由、チームが定義したタグとともに記録されるため、後で修正を分析できます。
- 改ざん検出可能なログ。すべての変更は順序通りに記録されます。ハッシュチェーンがオンになっている場合、最近のチェーンヘッドがオペレーターの手の届かない場所に保持されている限り、改変されたエントリは検証時に検出されます(
SECURITY.md§5)。履歴は、キーのローテーション、ベンダーログの失効、スタッフの変更を経ても存続します。 - 署名とID。プロファイルと呼ばれるオプションの拡張機能は、すべての呼び出しに署名することを要求し、署名キーを検証済みのIDにバインドし、エントリをトランスペアレンシーログに提出します。
- MCPおよびA2Aと並行して。MCPはエージェントとツールを接続し、A2Aはエージェント同士を接続します。CHAPはエージェントが人間と共有する作業を記録します。
コンセプト
CHAPはプロトコルです。これは、エージェント、人間、およびそれらのツールが、ワークスペースを仲介するサービスであるコーディネーターに送信する一連の呼び出しです。コーディネーターは、各呼び出しをワークスペースのルールに対してチェックし、応答し、受け入れられた各変更をワークスペースの監査ログに記録します。TypeScriptおよびPythonパッケージはコーディネーターであり、独自のプロセスに組み込んだり、サーバーとして実行したりできます。
| 用語 | 内容 |
|---|---|
| ワークスペース | 1つの作業体に対する名前付きコンテキスト:そのメンバー、タスク、および使用するプロファイル |
| 参加者 | URI(例: human:alice@example.org または agent:triage)によって名前付けされたメンバー。group: はメンバーのセットを名前付けします |
| タスク | 参加者に割り当てられた作業単位 |
| 成果物 | 参加者がタスクで生成するもの:ドラフト、決定、オーバーライド |
| 封筒 | 1回の呼び出し、JSON-RPC 2.0メッセージとして。その method は動詞です(例: task.create または decide.approve) |
| 監査ログ | ワークスペースのすべての変更の順序付けられた記録。ハッシュチェーンがオンの場合、各エントリは前のエントリのハッシュを含みます |
動詞は名前の通りに読みます。タスクは作成、完了、レビュー依頼(task.create、task.complete、review.request)されます。レビュアーはそれを承認、拒否、またはオーバーライドします(decide.approve、decide.reject、decide.override)。作業は引き継がれたり、エスカレートされたりします(handoff.propose、escalate.raise)。audit.read は記録を返します。
コアとプロファイル。すべてのコーディネーターはコア(core/1.0)を実装しています:ワークスペース、参加者、タスク、および監査ログ。それ以外のすべてはオプションのプロファイルで、バージョン名が付けられています。review/1.0 はレビューリクエストと決定を追加します。その他には、人への簡単な質問(whisper/1.0)、グループ投票(deliberation/1.0)、引き継ぎ(handoff/1.0)、一時停止とロールバック(control/1.0)、ルーティング(routing/1.0)、シャドウおよびトライアルモード(modes/1.0)、署名付き呼び出し(security-signed/1.0)、検証済みID(identity-oidc/1.0、identity-vc/1.0)、およびトランスペアレンシーログ(audit-scitt/1.0)を追加します。ワークスペースは使用しているプロファイルをアドバタイズし、コーディネーターは他のプロファイルに属する呼び出しを拒否します。core/SPEC.md はコアを1ページにまとめ、profiles/PROFILES.md はプロファイルをリストし、GLOSSARY.md はすべての用語を定義します。
インストール
ライブラリ。各パッケージはコアとすべてのプロファイルを実装しています。新しいワークスペースは、指定しない限り core/1.0 と review/1.0 をアドバタイズします。
TypeScript
Python
npm install @brightbeamai/chap-coordinator
pip install chap-coordinator
新しいプロジェクト。create-chap-app は、レビューデスク、1つのプロファイル設定、および diff-profiles コマンドを備えたプロジェクトを生成します。
npx create-chap-app my-gate
cd my-gate && npm install && npm run demo
デフォルトのテンプレートはコードゲートです。コーディングエージェントがGitリポジトリで行った各変更は、差分としてレビューされ、レビュアーの署名で承認され、CIが検証できるように証拠とともにコミットされます。その他のテンプレートは、Claude Desktop、Cursor、Claude Code用のMCPゲート、サポートデスク、アウトバウンド承認ゲート、およびプロダクションセットです。docs/profile-explorer.md は、各プロファイルが何を変更するかを示しています。
このリポジトリのクローンから。START_HERE.md は、Python 3.10以降とインストール不要で、Pythonコーディネーターでローカルレビューデスクを実行します。
git clone https://github.com/BrightbeamAI/chap.git && cd chap
python3 start-here/start.py
examples/00-five-minute-start.md は、curl を使用してコア参照サーバーに封筒を送信し、監査ログを読み戻します。ライブラリは packages/coordinator/ および packages/coordinator-py/ にあり、参照実装は reference/ および reference/python/ にあります。
90秒ツアー
A solo developer reviews pull requests with Cursor, and the bot flags a warning the developer disagrees with. The clip shows the exchange in six steps, in about 23 seconds.
各ステップのコードは、TypeScriptとPythonで提供されます。
1. ワークスペースの起動:SQLiteとハッシュチェーンを備えたコーディネーター、および2人の参加者
TypeScript
Python
import { Coordinator } from "@brightbeamai/chap-coordinator";
import { SqliteStore } from
"@brightbeamai/chap-coordinator/storage/sqlite";
const coord = new Coordinator({
store: new SqliteStore("./chap.db"),
enableChain: true,
});
coord.api.workspace.create({
workspace: "wsp_pr_reviews",
profiles: ["core/1.0", "review/1.0"],
});
coord.api.participant.join({
workspace: "wsp_pr_reviews",
from: "human:me@local",
type: "human",
});
coord.api.participant.join({
workspace: "wsp_pr_reviews",
from: "agent:cursor#v1",
type: "agent",
});
from chap_coordinator import Coordinator
from chap_coordinator.storage.sqlite \
import SqliteStore
coord = Coordinator(
store=SqliteStore("./chap.db"),
enable_chain=True,
)
def send(method, params):
return coord.dispatch({
"jsonrpc": "2.0", "id": method,
"method": method, "params": params,
})
send("workspace.create", {
"workspace": "wsp_pr_reviews",
"profiles": ["core/1.0", "review/1.0"],
})
send("participant.join", {
"workspace": "wsp_pr_reviews",
"from": "human:me@local",
"type": "human",
})
send("participant.join", {
"workspace": "wsp_pr_reviews",
"from": "agent:cursor#v1",
"type": "agent",
})
2. ボットがドラフトし、あなたがオーバーライドする:Cursorインテグレーションが封筒を発行します
TypeScript
Python
// Cursorが返したレビュー。
const cursorReview = {
comments: [{ severity: "warning",
body: "Unused parameter." }],
};
// ボットのレビューはタスクの出力です。
const { task_id } = coord.api.task.create({
workspace: "wsp_pr_reviews",
from: "agent:cursor#v1",
assignee: "agent:cursor#v1",
kind: "code_review",
input: { pr_id: "PR-482" },
});
coord.api.task.complete({
workspace: "wsp_pr_reviews",
from: "agent:cursor#v1",
task_id,
output: cursorReview,
});
coord.api.review.request({
workspace: "wsp_pr_reviews",
from: "agent:cursor#v1",
task_id,
artefact: cursorReview,
to: "human:me@local",
});
// 1つのコメントに同意しません。オーバーライドします。
coord.api.decide.override({
workspace: "wsp_pr_reviews",
from: "human:me@local",
task_id,
intent_preserved: true,
diff: [{ op: "replace",
path: "/comments/0/severity",
value: "info" }],
rationale: "False positive. Framework " +
"convention, not a bug.",
tags: ["false-positive",
"framework-pattern-misread"],
});
# Cursorが返したレビュー。
cusor_review = {
"comments": [{"severity": "warning",
"body": "Unused parameter." }],
}
# ボットのレビューはタスクの出力です。
r = send("task.create", {
"workspace": "wsp_pr_reviews",
"from": "agent:cursor#v1",
"assignee": "agent:cursor#v1",
"kind": "code_review",
"input": {"pr_id": "PR-482"},
})
task_id = r["result"]["task_id"]
send("task.complete", {
"workspace": "wsp_pr_reviews",
"from": "agent:cursor#v1",
"task_id": task_id,
"output": cursor_review,
})
send("review.request", {
"workspace": "wsp_pr_reviews",
"from": "agent:cursor#v1",
"task_id": task_id,
"artefact": cursor_review,
"to": "human:me@local",
})
# 1つのコメントに同意しません。オーバーライドします。
send("decide.override", {
"workspace": "wsp_pr_reviews",
"from": "human:me@local",
"task_id": task_id,
"intent_preserved": True,
"diff": [{"op": "replace",
"path": "/comments/0/severity",
"value": "info"}],
"rationale": "False positive. Framework "
"convention, not a bug.",
"tags": ["false-positive",
"framework-pattern-misread"],
})
2つのサーフェス。TypeScriptは型付きファサード
coord.api.*を提供するため、すべてのメソッドにオートコンプリートとコンパイル時チェックがあります。PythonはJSON-RPC封筒をサーフェスcoord.dispatch({...})に保持し、ここではsend()ヘルパーでラップしています。これはPythonテストで使用されるイディオムです。どちらも同じ封筒で同じパラメータを送信するため、監査チェーンはどちらのクライアントが呼び出しを行ったかに関わらず同じように読み取れます。
3. 2ヶ月後:スクリプトがオーバーライドをタグ、意図、レビュアーごとにグループ化します
リポジトリには、両方の言語でスクリプトが含まれています。これは、HTTP経由で、またはSQLiteファイルから直接監査チェーンを読み取ります。
# TypeScript参照、ステップ1のSqliteStoreに対して:
$ npx tsx reference/core-plus-review/analyze-overrides.ts --db ./chap.db wsp_pr_reviews
# Python参照、同じ考え方:
$ python3 reference/python/analyze_overrides.py --db ./chap.db wsp_pr_reviews
Override Learning Report
========================================
Workspace: wsp_pr_reviews
Total overrides: 47
By tag:
false-positive ████████████████████ 31 (66%)
framework-pattern-misread ██████████████ 22 (47%)
cosmetic-pref █████ 8 (17%)
Intent breakdown:
refining (same decision, better wording) 41
substituting (different decision) 6
Top reviewers:
human:me@local 47
Hint: the most common tags are your next prompt revision targets.
最も一般的なタグは、Cursorの次のプロンプト改訂で修正すべきことを示しています。
chap-analytics(pip install chap-analytics)は、SQLiteファイル、JSONエクスポート、ライブコーディネーター、または audit.read からチェーン全体をドキュメント化されたpandasテーブルにロードします:オーバーライド、決定、レビュアー、ウィスパー、ハンドオフ。 Notebook は1週間のレビューデータを処理し、ANALYTICS_ROADMAP.md は計画されている作業を説明しています。
オーバーライド封筒
オーバーライド封筒は、レビュアーによるエージェントの出力への変更を記録します。各フィールドは以下に注釈付けされています。
分析において最も重要な2つのフィールドは次のとおりです。
intent_preservedは、人間の決定を維持してその言葉遣いを書き直した「リファイン」オーバーライドと、人間が異なる決定を下した「サブスティテュート」オーバーライドを区別します。それぞれが異なる修正を指し示します。1つのポリシー条項の周りの多くのリファインオーバーライドはエージェントの取得を指し、多くのサブスティテュートオーバーライドは曖昧なポリシーまたはエージェントのタスクコンテキストを指します。tagsは、チームが合意した小さく管理された語彙です。3ヶ月後に数えて、「どのプロンプトに作業が必要か?」および「ボットが常に間違えるパスはどれか?」という質問に答えるためのものです。
ステータス
CHAP 0.3は公開ドラフトです。小さなコアとオプションのプロファイル(SPECIFICATION.md)が含まれています。
- 2つの参照コーディネーター(TypeScriptとPython)が同じメソッドを実装しており、差分ファザーがそれらが同様に応答し、ログに記録することを確認しています。
- 適合性ハーネスはコアと
review/1.0をカバーし、PythonコーディネーターとスタンドアロンTypeScriptサーバーに対して実行されます。 - コーディネーターは、MCP サーバーまたは A2A エージェントとして自身を提示できます。
- フレームワークブリッジは、LangGraph、Pydantic AI、AG2、LlamaIndex Workflows、およびGoogle ADKの人間参加型決定を監査ログに配置します。
1.0の前に、マイナーリリースは互換性を破壊する可能性があり、その変更ログには移行とともに各破壊的変更がリストされます。1.0以降は、仕様はセマンティックバージョニングに従います。厳密な安定性を求める場合は、1.0までお待ちください。ROADMAP.md は、それが約束することと、その道のりのマイルストーンを示しています。
次に読むもの
| 読むもの | 対象 |
|---|---|
START_HERE.md | Pythonコーディネーターでのローカルレビューデスク。Python以外のインストールは不要 |
IN_PRACTICE.md | ソロ開発者とCursorからGMP規制製造まで、シナリオ |
ABOUT.md | リポジトリの内容、CHAPがMCPおよびA2Aとどのように関連するか、再利用する標準、および貢献方法 |
core/SPEC.md | コア、1ページにまとめたもの |
| 技術レポート | アーキテクチャ、プロファイルセマンティクス、脅威モデル。シナリオはJSONトレースとして含まれます |
引用
学術的または技術的な作業でCHAPを参照する場合は、技術レポートを引用してください。
BibTeX
@techreport{chap2026,
author = {Shahid, Arsalan and Suttie, Gordon and Black, Philip},
title = {Collaborative Human-Agent Protocol (CHAP): An open protocol for auditable, structured multi-human and multi-agent collaboration},
institution = {Brightbeam AI},
year = {2026},
type = {Technical Report},
number = {arXiv:2606.09751},
url = {https://arxiv.org/abs/2606.09751}
}
CC BY 4.0 (仕様テキスト、LICENSE-SPEC.md参照) · Apache 2.0 (その他すべて) · 任意の言語、任意のデプロイメント。