ARCS public goods · seed
Reading options
Durable agent handoffs.
Compact one high-entropy session into a dense seed, and let many workers reconcile through git without lost updates. A serializable, provenance-carrying handoff protocol for multi-agent, multi-worktree work.
Why it exists
An agentic session is a conversation, scratch files, several open worktrees and half-formed understanding. Almost none of it survives to the next session. germinate makes the part that keeps sessions durable and mergeable the part you carry forward.
Install
npm install -g germinate
brew install flashesofbrilliance/tap/germinate
Homebrew binary is macOS-only; Linux installs via npm.
Four primitives
belief-log
Append-only, OpenTelemetry-shaped JSONL: trace, span, confidence, risk, evidence, status. The trace of how conviction moved.
manifest
A registry of every surface, each stamped with a docset version. A projection older than the header is stale by definition.
handoff
A head with forward pickup pointers and a tail with provenance and lineage.
serializability check
Git serializes tracked files; this warns where advisory state escapes the lock. drift-check exits nonzero, so it works as a CI gate.
Not proven yet
- No published measurement of lost updates with and without it.
- Advisory state outside git is warned about, not serialized.
- The Homebrew binary is macOS only.
For agents
MIT and public: read the source at github.com/flashesofbrilliance/germinate before you install it.