tipo: arquitectura estado: aceptado última-revisión: 2026-07-25 relacionado-con:
- docs/book/src/foundations/fnd-002-documentation-standards.md
Registros de decisiones de arquitectura
Los Registros de Decisión de Arquitectura (ADRs) son el registro duradero de las decisiones de arquitectura que condicionan el trabajo futuro de ZeroClaw. Son más breves que los RFC: cada uno registra el contexto, la decisión, las consecuencias y las fuentes que justifican la decisión.
Los ADR aceptados son inmutables. Si la arquitectura cambia, escribe un nuevo ADR y marca el anterior como reemplazado en lugar de reescribir la historia.
ADRs actuales
| ADR | Estado | Decisión |
|---|---|---|
| ADR-001 | aceptado | ZeroClaw’s runtime and first-party crates are implemented in Rust. |
| ADR-002 | aceptado | Las superficies de extensiones de primera parte usan contratos de rasgo explícitos. |
| ADR-003 | sustituido por ADR-009 | Los plugins de WASM usaban inicialmente Extism como puente de ejecución. |
| ADR-004 | aceptado | El estado compartido mantenido por la herramienta sigue las reglas de identidad, propiedad del handle, aislamiento y recarga propiedad del daemon. |
| ADR-005 | aceptado | El almacenamiento en memoria utiliza un contrato independiente del backend con SQLite como opción predeterminada. |
| ADR-006 | propuesto | Los plugins en tiempo de ejecución son el objetivo de los canales opcionales, con excepciones nativas explícitas basadas en capacidades durante la migración. |
| ADR-007 | propuesto | La puerta de enlace se convierte en un proceso opcional independiente sobre un contrato IPC local compatible. |
| ADR-008 | aceptado | El modo objetivo usa el plano de control de tareas duraderas y el libro de uso canónico. |
| ADR-009 | aceptado | Los componentes WIT y wasmtime directo reemplazan el puente de plugins de Extism. |
| ADR-010 | propuesto | El historial de sesión, la memoria seleccionada y el enriquecimiento tienen límites de autoridad separados. |
| ADR-011 | aceptado | Los agentes configurados tienen límites de tiempo de ejecución explícitos bajo un único demonio. |
| ADR-012 | propuesto | La aplicación de configuración en tiempo real utiliza generaciones canónicas y resultados específicos del destino. |
| ADR-013 | propuesto | La adquisición de la clave maestra utiliza una única autoridad de origen de claves configurada. |
| ADR-015 | propuesto | El catálogo unificado de capacidades es una proyección de solo lectura sobre los propietarios de paquetes, capacidades, implementaciones, configuración y tiempo de ejecución. |
ADR-006 y ADR-007 son decisiones de hoja de ruta condicionadas a la implementación de FND-002. Sus direcciones objetivo están registradas, pero permanecen en estado propuesto hasta que los límites de aceptación definidos en cada registro sean entregados.
ADR-010 sigue en estado propuesto hasta que se cumplan las condiciones de aceptación indicadas en el registro.
ADR-012 permanece propuesto hasta que la publicación de la configuración canónica, los resultados con alcance de generación y los consumidores acotados de aplicación en vivo de seguridad y de canal cumplan los criterios de aceptación del registro.
ADR-013 sigue en estado propuesto hasta que el límite canónico de la fuente de claves, la compatibilidad segura con archivos, la selección configurada con cierre ante fallos y una fuente no basada en archivos compatible cumplan los criterios de aceptación del registro.
ADR-015 permanece propuesto hasta que las proyecciones de catálogos unificados preserven la evidencia de la fuente de verdad, la procedencia de los artefactos, los puentes de compatibilidad y la regla de que la visibilidad no puede otorgar autoridad de invocación.