Help & docs
Persona reference, the seeding playbook, and the troubleshooting we wish we'd written sooner.
Personas reference
Live from your personas table. Behavior summaries are derived from each persona's config.
No personas match.
Seeding playbook
- Catalog before customers
Always push the catalog to Shopify before seeding orders. Order generation references catalog SKUs; missing variants cause 422s on push.
- Mind the confidence floor
Aim for at least 30 customers per active persona. Below that, the seeder warns you in the wizard — patterns get noisy and rePete's analytics won't have enough signal.
- Image coverage matters
Shoot for ≥80% image coverage per catalog before pushing to a demo store. Placeholders are fine for dev work but look thin on stage. Drag-and-drop bulk upload on the catalog tab is the fastest path.
- Drift: off for first seed, on for life
Leave drift off during the initial seed so the persona mix lands where you set it. Turn it on once the store has a few weeks of top-up history — that's where the time-series view starts paying off.
- Snapshot before you nuke
Use Settings → Dataset snapshots to save a named state before any destructive run. Nuke auto-snapshots too, but a labelled manual snapshot is easier to find later.
- Top-up keeps the store breathing
Enable daily top-up after the initial seed so the dashboard never looks frozen between demos. 10–50 orders/day is plenty for a coffee or supplements store.
Scenario presets
Healthy growing store
Default rePete demo. Balanced persona mix, mild churn, ~18 months of history.
When: First-time prospect, generic walk-through, no specific pain point yet.
Subscription fatigue store
Heavy churned + one_and_done. The narrative: this store is bleeding customers — watch the AI reorder agent recover them.
When: Brand that already runs subscriptions and is frustrated by cancellations.
Brand new store
Small dataset, 60-day history. Simulates a fresh merchant just installing rePete.
When: Early-stage merchant or anyone skeptical that rePete needs a year of data to be useful.
Established subscription brand
Mature store, very low churn, heavy metronome and stockup. The narrative: even healthy subs leave repeat revenue on the table.
When: Brand with subscriptions live and a good retention story but flat AOV.
Stress test
Deliberately weird mix — heavy durable_repeat (false-positive trap), convertible, sampler-heavy.
When: Internal QA, edge-case demos, or a technically savvy prospect kicking the tires.
Troubleshooting
Glossary
- AI reorder agent
- How rePete is referred to in customer-facing copy. Always lowercase 'AI reorder agent'.
- Nudge
- The message rePete sends a customer suggesting a reorder. Not 'reminder'.
- Predicted window
- The date range when a customer is most likely to reorder. Not 'schedule' or 'due date'.
- Reorder prediction
- The model's forecast of the next reorder. Not 'subscription' or 'due date'.
- Drift
- A customer transitioning from one persona to another based on observed behavior over time.
- Top-up
- The daily background job that adds a small batch of orders so the store stays alive between demos.
- Snapshot
- A portable JSON capture of the full seeded dataset (customers, orders, persona history, catalog) that can be restored later.
- Catalog version
- A point-in-time backup of a single catalog's products and variants. One-click revert from the Catalog page.
- Negative-test persona
- A persona designed to trip false positives in rePete (e.g. durable_repeat). Keep at ≤3% of any seed.
- Novelty score
- Per-customer 0–1 score of how often they buy something new vs repeat what they've bought before. 0 = pure habit, 1 = pure explorer. The 0.2–0.6 band is typical.
- Re-scan pass
- After a nuke's main delete phase, the worker re-paginates Shopify to catch any tagged records created mid-run. Loops up to 3 rounds until a scan returns zero stragglers.
- Nuke guard
- Top-up and the order-push worker check for an active nuke on each tick and skip themselves until it finishes, preventing concurrent writes from racing the delete pass.
Power-user tips
- Preset deep links
Append ?preset=<scenario-slug> to /seed to pre-fill the wizard. The onboarding flow uses this; you can bookmark your favourite preset.
- Dataset JSON shape
Exported snapshots include meta, catalog, personas_config, customers, orders, persona_history, and audit_log_summary. Same shape on import — major-version mismatches are rejected.
- Open a page's docs in one click
Every per-page info dialogue has an 'Open full docs' link in the footer that jumps straight to the matching section here.
- Novelty slider keyboard shortcuts
On the Customers page novelty slider, arrow keys move the focused thumb by 0.05, Shift+arrow by 0.1, and Home/End jump to the bounds. The filter applies automatically after a brief pause.
- Safe to walk away during a nuke
Nuke now pauses top-up and the push worker for the duration, and runs a re-scan loop at the end to catch anything created mid-run. You can kick it off and let it finish unattended.