Convex Best Practices

General Convex implementation guidance for this repo. Use before or during schema, function, realtime, auth, or migration work.

majiayu000 f12953e 2 files · 1.9 KB Updated 567 repo stars

File contents

Convex Best Practices

Use this skill as the default baseline for Convex work before switching to a narrower Convex skill.

Default guidance

  • Treat functions as the API surface.
  • Keep schema explicit and indexes intentional.
  • Validate public inputs and outputs.
  • Prefer typed helpers over repeated inline logic.
  • Use npx convex dev during development.

AgentForge-specific constraints

  • Convex is the data layer for this repo.
  • Mastra runtime logic belongs in packages/runtime/, not in Convex actions.
  • Avoid patterns that assume a standalone all-in-one Convex agent app.

References

majiayu000/claude-skill-registry-data/tree/main/development/convex-best-practices-agentic-engineering-agentforge commit f12953e007

Frequently asked questions

npx skillmds add majiayu000/convex-best-practices-2