effect-facet-unstable-cluster-runners-theme

star 3

Guidance for facet `effect/unstable/cluster#runners` focused on APIs like Runner, Runners, and RunnerHealth. 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-runners-theme description: Guidance for facet effect/unstable/cluster#runners focused on APIs like Runner, Runners, and RunnerHealth. Load after effect-skill-router when this facet is the primary owner.

Effect Facet unstable/cluster#runners

Owned scope

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

What it is for

  • runner fleet execution domain. Module-specific APIs and usage patterns for Effect programs.

API quick reference

  • Runner
  • Runners
  • RunnerHealth
  • RunnerServer
  • RunnerAddress
  • RunnerStorage
  • HttpRunner
  • TestRunner
  • SingleRunner
  • SocketRunner
  • EntityAddress
  • K8sHttpClient
  • EntityProxyServer
  • SingletonAddress
  • SqlRunnerStorage
  • Full API list: references/api-reference.md

How to use it

  • Keep work focused on the runners 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.Runner();
const next = cluster.Runners(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-runners-theme
Repository Details
star Stars 3
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator