majiayu000 Convex Function Creator
Use this when writing or reviewing Convex functions.
Default requirements
- Public functions should define
argsandreturns. - Await all promises.
- Use auth and authorization checks for protected data.
- Use
internal.*for scheduler and backend-only flows. - Keep wrappers thin and move reusable logic into plain TypeScript helpers.
Runtime boundaries
- Queries and mutations stay in the default Convex runtime.
"use node"files may contain only actions and helper logic for actions.- In AgentForge, actions are still not the place for Mastra runtime orchestration.
Query design
- Prefer
.withIndex()over.filter()for primary lookups. - Avoid unbounded
.collect()when pagination is the real requirement. - Never use
Date.now()in queries.
References
- Read function-patterns.md for templates and anti-patterns.