convex

Convex

まずここから始めて、以下の該当するスキルを選んで読み込んでください。該当するものがない場合も、末尾のルールは適用されます。

スキルを選ぶ

スキル	次の場合に読み込む
convex-best-practices	一般的なパターン、プロジェクト構成、「Convex のやり方に合っているか」
convex-functions	クエリ、ミューテーション、アクション、内部関数、エラー処理
convex-schema-validator	テーブル、インデックス、バリデーター、v.* 型、スキーマの変更
convex-realtime	useQuery、楽観的更新、ページネーション、プレゼンス、再レンダリングの頻発
convex-http-actions	Webhook、REST エンドポイント、convex/http.ts、Stripe または Clerk のコールバック
convex-file-storage	アップロード、アップロード URL、ファイルの配信、ストレージのクリーンアップ
convex-cron-jobs	crons.ts、runAfter、runAt、バッチ処理、実行されない cron
convex-migrations	バックフィル、フィールド名の変更、稼働中のデータを含むスキーマの進化
convex-agents	AI エージェント、スレッド、ツール、ストリーミング、@convex-dev/agent を使った RAG
convex-component-authoring	再利用可能なコンポーネントパッケージの構築、defineComponent
convex-security-check	リリース前の簡易監査：公開関数の認証、公開データ
convex-security-audit	詳細なレビュー：認可モデル、インジェクション、レート制限、シークレット
avoid-feature-creep	スコープの拡大への対応、MVP の絞り込み、「機能をあと一つだけ」
project-workflow	複数ステップのタスク、prds/ 内の PRD、task.md、レビュー用の計画
project-docs	task.md、changelog.md、files.md とリリース済みコードの同期
git-safety	revert、undo、reset、checkout、clean、stash、force push
多くの場合、スキルは同時に2つ適用されます。コードにはドメインスキル、ワークフローにはプロセススキルを読み込みます。たとえば、convex-functions と project-workflow の組み合わせです。

すべての場面で適用されるルール

• 内部関数も含め、すべての関数で args と returns のバリデーターを宣言します。
• withIndex を使って読み取ります。テーブルスキャンに対する .filter() は、データが増えると問題になるバグです。
• ミューテーションは冪等にします。現在の状態を確認し、処理することがなければ早期に戻ります。
• スケジュールと cron では internal.* 関数のみを実行します。api.* は決して使いません。
• クエリ内で Date.now() を呼び出してはいけません。時間は引数として渡します。
• 開発には npx convex dev を使います。指示がない限り、npx convex deploy は実行しません。
• API に関する記憶を鵜呑みにする前に、https://docs.convex.dev/llms.txt を取得します。

禁止事項

• convex/_generated/ 配下のファイルは編集しません。
• crons.daily、crons.hourly、crons.weekly は使いません。crons.interval または crons.cron を使います。
• クエリまたはミューテーションをエクスポートするファイルに "use node" を記述しません。
• git-safety を先に読み込まずに、作業内容を破棄する git コマンドを実行してはいけません。

ドキュメント

• https://docs.convex.dev/llms.txt
• https://docs.convex.dev/understanding/best-practices
• https://docs.convex.dev/functions