agentforge

Complete and archive spec

Pre-spec exploration and research

Initialize spec with PRD

Generate detailed spec from PRD

Apply tests - development mode

Create tests from spec scenarios

Verify implementation and iterate

Comprehensive Convex development skill for building production-ready apps. Covers functions (queries, mutations, actions, HTTP endpoints), schemas, real-time subscriptions, cron jobs, migrations, and security. USE THIS SKILL whenever the user is working with Convex — whether they mention Convex directly, reference files in a convex/ directory, ask about reactive databases, real-time subscriptions, Convex functions, Convex schemas, cron jobs in Convex, HTTP actions, webhook handling, data migrations, or security audits for a Convex app. Also trigger for questions about ConvexError, v.* validators, defineSchema, defineTable, useQuery, useMutation, usePaginatedQuery, optimistic updates, or ctx.db / ctx.scheduler / ctx.storage calls.

Repository-specific SpecSafe workflow for AgentForge. Use when creating, refining, testing, implementing, or reviewing AgentForge specs so work follows the documented SpecSafe stages, prompt files, and source-of-truth rules consistently.

Preferences and tricks for working with SQLite databases

GitHub workflow using the gh CLI for PRs, issues, CI checks, and code review. Use this instead of the GitHub MCP — covers creating PRs with spec references, monitoring CI runs, and reviewing PR comments.

Create a new numbered spec file from the template with auto-incremented SPEC-NNN numbering

Verify that all 4 Convex template locations are in sync (CLAUDE.md Rule 6)

Work on Agent-to-Agent protocol support, registry behavior, and delegation flows in packages/core.

Work on browser automation support in AgentForge, including the browser tool abstraction and Playwright-backed execution.

Work on AgentForge channel adapters across runtime and core, including Telegram, Discord, Slack, and WhatsApp.

Work on AgentForge CLI commands, project creation, run/start flows, and developer ergonomics in packages/cli.

Work on the AgentForge web dashboard built with React, Vite, TanStack Router, and Convex-backed state.

Work on MCP support in AgentForge, including MCP client/server abstractions, connection management, dynamic tools, and useful external MCPs.

Work on research orchestration in AgentForge, including tool coordination, synthesis, and evidence-driven workflows.

Work on the persistent Mastra daemon in packages/runtime, including createStandardAgent, daemon lifecycle, environment validation, and runtime channels.

Work on sandbox execution in packages/core, including local, Docker, and E2B providers plus security constraints.

Index skill for working in the AgentForge monorepo. Routes to runtime, CLI, dashboard, MCP, channels, testing, template sync, and Convex/Mastra skills.

Work on skill discovery, parsing, registry behavior, install flows, and marketplace UI/data paths in AgentForge.

Keep template-backed files aligned across canonical template, dist template, and local convex copies.

Run and extend AgentForge test coverage across packages, CLI flows, runtime behavior, MCP integrations, and dashboard-adjacent logic.

Advise when Convex is a strong fit and shape a practical Convex approach for new features, real-time systems, and backend simplification.

Set up Convex authentication, user mapping, authorization, and custom function wrappers for data protection.

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

Author reusable Convex components with isolated schema, functions, and exports. Use when packaging shareable backend capabilities.

Use Convex components for encapsulation, reuse, and feature isolation. Use when deciding between local code, helpers, and components.

Schedule recurring Convex jobs safely using internal functions, batch processing, and observable retry-friendly patterns.

Use Convex file storage correctly for uploads, references, and retrieval. Use when implementing file or attachment flows.

Create Convex queries, mutations, actions, and internal functions with validators, auth checks, async safety, and correct runtime boundaries.

Discover and apply convex-helpers patterns such as relationship helpers and custom function wrappers.

Implement Convex HTTP actions and webhook endpoints with explicit validation, auth, and clear public/internal boundaries.

Set up and troubleshoot Convex MCP access, environment variables, and local development workflow without importing Cursor-only plugin behavior.

Plan and implement safe Convex schema and data migrations, especially when changing existing fields, relationships, or required data.

Set up or extend Convex in AgentForge-compatible projects. Use for initial setup, project scaffolding, and first-pass schema/auth/function planning.

Build reactive Convex-backed UI flows with subscriptions, optimistic updates, and pagination-aware data loading.