Skip to content

ADR 0001: Deterministic core

Status: accepted, 2026-07-22.

The graph, policy, state machine, persistence decisions, and recorded replay remain model-independent. Provider, tool, filesystem, process, MCP, A2A, internal-state mutation, clock, and ID behavior cross injected interfaces and receive durable effect identity when externally observable.

This keeps models replaceable and tests credential-free. It requires more records and conservative uncertain states, but avoids hidden calls during replay. Dynamic model-owned orchestration is rejected.

Canonical source: docs/adr/0001-deterministic-core-explicit-effects.md. Verified against agentctl commit 2aeaa88fba71162206b5f08f5bda4f0150247e4f.