Skip to content

ADR-0024: Authoritative domain state stays in the core

  • Status: Accepted
  • Date: 2026-09-10

Context

Global client stores of process/session/domain state can leak between views and drift from server reality.

Decision

React queries/subscriptions represent core state; Zustand is reserved for ephemeral presentation state.

Consequences

Sensitive actions can reconcile core truth rather than trusting indefinitely stale UI state.

Change rule

If implementation evidence proves this wrong, update the canonical architecture/product document first and then supersede/amend this ADR. The ADR is not allowed to keep current docs stale.

Forge is local-first. The docs are part of the product engineering system.