タイプ: アーキテクチャ ステータス: 承認済み 最終レビュー日: 2026-07-25 関連先:
- 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-015 | 提案済み | 統合機能カタログは、パッケージ、機能、実装、構成、ランタイムの各所有者に対する読み取り専用の投影です。 |
ADR-006 と ADR-007 は FND-002 による実装ゲート付きのロードマップ決定です。目標とする方向性は記録されていますが、各レコードの受け入れ基準が出荷されるまでは提案段階のままです。
ADR-010は、記録内の承認条件が満たされるまで提案済み状態のままとなります。
ADR-012 は、正規設定の公開、世代スコープの結果、およびセキュリティとチャネルの範囲限定されたライブ適用コンシューマーが、記録に定められた受け入れゲートを満たすまで、提案中のままとします。
ADR-013 は、正規のキーソース境界、安全なファイル互換性、設定済みのフェイルクローズ選択、およびサポート対象の非ファイルソースが、記録に記載された受け入れゲートを満たすまで、提案中のままとします。
ADR-015 は、統合カタログ投影が、信頼できる唯一の情報源の証拠、アーティファクトの来歴、互換性ブリッジ、および可視性によって呼び出し権限を付与できないという規則を保持するまで、提案中のままとする。