Introduction
corespine is the thin shared core of the Spine family — a small set of domain-neutral primitives, six seams plus a unified error shape, depended on by ragspine and spineagent but never the reverse.
corespine is the thin shared core of the Spine family: a small set of domain-neutral
primitives — the stable bedrock that belongs to neither RAG nor agents. It is depended on by
sibling packages like ragspine and spineagent, but never depends back on any of them, and
carries none of their domain concepts.
It is made of six "seams" plus an errors seam, each holding only the smallest, obviously stable
mechanism. The core imports zero third-party SDKs, zero network, zero runtime dependencies
(dependencies stays empty forever) — install it and it runs offline, deterministically,
end to end.
corespine provides mechanism, not policy: the conformance harness, the seam registry, the privacy-trace shape. The specific invariants are bound by each app, never baked into the core.
Start here
Overview
What corespine is, what it solves, when to use it, and the seam meta-pattern.
API
The real signature and contract of every export, grouped by seam.
Recipes
Runnable, offline, zero-dependency minimal examples with real output.
Gotchas
Real pitfalls, ranked by how often people hit them — wrong vs. right.