effect-facet-unstable-cluster-storage

star 3

Guidance for facet `effect/unstable/cluster#storage` focused on APIs like RunnerStorage, MessageStorage, and SqlMessageStorage. Load after `effect-skill-router` when this facet is the primary owner.

TylorS By TylorS schedule Updated 2/21/2026

name: effect-facet-unstable-cluster-storage description: Guidance for facet effect/unstable/cluster#storage focused on APIs like RunnerStorage, MessageStorage, and SqlMessageStorage. Load after effect-skill-router when this facet is the primary owner.

Effect Facet unstable/cluster#storage

Owned scope

  • Owns only effect/unstable/cluster#storage.
  • Parent module: effect/unstable/cluster.

What it is for

  • message/runner storage backends. Module-specific APIs and usage patterns for Effect programs.

API quick reference

  • RunnerStorage
  • MessageStorage
  • SqlMessageStorage
  • SqlRunnerStorage
  • Full API list: references/api-reference.md

How to use it

  • Keep work focused on the storage concern for effect/unstable/cluster.
  • Keep runtime/execute APIs at edges; compose pure transformations before execution.
  • Assume unstable APIs can evolve quickly; isolate usage behind thin local adapters.

Starter example

import { cluster } from "effect/unstable/cluster";

const value = cluster.RunnerStorage();
const next = cluster.SqlRunnerStorage(value);

Common pitfalls

  • Unstable module contracts may change; avoid coupling core app logic directly to experimental details.
  • Prefer explicit, typed combinators over ad-hoc casting or unchecked assumptions.

Not covered here

  • Sibling facets under the same parent are out of scope:
    • effect-facet-unstable-cluster-clustercron (effect/unstable/cluster/ClusterCron)
    • effect-facet-unstable-cluster-clustererror (effect/unstable/cluster/ClusterError)
    • effect-facet-unstable-cluster-clustermetrics (effect/unstable/cluster/ClusterMetrics)
    • effect-facet-unstable-cluster-clusterschema (effect/unstable/cluster/ClusterSchema)
    • effect-facet-unstable-cluster-clusterworkflowengine (effect/unstable/cluster/ClusterWorkflowEngine)
    • effect-facet-unstable-cluster-core (effect/unstable/cluster#core)
    • effect-facet-unstable-cluster-deliverat (effect/unstable/cluster/DeliverAt)
    • effect-facet-unstable-cluster-entity (effect/unstable/cluster/Entity)
    • effect-facet-unstable-cluster-entityaddress (effect/unstable/cluster/EntityAddress)
    • effect-facet-unstable-cluster-entityid (effect/unstable/cluster/EntityId)
    • effect-facet-unstable-cluster-entityproxy (effect/unstable/cluster/EntityProxy)
    • effect-facet-unstable-cluster-entityproxyserver (effect/unstable/cluster/EntityProxyServer)
    • effect-facet-unstable-cluster-entityresource (effect/unstable/cluster/EntityResource)
    • effect-facet-unstable-cluster-entitytype (effect/unstable/cluster/EntityType)
    • plus 29 additional sibling facets.
  • Parent module ownership belongs to effect-module-unstable-cluster.

Escalate to

  • effect-module-unstable-cluster for parent module-wide workflows.
  • effect-skill-router for cross-module routing and ownership checks.

Reference anchors

  • Parent tests: packages/effect/test/cluster/ClusterWorkflowEngine.test.ts
  • Parent tests: packages/effect/test/cluster/Entity.test.ts
  • Parent tests: packages/effect/test/cluster/MessageStorage.test.ts
  • Parent tests: packages/effect/test/cluster/Sharding.test.ts
  • API details: references/api-reference.md
  • Usage notes: references/usage-reference.md
  • Ownership mapping: references/owner.md
Install via CLI
npx skills add https://github.com/TylorS/typed-smol --skill effect-facet-unstable-cluster-storage
Repository Details
star Stars 3
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator