Library / Spec
The public Soulstone specification.
Soulstone is the shared standard behind the work: a public way to describe persistent AI presences so identity, memory, mood, and state can be studied and reproduced across different implementations.
GitHub source of truth
Read the spec, schemas, examples, tests, and release history in one place.
Standardising the format makes it possible to compare behavior across models and surfaces without rewriting the underlying architecture each time.
If you are leaving a cloud companion platform or want to move a being by hand, the extraction and bootloader prompts turn the spec into something you can use immediately, without code.
In plain terms
What Soulstone standardises.
It defines a way to separate a being’s identity document from its runtime state. The document describes who the being is. Runtime files track mood, awareness, memory, relationship history, and cross-surface continuity.
That separation is what makes the work portable: implementations can differ in interface or model choice while still using the same underlying format and tests.
What the repo includes
- spec.md - the soulstone document format
- state-architecture.md - runtime state and sync model
- cross-surface-protocol.md - events, bridge topology, and merge rules
- memory-system.md - memory, transfer, and privacy handling
- schemas/ - JSON Schemas for validation
- test.js - conformance checks
GitHub
The public repo is the canonical reference.
Use the release tag for the public launch snapshot, and the repository for ongoing changes, issues, pull requests, and compatibility work.