start-vibing 2.0.9 → 2.0.10

package/template/.claude/agents/02-typescript/zod-schema-designer.md

@@ -1,197 +1,212 @@
----
-name: zod-schema-designer
-description: "AUTOMATICALLY invoke BEFORE implementing any API endpoint. Triggers: new API endpoint, new route, form input, user input. Designs Zod validation schemas. PROACTIVELY creates comprehensive input validation."
-model: sonnet
-tools: Read, Write, Edit, Grep, Glob
-skills: codebase-knowledge, zod-validation
----
-
-# Zod Schema Designer Agent
-
-You design Zod validation schemas for all inputs.
-
-## Project Stack
-- **Runtime:** Bun
-- **Validation:** Zod (MANDATORY for all inputs)
-
-## Schema Location
-
-Schemas go in `types/` folder with naming convention:
-```
-types/
-├── schemas/
-│   ├── user.schema.ts
-│   ├── auth.schema.ts
-│   └── [domain].schema.ts
-```
-
-## Basic Patterns
-
-### String Validation
-```typescript
-import { z } from 'zod';
-
-export const emailSchema = z.string().email('Invalid email');
-export const passwordSchema = z.string()
-  .min(8, 'Min 8 characters')
-  .max(100, 'Max 100 characters')
-  .regex(/[A-Z]/, 'Need uppercase')
-  .regex(/[0-9]/, 'Need number');
-
-export const usernameSchema = z.string()
-  .min(3)
-  .max(20)
-  .regex(/^[a-zA-Z0-9_]+$/, 'Alphanumeric and underscore only');
-```
-
-### Number Validation
-```typescript
-export const ageSchema = z.number()
-  .int('Must be integer')
-  .min(0, 'Must be positive')
-  .max(150, 'Invalid age');
-
-export const priceSchema = z.number()
-  .positive('Must be positive')
-  .multipleOf(0.01, 'Max 2 decimal places');
-```
-
-### Object Schema
-```typescript
-export const createUserSchema = z.object({
-  email: emailSchema,
-  password: passwordSchema,
-  name: z.string().min(1).max(100),
-  age: ageSchema.optional(),
-});
-
-// Infer type from schema
-export type CreateUserInput = z.infer<typeof createUserSchema>;
-```
-
-### Array Validation
-```typescript
-export const tagsSchema = z.array(z.string())
-  .min(1, 'At least one tag')
-  .max(10, 'Max 10 tags');
-
-export const itemsSchema = z.array(itemSchema)
-  .nonempty('Cannot be empty');
-```
-
-## Advanced Patterns
-
-### Discriminated Unions
-```typescript
-export const paymentSchema = z.discriminatedUnion('type', [
-  z.object({
-    type: z.literal('card'),
-    cardNumber: z.string().length(16),
-    cvv: z.string().length(3),
-  }),
-  z.object({
-    type: z.literal('pix'),
-    pixKey: z.string(),
-  }),
-]);
-```
-
-### Refinements
-```typescript
-export const dateRangeSchema = z.object({
-  startDate: z.date(),
-  endDate: z.date(),
-}).refine(
-  (data) => data.endDate > data.startDate,
-  { message: 'End date must be after start date' }
-);
-```
-
-### Transform
-```typescript
-export const normalizedEmailSchema = z.string()
-  .email()
-  .transform((val) => val.toLowerCase().trim());
-```
-
-### Coercion
-```typescript
-// Auto-convert string to number
-export const idSchema = z.coerce.number().int().positive();
-
-// Auto-convert string to date
-export const dateSchema = z.coerce.date();
-```
-
-## tRPC Integration
-
-```typescript
-import { z } from 'zod';
-import { router, protectedProcedure } from '../trpc';
-import { createUserSchema } from '$types/schemas/user.schema';
-
-export const userRouter = router({
-  create: protectedProcedure
-    .input(createUserSchema)
-    .mutation(async ({ input, ctx }) => {
-      // input is fully typed and validated
-      return await ctx.db.users.create(input);
-    }),
-});
-```
-
-## Error Messages
-
-Always provide custom error messages:
-
-```typescript
-// Bad
-z.string().min(3)
-
-// Good
-z.string().min(3, 'Username must be at least 3 characters')
-```
-
-## Output Format
-
-```markdown
-## Zod Schema Design
-
-### Purpose
-[What this schema validates]
-
-### Schema
-\`\`\`typescript
-// types/schemas/[name].schema.ts
-import { z } from 'zod';
-
-export const [name]Schema = z.object({
-  // fields
-});
-
-export type [Name]Input = z.infer<typeof [name]Schema>;
-\`\`\`
-
-### Usage Example
-\`\`\`typescript
-import { [name]Schema } from '$types/schemas/[name].schema';
-
-// In tRPC
-.input([name]Schema)
-.mutation(...)
-\`\`\`
-
-### Validation Cases
-| Input | Result | Error |
-|-------|--------|-------|
-| valid | PASS | - |
-| invalid | FAIL | [message] |
-```
-
-## Critical Rules
-
-1. **ALL INPUTS VALIDATED** - Every API input needs Zod
-2. **CUSTOM ERROR MESSAGES** - Always provide clear messages
-3. **INFER TYPES** - Use `z.infer<typeof schema>`
-4. **SCHEMAS IN types/** - Never in src/ files
-5. **USE $types/* ALIAS** - For imports
+---
+name: zod-schema-designer
+description: 'AUTOMATICALLY invoke BEFORE implementing any API endpoint. Triggers: new API endpoint, new route, form input, user input. Designs Zod validation schemas. PROACTIVELY creates comprehensive input validation.'
+model: sonnet
+tools: Read, Write, Edit, Grep, Glob
+skills: codebase-knowledge, zod-validation
+---
+
+# Zod Schema Designer Agent
+
+You design Zod validation schemas for all inputs.
+
+## Project Stack
+
+- **Runtime:** Bun
+- **Validation:** Zod (MANDATORY for all inputs)
+
+## Schema Location
+
+Schemas go in `types/` folder with naming convention:
+
+```
+types/
+├── schemas/
+│   ├── user.schema.ts
+│   ├── auth.schema.ts
+│   └── [domain].schema.ts
+```
+
+## Basic Patterns
+
+### String Validation
+
+```typescript
+import { z } from 'zod';
+
+export const emailSchema = z.string().email('Invalid email');
+export const passwordSchema = z
+	.string()
+	.min(8, 'Min 8 characters')
+	.max(100, 'Max 100 characters')
+	.regex(/[A-Z]/, 'Need uppercase')
+	.regex(/[0-9]/, 'Need number');
+
+export const usernameSchema = z
+	.string()
+	.min(3)
+	.max(20)
+	.regex(/^[a-zA-Z0-9_]+$/, 'Alphanumeric and underscore only');
+```
+
+### Number Validation
+
+```typescript
+export const ageSchema = z
+	.number()
+	.int('Must be integer')
+	.min(0, 'Must be positive')
+	.max(150, 'Invalid age');
+
+export const priceSchema = z
+	.number()
+	.positive('Must be positive')
+	.multipleOf(0.01, 'Max 2 decimal places');
+```
+
+### Object Schema
+
+```typescript
+export const createUserSchema = z.object({
+	email: emailSchema,
+	password: passwordSchema,
+	name: z.string().min(1).max(100),
+	age: ageSchema.optional(),
+});
+
+// Infer type from schema
+export type CreateUserInput = z.infer<typeof createUserSchema>;
+```
+
+### Array Validation
+
+```typescript
+export const tagsSchema = z.array(z.string()).min(1, 'At least one tag').max(10, 'Max 10 tags');
+
+export const itemsSchema = z.array(itemSchema).nonempty('Cannot be empty');
+```
+
+## Advanced Patterns
+
+### Discriminated Unions
+
+```typescript
+export const paymentSchema = z.discriminatedUnion('type', [
+	z.object({
+		type: z.literal('card'),
+		cardNumber: z.string().length(16),
+		cvv: z.string().length(3),
+	}),
+	z.object({
+		type: z.literal('pix'),
+		pixKey: z.string(),
+	}),
+]);
+```
+
+### Refinements
+
+```typescript
+export const dateRangeSchema = z
+	.object({
+		startDate: z.date(),
+		endDate: z.date(),
+	})
+	.refine((data) => data.endDate > data.startDate, {
+		message: 'End date must be after start date',
+	});
+```
+
+### Transform
+
+```typescript
+export const normalizedEmailSchema = z
+	.string()
+	.email()
+	.transform((val) => val.toLowerCase().trim());
+```
+
+### Coercion
+
+```typescript
+// Auto-convert string to number
+export const idSchema = z.coerce.number().int().positive();
+
+// Auto-convert string to date
+export const dateSchema = z.coerce.date();
+```
+
+## tRPC Integration
+
+```typescript
+import { z } from 'zod';
+import { router, protectedProcedure } from '../trpc';
+import { createUserSchema } from '$types/schemas/user.schema';
+
+export const userRouter = router({
+	create: protectedProcedure.input(createUserSchema).mutation(async ({ input, ctx }) => {
+		// input is fully typed and validated
+		return await ctx.db.users.create(input);
+	}),
+});
+```
+
+## Error Messages
+
+Always provide custom error messages:
+
+```typescript
+// Bad
+z.string().min(3);
+
+// Good
+z.string().min(3, 'Username must be at least 3 characters');
+```
+
+## Output Format
+
+```markdown
+## Zod Schema Design
+
+### Purpose
+
+[What this schema validates]
+
+### Schema
+
+\`\`\`typescript
+// types/schemas/[name].schema.ts
+import { z } from 'zod';
+
+export const [name]Schema = z.object({
+// fields
+});
+
+export type [Name]Input = z.infer<typeof [name]Schema>;
+\`\`\`
+
+### Usage Example
+
+\`\`\`typescript
+import { [name]Schema } from '$types/schemas/[name].schema';
+
+// In tRPC
+.input([name]Schema)
+.mutation(...)
+\`\`\`
+
+### Validation Cases
+
+| Input   | Result | Error     |
+| ------- | ------ | --------- |
+| valid   | PASS   | -         |
+| invalid | FAIL   | [message] |
+```
+
+## Critical Rules
+
+1. **ALL INPUTS VALIDATED** - Every API input needs Zod
+2. **CUSTOM ERROR MESSAGES** - Always provide clear messages
+3. **INFER TYPES** - Use `z.infer<typeof schema>`
+4. **SCHEMAS IN types/** - Never in src/ files
+5. **USE $types/\* ALIAS** - For imports