Sonaloop documentation¶
Sonaloop is an MCP server for customer-persona simulation, councils, and design-research synthesis.
It models customer profiles as persistent agents — durable SOUL.md files, timestamped
calendars, activity logs, inner thoughts, evidence, and council-style debates. The host
agent authors all text; Sonaloop gathers context, validates, and persists. There are no
server-side text-LLM calls, and simulation is non-directional: profiles are never nudged
toward a product thesis unless their own evidence supports it.
This site is the canonical documentation for the Sonaloop product family. It is published
from the sonaloop-docs repository so that
people and agents can read it at a stable URL — no install, no localhost required. A
machine-friendly index lives at /llms.txt.
Start here¶
- Getting started — the one-sentence install and your first project.
- Example projects — two complete demo studies, loadable in one click.
- Job → Framework → Format — the three-layer taxonomy the whole product aligns on, including the A/B test, pricing and ideation run protocols.
- Frameworks — the methodologies a run can follow.
Concepts & method¶
- Grounding — evidence grounding and provenance.
- Calibration — prediction calibration and Brier scoring.
- Opt-in aggregation — the sentiment/coverage aggregation model.
The inspector¶
- The live inspector — the event stream, the activity feed, and the runs panel.
- Web editing — what the browser can and deliberately cannot edit.
- Keyboard, palette & tour — shortcuts, the ⌘K palette, and the opt-in tour.
- Feedback — the built-in feedback channel and its webhook.
Operating Sonaloop¶
- Embeddings — semantic memory recall setup.
- Persona catalog & pagination — catalog search/recommend/pull and the list-pagination convention.
- Lifecycle hooks — events and subscriptions (the seam cloud automation builds on).
- Substrate — the queryable backend substrate for extensions.
- Project assets — attaching asset evidence.
Live actuation & safety¶
- Flow walkthrough — live walkthrough mechanics.
- Live walkthrough safety — safety constraints for live actuation.
- Selective live actuation — live prototype testing.
Where things live¶
| Repo | What it is |
|---|---|
| sonaloop | The open core — MCP server, CLI, web inspector |
| sonaloop-docs | This documentation (canonical source) |
| sonaloop-data | The persona database — a CRON-refreshed catalog |
| sonaloop-design | Brand, design tokens and icons |