ChatMaestro — Behavior Scenarios

How the app actually works, one use-case at a time — sitting on top of the data model (schema.dbml + ERDs) and the mockup screens.

Each scenario has: a Given/When/Then spine · a table of variations and exceptions (If → Then) · an acceptance test · a screen-by-screen journey · a state machine for lifecycle-heavy parts · a behind-the-scenes sequence · and a plain-English narrative. Every scenario names the screens it uses and the tables it touches.

Experiment lifecycle · Experimenter

Run a nudge-comparison series ready

Vary only the nudge across runs; compare scorecards.

Compose an experiment ready

Set up the reusable study frame.

Author a model configuration ready

Build a reusable model set-up (+ routing and the self-improvement loop).

Build a Cohort ready

Assemble a reusable group of enrollees; the disjoint rule.

Launch a Run ready

Pick group/model/nudge; overlap gate; go live.

Monitor a Live Run ready

Watch runs + zoom into one enrollee.

Analyze the Results ready

Per-factor + composite, cross-run, NL→SQL, export.

Ask a Question in Plain Language ready

NL→SQL Ask engine; narrative + tables/charts; save & approve.

Clear a Run ready

Cleanup vs purge (admin-only), export-first.

Enrollee

OAuth / email one-time-code.

Run a Chat Session ready

Follow the nudge; blinded vs See-all.

Message the Experimenter ready

Out-of-band operator↔enrollee channel.

Leave the Study Pool ready

The participant's own withdrawal; pool-wide, reversible, nothing deleted.

Admin / system

Users & Roles ready

Invite, grant, deactivate, owner-lock.

Curate the Model Catalog ready

Add/retire; aptitudes, expertise, benchmarks.

Ingest a Document ready

Upload/URL → extract (OCR) → embed.

Inspect Embeddings ready

Registered sources + coverage.

Review the Audit Trail ready

Read, annotate the note, correct with new rows.

Report and Triage an Issue ready

Bug or feedback → one table → triage; nothing deleted.

Govern a Saved Question ready

Approve an experimenter's draft into a shared one-click button — or take one back: unapprove, retire (undoably), restore, or delete.