Communitygithub.com

waynesutton/convex-best-practices

本番環境対応のConvexアプリを構築するためのガイドライン。関数の構成、クエリパターン、バリデーション、TypeScriptの使用法、エラーハンドリング、Convex設計哲学「Zen of Convex」を網羅。

convex-best-practices とは?

このスキルは、Convexを使用した本番環境対応アプリケーションの開発に関する包括的なベストプラクティスガイドです。関数の構成、クエリパターン、バリデーション、TypeScriptの活用、エラーハンドリング、そしてConvexの設計哲学である「Zen of Convex」をカバーしています。開発者にとって、スケーラブルでメンテナンスしやすいConvexアプリを構築するための実践的なアドバイスを提供します。主にClaude CodeやCodexなどのAIエージェント向けに設計されており、プロジェクトの初期設計から実装、運用までをサポートします。ガイドはマークダウン形式で整理されているため、AIエージェントが簡単に解析し、開発プロセス内で参照できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/waynesutton/convexskills/tree/main/skills/convex-best-practices

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

convex-best-practices は何をしますか?

本番環境対応のConvexアプリを構築するためのガイドライン。関数の構成、クエリパターン、バリデーション、TypeScriptの使用法、エラーハンドリング、Convex設計哲学「Zen of Convex」を網羅。

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

waynesutton/avoid-feature-creep

Prevent feature creep when building software, apps, and AI-powered products. Use this skill when planning features, reviewing scope, building MVPs, managing backlogs, or when a user says "just one more feature." Helps developers and AI agents stay focused, ship faster, and avoid bloated products.

waynesutton/convex

Umbrella skill for all Convex development patterns. Routes to specific skills like convex-functions, convex-realtime, convex-agents, etc.

waynesutton/convex-agents

Building AI agents with the Convex Agent component including thread management, tool integration, streaming responses, RAG patterns, and workflow orchestration

waynesutton/convex-component-authoring

How to create, structure, and publish self-contained Convex components with proper isolation, exports, and dependency management

waynesutton/convex-cron-jobs

Scheduled function patterns for background tasks including interval scheduling, cron expressions, job monitoring, retry strategies, and best practices for long-running tasks

waynesutton/convex-file-storage

Complete file handling including upload flows, serving files via URL, storing generated files from actions, deletion, and accessing file metadata from system tables

waynesutton/convex-functions

Writing queries, mutations, actions, and HTTP actions with proper argument validation, error handling, internal functions, and runtime considerations

waynesutton/convex-http-actions

External API integration and webhook handling including HTTP endpoint routing, request/response handling, authentication, CORS configuration, and webhook signature validation

waynesutton/convex-migrations

Schema migration strategies for evolving applications including adding new fields, backfilling data, removing deprecated fields, index migrations, and zero-downtime migration patterns

waynesutton/convex-realtime

Patterns for building reactive apps including subscription management, optimistic updates, cache behavior, and paginated queries with cursor-based loading

waynesutton/convex-schema-validator

Defining and validating database schemas with proper typing, index configuration, optional fields, unions, and migration strategies for schema changes

waynesutton/convex-security-audit

Deep security review patterns for authorization logic, data access boundaries, action isolation, rate limiting, and protecting sensitive operations

waynesutton/convex-security-check

Quick security audit checklist covering authentication, function exposure, argument validation, row-level access control, and environment variable handling

関連スキル