# Convex Schema Builder

> Design and evolve Convex schemas with proper indexes, relationships, and repo-specific constraints. Use when editing convex/schema.ts or adding tables.

- Skill: `majiayu000/convex-schema-builder` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/convex-schema-builder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/convex-schema-builder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/convex-schema-builder

---


# Convex Schema Builder

Use this skill for `convex/schema.ts` work.

## Core rules

- Prefer flat, relational documents over deep nesting.
- Index foreign keys and common filter paths early.
- Use arrays only for small, naturally bounded sets.
- Keep schema changes compatible with current data unless the task explicitly includes a migration.

## AgentForge-specific guidance

- Schema should support the data layer only. Do not model Mastra runtime execution inside Convex unless the repo already does so intentionally.
- If a schema change is for daemon memory or runtime coordination, cross-check [docs/TECH-REFERENCE.md](/Users/eduardojaviergarcialopez/AgenticEngineering/agentforge/docs/TECH-REFERENCE.md) before changing table shapes.

## References

- Read [schema-checklist.md](/Users/eduardojaviergarcialopez/AgenticEngineering/agentforge/.agents/skills/convex-schema-builder/references/schema-checklist.md) for indexing, pagination, and anti-patterns.