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 — complete demo studies, one-click in the local inspector or loadable via MCP/CLI.
- 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.
- Persona lifecycle & memory — resumable builds, task-context snapshots, reviewed chat continuity, authentic voice and careful deletion.
- Cohort Integrity — independent persona depth, framed-hypothesis leakage, countervoices and server-owned remediation before Reaction Tests.
- Artifact inventory — references vs assets vs flows vs sessions.
- 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.
- Reliable job creation and continuation — retry-safe frontdoor-only creation, explicit unfinished-job recovery, single-active-run ownership, idempotent checkpoints and engine-owned completion.
- Web editing — what the browser can and deliberately cannot edit.
- Keyboard, palette & tour — shortcuts, the ⌘K palette, and the local opt-in tour.
- Feedback — the built-in feedback channel and its webhook.
Operating Sonaloop¶
- Cloud workspaces and customer access — tenant isolation, managed login, invitations and no-charge workspaces.
- Cloud execution audit and PostHog observability — tenant-bound Remote-MCP audit, privacy-safe tool traces and Cloud-hosted model generations.
- Product telemetry — provider-neutral semantic events, privacy boundaries, durable delivery and current product coverage.
- 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 |