Skip to content

ADR-0023: Provider Probe is separate from Start

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

Context

Opening provider sessions can start MCP servers/hooks/login browsers or mutate session state.

Decision

Availability/diagnostic probes must be side-effect-minimal and separate from session/run setup.

Consequences

Settings health checks never create real work as a side effect.

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.