Convex Anti Patterns

What it does

This skill helps AI agents identify and avoid common architectural mistakes when building applications with Convex, a backend-as-a-service platform. It provides guidance on preventing issues like over-fetching data, inefficient queries, and improper state management to ensure scalable and performant systems.

When to use it

• You are designing a new database schema and want to ensure query patterns align with Convex's real-time capabilities.
• Your application is experiencing latency or high costs due to complex nested data retrieval operations.
• You need to refactor existing code that violates best practices regarding server functions and hooks.
• You are reviewing a pull request to catch potential performance bottlenecks before deployment.

Key capabilities

• Detects anti-patterns specific to Convex's unique query language and real-time subscriptions.
• Offers recommendations for optimizing data fetching strategies in serverless environments.
• Highlights common pitfalls in managing shared state and side effects within Convex functions.

Example prompts

• "Review this Convex schema and identify any queries that might cause performance issues at scale."
• "Explain the anti-patterns I should avoid when setting up real-time subscriptions for user data."
• "Suggest optimizations for a server function that currently fetches too much nested data."

Tips & gotchas

Ensure you have a working Convex project setup to effectively apply these architectural patterns. While this skill focuses on avoiding mistakes, it does not automatically generate code; use its insights to manually refactor your logic.