Guide

The long-form documents of Soma. Start with the language guide — it is what soma docs agent prints, and it fits in one context window.

The guide soma docs agent prints: the whole core language in one page, as an agent reads it before writing Soma.

Write the structure first: memory, machines and each signal's frame; then fill bodies one brief at a time.

What a flesh body may do, and how soma check holds it to its frame.

LLM calls inside a state machine: think(), tools, budgets, [task] handlers and hordes.

[native] handlers compiled to Rust for numeric hot paths, and what they may contain.

The exact guarantees of soma verify and of the runtime, and their limits.

What soma serve exposes, how routes map to handlers and errors to statuses.

Running a Soma service: storage, restarts, failures, and what happens when it goes wrong.

Eventual replication between nodes: setup, guarantees and limits.

Bounded loops, timing and interlocks for control programs.

The block a Soma project puts in its AGENTS.md: the loop to run, what each command proves, and the limits to state.

What changed in recent releases, written for an agent that learned an older Soma.