Effect-TS Patterns for TMNL

CRITICAL DOCTRINE: Atom-as-State

NO EFFECT.REF. EVER.

When React is the consumer via effect-atom, Atom.make() is the primary state mechanism—not Effect.Ref inside services.

• Service methods mutate Atoms directly (Atom.set)
• React subscribes directly to atoms
• This eliminates the Ref→Atom bridge: no polling, no SubscriptionRef, no streams-to-consume-streams

Canonical Sources

Effect-TS Core Documentation

• Submodule: ../../submodules/effect/ (from packages/tmnl)
• Website docs: ../../submodules/website/ (human-authored, battle-tested)
• Test patterns: ../../submodules/effect/packages/*/test/*.test.ts