type: architecture status: accepted last-reviewed: 2026-08-20 relates-to:
- docs/book/src/foundations/fnd-002-documentation-standards.md
アーキテクチャ決定記録
アーキテクチャ決定記録 (ADR) は、将来の ZeroClaw の作業を制約するアーキテクチャ上の選択の永続的な記録です。RFC より短く、それぞれがコンテキスト、決定、結果、およびその決定を正当化するソースを記録します。
承認済みのADRは不変です。アーキテクチャが変更された場合は、履歴を書き換えるのではなく、新しいADRを作成し、古いものをsupersededとしてマークしてください。
現在のADR
| ADR | ステータス | 決定 |
|---|---|---|
| ADR-001 | 受理済み | ZeroClawのランタイムおよびファーストパーティのクレートはRustで実装されています。 |
| ADR-002 | 受理済み | ファーストパーティ拡張サーフェスは明示的なトレイト契約を使用します。 |
| ADR-003 | ADR-009 により置き換え | WASM プラグインは当初、実行ブリッジとして Extism を使用していました。 |
| ADR-004 | 受理済み | ツールが保持する共有状態は、デーモンが所有するアイデンティティ、ハンドルの所有権、分離、およびリロードのルールに従います。 |
| ADR-005 | 受理済み | メモリストレージは、バックエンドに依存しない契約を使用し、デフォルトでは SQLite を採用しています。 |
| ADR-006 | 提案済み | ランタイムプラグインがオプションチャネルの対象となり、移行中は機能ベースのネイティブ例外を明示的に設けます。 |
| ADR-007 | 提案済み | ゲートウェイは、サポートされているローカル IPC コントラクトを介した、独立したオプションのプロセスになります。 |
| ADR-008 | 受理済み | Goal モードでは、永続的なタスク制御プレーンと正規の使用量台帳を使用します。 |
| ADR-009 | 受理済み | WITコンポーネントと直接的なwasmtimeがExtismプラグインブリッジを置き換えます。 |
| ADR-010 | 提案済み | セッション履歴、厳選されたメモリ、およびエンリッチメントは、それぞれ独立した権限境界を持ちます。 |
| ADR-011 | 受理済み | 設定済みエージェントは、1つのデーモン配下で明示的な実行時境界を持ちます。 |
| ADR-012 | 提案済み | ライブ設定の適用では、正規の世代とターゲット固有の結果を使用します。 |
| ADR-013 | 提案済み | マスターキーの取得には、構成済みの1つのキーソース権限が使用されます。 |
| ADR-014 | 提案済み | Plugin のネットワークアクセスは、ホストが所有する単一の egress 権限によって仲介されます。 |
| ADR-015 | 提案済み | 統合機能カタログは、パッケージ、機能、実装、構成、ランタイムの各所有者に対する読み取り専用の投影です。 |
| ADR-016 | 提案済み | Holding-crateのサブシステムでは抽出がデフォルトであり、例外は限定的に記録・範囲指定され、Core Teamによって承認されます。 |
| ADR-017 | 提案済み | |Inbound authentication resolves credentials into canonical principals and permission-profile grants before privileged runtime surfaces act. |
Wait, that’s not right. Let me restate my output properly:
受信認証は、特権を持つランタイムのサーフェスが動作する前に、認証情報を正規化されたプリンシパルと権限プロファイルの付与に解決します。| |ADR-018|提案済み|ランタイムのセキュリティと来歴は、保護対象のアクション、モデルの受け入れ、内部ターン、正規の証跡について、ランタイムが所有する判断境界を用いて実現されます。|
ADR-006 と ADR-007 は FND-002 による実装ゲート付きのロードマップ決定です。目標とする方向性は記録されていますが、各レコードの受け入れ基準が出荷されるまでは提案段階のままです。
ADR-010は、記録内の承認条件が満たされるまで提案済み状態のままとなります。
ADR-012 は、正規設定の公開、世代スコープの結果、およびセキュリティとチャネルの範囲限定されたライブ適用コンシューマーが、記録に定められた受け入れゲートを満たすまで、提案中のままとします。
ADR-013 は、正規のキーソース境界、安全なファイル互換性、設定済みのフェイルクローズ選択、およびサポート対象の非ファイルソースが、記録に記載された受け入れゲートを満たすまで、提案中のままとします。
ADR-014は、プラグイン転送境界の強制、署名対象となるマニフェスト宣言、オペレーターによる許可の儀式、フリート展開がレコード内の受け入れ基準を満たすまで、「提案済み（proposed）」のままとします。
ADR-015 は、統合カタログ投影が、信頼できる唯一の情報源の証拠、アーティファクトの来歴、互換性ブリッジ、および可視性によって呼び出し権限を付与できないという規則を保持するまで、提案中のままとする。
ADR-016は、保持クレートの契約に例外ルールが明記され、有効な例外の一覧表が含まれ、かつ少なくとも1件の例外が本プロセスを通じて許可または却下されるまで、提案中のままとする。
ADR-017は、正規ID・権限解決、ネイティブおよびピア認証情報の互換性、RPC/WSSの強制、OIDCおよびゲートウェイ連携、プリンシパル所有のセッションおよびプライベートメモリの保存、移行・リカバリのドキュメント、内部オリジンの所有権ルールの各項目が、記録内の受け入れ基準を満たすまで「提案中」のままとなります。
ADR-018は、ランタイムアクションパイプライン、イングレス/プロバンスエンベロープ、内部プリンシパルの会話バインディング、ピア返信のプロバンス、分離された結果、永続的な監査経路、および実装のラチェットが、本記録に定義された受け入れゲートを満たすまで、提案段階のままとします。