Guides

Build something.

Concepts tell you what the primitives are. Getting Started showed you one quick call. These guides are the middle — each is a self-contained walkthrough you can follow end-to-end, using the actual APIs that ship today.

Your first tool-using agent

available

Define a tool, wire it into an agent, and run it. Watch dispatch and result events land on the scroll, and see how the weave CLI inspects what you built.

Intent-driven pipelines

available

The three-layer pattern — signals, domain, projections — that makes pipelines correctable. Reconcilers, projectors, and the producer/consumer split that enforces it.

Reading scrolls with folds

available

How to derive typed state from a scroll's event stream. Three canonical shapes (counter, state map, index) and the rule for when to fold versus query a projection.

Nano decomposition

available

One agent, one output, one event. The fan-out pattern that replaces a twelve-field mega-prompt with twelve parallel nanos — cacheable, retriable, debuggable per axis.

Structured output

coming soon

Constrain the model to a JSON schema, hydrate it into a typed struct, and react to the output in code.

Multi-agent composition

coming soon

Chain agents together. Use one agent's output as another's input, and watch both runs compose on shared scrolls.

Replay-driven tests

coming soon

Record a run, edit the captured externals, and rerun to simulate counterfactuals. Tests become golden files instead of mocks.