type: architecture statut: accepté dernière-révision: 2026-07-25 se-rapporte-à:
- docs/book/src/foundations/fnd-002-documentation-standards.md
Enregistrements de décisions architecturales
Les Architecture Decision Records (ADRs) constituent la trace pérenne des choix d’architecture qui contraignent les futurs travaux sur ZeroClaw. Ils sont plus courts que les RFC : chacun consigne le contexte, la décision, les conséquences et les sources qui justifient cette décision.
Les ADR acceptés sont immuables. Si l’architecture change, rédigez un nouveau ADR et marquez l’ancien comme supersédé plutôt que de réécrire l’historique.
ADRs actuels
| ADR | Statut | Décision |
|---|---|---|
| ADR-001 | accepté | Le runtime et les crates first-party de ZeroClaw sont implémentés en Rust. |
| ADR-002 | accepté | Les surfaces d’extension de première partie utilisent des contrats de trait explicites. |
| ADR-003 | remplacé par ADR-009 | Les plugins WASM utilisaient initialement Extism comme pont d’exécution. |
| ADR-004 | accepté | L’état partagé détenu par l’outil suit l’identité détenue par le démon, la propriété des handles, l’isolation et les règles de rechargement. |
| ADR-005 | accepté | Le stockage de la mémoire repose sur un contrat indépendant du backend, SQLite étant la valeur par défaut. |
| ADR-006 | proposé | Les plugins d’exécution sont la cible des canaux optionnels, avec des exceptions natives explicites basées sur les capacités lors de la migration. |
| ADR-007 | proposé | La passerelle devient un processus optionnel distinct via un contrat IPC local pris en charge. |
| ADR-008 | accepté | Le mode Goal utilise le plan de contrôle des tâches durables et le registre d’utilisation canonique. |
| ADR-009 | accepté | Les composants WIT et wasmtime direct remplacent le pont de plugins Extism. |
| ADR-010 | proposé | L’historique de session, la mémoire organisée et l’enrichissement ont des périmètres d’autorité distincts. |
| ADR-011 | accepté | Les agents configurés disposent de limites d’exécution explicites sous un même démon. |
| ADR-012 | proposé | L’application de configuration en direct utilise des générations canoniques et des résultats spécifiques à la cible. |
| ADR-013 | proposé | L’acquisition de la clé maîtresse utilise une seule autorité de source de clés configurée. |
| ADR-015 | proposé | Le catalogue unifié des capacités est une projection en lecture seule des propriétaires de packages, de capacités, d’implémentations, de configurations et d’environnements d’exécution. |
ADR-006 et ADR-007 sont des décisions de feuille de route conditionnées par l’implémentation issues de FND-002. Leurs orientations cibles sont consignées, mais elles restent proposées jusqu’à la livraison des limites d’acceptation définies dans chaque enregistrement.
ADR-010 reste proposé jusqu’à ce que les critères d’acceptation du document soient satisfaits.
ADR-012 reste à l’état proposé jusqu’à ce que la publication de la configuration canonique, les résultats délimités par génération, ainsi que les consommateurs de live-apply liés à la sécurité et aux canaux satisfassent aux critères d’acceptation définis dans le document.
ADR-013 reste à l’état de proposition jusqu’à ce que la frontière canonique de la source de clés, la compatibilité sécurisée des fichiers, la sélection configurée en mode de refus par défaut et une source non basée sur un fichier prise en charge satisfassent aux conditions d’acceptation consignées dans l’enregistrement.
ADR-015 reste à l’état de proposition jusqu’à ce que les projections de catalogue unifiées préservent les éléments probants de la source de vérité, la provenance des artefacts, les ponts de compatibilité et la règle selon laquelle la visibilité ne peut pas conférer de droits d’invocation.