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.