designing-zod-schemas

SKILL.md

Guide the design and implementation of Zod schemas following the project's Zod-first development approach, where schemas are defined before implementing business logic.

| Basic validation | Primitives | z.string().min(1) | | Domain safety | Branded types | transform((v) => v as EntitySlug) | | Multiple types | Discriminated union | z.discriminatedUnion('type', [...]) | | Cross-field rules | Refinement | .refine((data) => ...) | | Data normalization | Transform | .transform((v) => v.trim()) |

| Schema defined | No TS errors | npx tsc --noEmit | | Types inferred | z.infer works | Check type in IDE | | Validation works | safeParse tests | pnpm test |

Designs Zod schemas following Zod-first development. Creates validation schemas, branded types, discriminated unions, and transforms. Infers TypeScript types from schemas. Triggers on: Zod schema, z.object, z.infer, validation, branded types, discriminated union, safeParse, refinement. Source: saleor/configurator.

View raw