help

Guide Convex development through a five-step reflection-first problem-solving workflow.

9|3|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/get-convex/components-submissions-directory --skill help-get-convex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: help
Source: https://github.com/get-convex/components-submissions-directory/tree/main/.claude/skills/help
Command: npx skills add https://github.com/get-convex/components-submissions-directory --skill help-get-convex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reflection-first problem-solving methodology that helps Convex developers diagnose root causes before coding, reducing wasted effort and boosting code quality.

Core Features & Use Cases

  • Reflective decision framework: five-step approach (Reflect, Identify, Theorize, Distill, Proceed) to guide debugging and design.
  • Enforces scope discipline and changelog awareness to minimize risk.
  • Comprehensive guidelines for Convex development, including mutations, authentication, and documentation practices.

Quick Start

Describe the current issue in your Convex project and run the five-step reflection process before implementing a solution.

Frequently Asked Questions about help

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is reflection-first problem solving in Convex development?▼

A structured debugging workflow for Convex uses a five-step reflection process to enforce root-cause analysis, scope discipline, and changelog awareness before implementing any code changes.

How do I debug a Convex mutation using a structured workflow?▼

To debug a Convex mutation, apply the five-step reflection process: reflect on the issue, identify the root cause, theorize a fix, distill scoped changes, and proceed with implementation while enforcing strict change-scope rules.

What's the best way to plan feature implementation across Convex apps?▼

The best way to plan feature implementation across Convex apps is using a reflection-first approach that enforces root-cause analysis, scoped changes, and documentation guidance to minimize risk before proceeding.

Does this reflection workflow work with existing Convex authentication and documentation practices?▼

Yes, the reflection workflow integrates with existing Convex authentication and documentation practices by enforcing comprehensive guidelines, scoped changes, and strict adherence to change-scope rules during development.

Why should I identify root causes before coding in Convex?▼

Identifying root causes before coding in Convex reduces wasted effort and boosts code quality by enforcing scope discipline, changelog awareness, and strict adherence to the 98% confidence and change-scope rules.

When should I not use a reflection-first debugging approach for Convex?▼

You should avoid reflection-first debugging for Convex when addressing trivial syntax fixes or immediate production outages where rapid patching takes priority over structured root-cause analysis and scope discipline.