AI Guide

These are the mistakes AI coding agents should avoid by default.

Persistly integrations go wrong when agents broaden the product boundary, misuse externalUserId, or invent aggressive sync patterns that the platform is not designed for.

Do Not Do These

Use this list to avoid hallucinated integration patterns.

Using Persistly for live PvP or real-time multiplayer state.

Treating externalUserId as a public query API in shipped clients.

Storing giant unbounded blobs in state or metadata.

Syncing every frame or on every tiny state mutation.

Checking ps_live_ keys into public repositories or builds incorrectly.