convex

---

name: convex description: Convex backend development patterns, validators, indexes, actions, queries, mutations, file storage, scheduling, React hooks, and components. Use when writing Convex code, debugging Convex issues, or planning Convex architecture.

<quick_reference> Key rules (full details in references/guide.md):

Functions: Import from ./_generated/server, use query({ args, handler }) syntax Indexes: Never use .filter() - use .withIndex(). Never define by_creation_time index Actions: Add "use node"; at top, never use ctx.db - use ctx.runQuery/ctx.runMutation Scheduler: Auth does NOT propagate - use internal functions React: Never call hooks conditionally - use "skip" pattern </quick_reference>

<required_reading> Always load: references/guide.md </required_reading>