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.

<objective> Provide comprehensive Convex development guidance to avoid common mistakes and ensure code compiles on first try. </objective>

<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>

<process> 1. Read `references/guide.md` for comprehensive Convex patterns 2. Apply patterns to the specific task 3. Verify against the checklist in section 18 of the guide </process>

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