Effect Deep Dive Overview

This track explains the internals that make cliq deterministic and hackable. Each article traces real code and highlights the Effect patterns behind it.

Topics

• Effect fundamentals — generators, Effect.all, resource scoping, and error channels.
• Layers & dependency injection — composing the runtime graph in src/cli.ts.
• Services & managed runtimes — structuring services as tags and running them safely.
• Error recovery — surfacing causes, retry strategies, and safe shutdowns.
• Performance & concurrency — streaming, batching, and parallel effects.
• Prompt design — building the system prompt and tool-aware instructions.

When to read these

• You are extending cliq to new platforms or adding complex services.
• You want to understand how Effect layers enforce dependency boundaries.
• You are optimising streaming performance or investigating failure modes.

Prefer the Build Series if you need hands-on labs, or the Mechanics track for subsystem walkthroughs.