[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M73BTHVJSZCV62A58NE4FNEX":3,"skill-same:01M73BTHVJSZCV62A58NE4FNEX":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":38,"commitSha":39,"skillDirectory":40,"forksCount":41,"repositoryHtmlUrl":42,"repositoryHomepageUrl":6,"ownerHtmlUrl":43,"ownerBlogUrl":6,"ownerDescription":44,"updatedAt":45,"install":46,"resources":58},"01M73BTHVJSZCV62A58NE4FNEX","zod-contract-gate",null,"Defines Zod runtime schema validation patterns, interface boundaries, and contract safety rules for multi-agent architecture, IPC channels, and API endpoints.","5throck\u002Fai-workspace-standards","5throck","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F10958964?v=4","01M73BFEH0V0VS483TW4JD49JW","01M73BFEJ5VQZJHJSFTVPAZGDM",25,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fzod-contract-gate\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: zod-contract-gate\ndescription: >\n  Defines Zod runtime schema validation patterns, interface boundaries,\n  and contract safety rules for multi-agent architecture, IPC channels,\n  and API endpoints.\nversion: 1.0.3\nlast_reviewed: 2026-11-12\nstatus: active\nscope: common\nl2_propagate: true\nowner: contract-gate-engineer\nprerequisites: Bun runtime, Zod library (^3.25 || ^4.0)\nmetadata:\n  type: contract-safety\n  triggers:\n    - zod-contract-gate\n    - \u002Fzod-contract-gate\n    - zod contract validation\n    - schema contract gate\n    - runtime schema validation\n---\n\n# Skill: zod-contract-gate\n\n## Context\n\nIn multi-agent architectures and complex TypeScript applications, untyped or loosely typed data boundaries across IPC channels, agent payloads, configuration inputs, and internal APIs can cause silent data corruption or downstream runtime failures.\n\n`zod-contract-gate` provides the standard specification and execution rules for enforcing **runtime contract safety** using Zod schemas at all boundary points.\n\n## Core Contract Safety Principles\n\n1. **Boundary Validation First**: Validate every incoming payload, configuration object, IPC message, and API request at the system boundary before processing.\n2. **Explicit Schema Definitions**: Define Zod schemas alongside TypeScript type definitions (`type T = z.infer\u003Ctypeof TSchema>`).\n3. **No Silent Swallowing**: If validation fails, throw or return structured `ZodError` diagnostics. Never silently substitute partial or corrupted default values.\n4. **Strict Schema Constraints**: Use strict objects (`z.object({...}).strict()`), non-empty strings, bounded arrays, and discriminated unions to enforce contract constraints.\n\n## Contract Safety Boundaries\n\n| Boundary Type | Enforcement Target | Validation Mechanism | Fail Behavior |\n|---------------|--------------------|----------------------|---------------|\n| **Agent IPC Messages** | Inter-agent payloads & task parameters | `AgentPayloadSchema.safeParse()` | Reject message with `[CONTRACT_ERROR]` diagnostic |\n| **API Endpoints** | Request parameters & response DTOs | `z.object({...}).parse()` | Exit with exit code 1 or return 400 Bad Request |\n| **Configuration Files** | `JSON` \u002F `YAML` settings & manifests | `ConfigSchema.parse()` | Halt initialization with field-level schema errors |\n| **CLI Arguments** | Command options & environment variables | `CLIOptionsSchema.safeParse()` | Print usage & exit code 1 |\n\n## Canonical Implementation Patterns\n\n### Pattern 1: Inter-Agent Payload Gate\n\n```typescript\nimport { z } from \"zod\";\n\nexport const AgentTaskPayloadSchema = z.object({\n  taskId: z.string().uuid(),\n  agentRole: z.enum([\"pm\", \"architect\", \"code-writer\", \"designer\", \"security-monitor\", \"stack-setup\", \"test-runner\"]),\n  action: z.string().min(1),\n  parameters: z.record(z.unknown()),\n  contextFiles: z.array(z.string()).default([]),\n}).strict();\n\nexport type AgentTaskPayload = z.infer\u003Ctypeof AgentTaskPayloadSchema>;\n\nexport function validateAgentPayload(input: unknown): AgentTaskPayload {\n  const result = AgentTaskPayloadSchema.safeParse(input);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `${i.path.join(\".\")}: ${i.message}`).join(\"; \");\n    throw new Error(`[CONTRACT_ERROR] Invalid agent task payload: ${issues}`);\n  }\n  return result.data;\n}\n```\n\n### Pattern 2: API Contract Request\u002FResponse Gate\n\n```typescript\nimport { z } from \"zod\";\n\nexport const ServiceTicketRequestSchema = z.object({\n  ticketId: z.string().min(1),\n  serviceName: z.string().min(1),\n  priority: z.enum([\"low\", \"medium\", \"high\", \"critical\"]),\n  payload: z.object({\n    repoUrl: z.string().url(),\n    branch: z.string().default(\"main\"),\n  }),\n});\n\nexport type ServiceTicketRequest = z.infer\u003Ctypeof ServiceTicketRequestSchema>;\n\nexport function processServiceTicket(rawRequest: unknown): ServiceTicketRequest {\n  const parsed = ServiceTicketRequestSchema.parse(rawRequest);\n  return parsed;\n}\n```\n\n### Pattern 3: Discriminated Union for State Transitions\n\n```typescript\nimport { z } from \"zod\";\n\nexport const EventSchema = z.discriminatedUnion(\"type\", [\n  z.object({\n    type: z.literal(\"TASK_STARTED\"),\n    taskId: z.string(),\n    timestamp: z.number(),\n  }),\n  z.object({\n    type: z.literal(\"TASK_COMPLETED\"),\n    taskId: z.string(),\n    resultSummary: z.string(),\n    exitCode: z.number(),\n  }),\n  z.object({\n    type: z.literal(\"TASK_FAILED\"),\n    taskId: z.string(),\n    errorMessage: z.string(),\n  }),\n]);\n\nexport type SystemEvent = z.infer\u003Ctypeof EventSchema>;\n```\n\n## Quality Gate Checklist\n\nBefore completing feature implementation or submitting a pull request, verify:\n\n- [ ] All exported interfaces and API parameters have corresponding Zod runtime schemas.\n- [ ] No `any` or untyped `unknown` data is passed through boundary functions without Zod parsing.\n- [ ] Error messages output precise Zod validation issues without truncating or swallowing stack trace diagnostics.\n- [ ] Unit tests cover both valid payload parsing and expected validation error throwing for invalid schema inputs.\n","# Skill: zod-contract-gate\n\n## Context\n\nIn multi-agent architectures and complex TypeScript applications, untyped or loosely typed data boundaries across IPC channels, agent payloads, configuration inputs, and internal APIs can cause silent data corruption or downstream runtime failures.\n\n`zod-contract-gate` provides the standard specification and execution rules for enforcing **runtime contract safety** using Zod schemas at all boundary points.\n\n## Core Contract Safety Principles\n\n1. **Boundary Validation First**: Validate every incoming payload, configuration object, IPC message, and API request at the system boundary before processing.\n2. **Explicit Schema Definitions**: Define Zod schemas alongside TypeScript type definitions (`type T = z.infer\u003Ctypeof TSchema>`).\n3. **No Silent Swallowing**: If validation fails, throw or return structured `ZodError` diagnostics. Never silently substitute partial or corrupted default values.\n4. **Strict Schema Constraints**: Use strict objects (`z.object({...}).strict()`), non-empty strings, bounded arrays, and discriminated unions to enforce contract constraints.\n\n## Contract Safety Boundaries\n\n| Boundary Type | Enforcement Target | Validation Mechanism | Fail Behavior |\n|---------------|--------------------|----------------------|---------------|\n| **Agent IPC Messages** | Inter-agent payloads & task parameters | `AgentPayloadSchema.safeParse()` | Reject message with `[CONTRACT_ERROR]` diagnostic |\n| **API Endpoints** | Request parameters & response DTOs | `z.object({...}).parse()` | Exit with exit code 1 or return 400 Bad Request |\n| **Configuration Files** | `JSON` \u002F `YAML` settings & manifests | `ConfigSchema.parse()` | Halt initialization with field-level schema errors |\n| **CLI Arguments** | Command options & environment variables | `CLIOptionsSchema.safeParse()` | Print usage & exit code 1 |\n\n## Canonical Implementation Patterns\n\n### Pattern 1: Inter-Agent Payload Gate\n\n```typescript\nimport { z } from \"zod\";\n\nexport const AgentTaskPayloadSchema = z.object({\n  taskId: z.string().uuid(),\n  agentRole: z.enum([\"pm\", \"architect\", \"code-writer\", \"designer\", \"security-monitor\", \"stack-setup\", \"test-runner\"]),\n  action: z.string().min(1),\n  parameters: z.record(z.unknown()),\n  contextFiles: z.array(z.string()).default([]),\n}).strict();\n\nexport type AgentTaskPayload = z.infer\u003Ctypeof AgentTaskPayloadSchema>;\n\nexport function validateAgentPayload(input: unknown): AgentTaskPayload {\n  const result = AgentTaskPayloadSchema.safeParse(input);\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `${i.path.join(\".\")}: ${i.message}`).join(\"; \");\n    throw new Error(`[CONTRACT_ERROR] Invalid agent task payload: ${issues}`);\n  }\n  return result.data;\n}\n```\n\n### Pattern 2: API Contract Request\u002FResponse Gate\n\n```typescript\nimport { z } from \"zod\";\n\nexport const ServiceTicketRequestSchema = z.object({\n  ticketId: z.string().min(1),\n  serviceName: z.string().min(1),\n  priority: z.enum([\"low\", \"medium\", \"high\", \"critical\"]),\n  payload: z.object({\n    repoUrl: z.string().url(),\n    branch: z.string().default(\"main\"),\n  }),\n});\n\nexport type ServiceTicketRequest = z.infer\u003Ctypeof ServiceTicketRequestSchema>;\n\nexport function processServiceTicket(rawRequest: unknown): ServiceTicketRequest {\n  const parsed = ServiceTicketRequestSchema.parse(rawRequest);\n  return parsed;\n}\n```\n\n### Pattern 3: Discriminated Union for State Transitions\n\n```typescript\nimport { z } from \"zod\";\n\nexport const EventSchema = z.discriminatedUnion(\"type\", [\n  z.object({\n    type: z.literal(\"TASK_STARTED\"),\n    taskId: z.string(),\n    timestamp: z.number(),\n  }),\n  z.object({\n    type: z.literal(\"TASK_COMPLETED\"),\n    taskId: z.string(),\n    resultSummary: z.string(),\n    exitCode: z.number(),\n  }),\n  z.object({\n    type: z.literal(\"TASK_FAILED\"),\n    taskId: z.string(),\n    errorMessage: z.string(),\n  }),\n]);\n\nexport type SystemEvent = z.infer\u003Ctypeof EventSchema>;\n```\n\n## Quality Gate Checklist\n\nBefore completing feature implementation or submitting a pull request, verify:\n\n- [ ] All exported interfaces and API parameters have corresponding Zod runtime schemas.\n- [ ] No `any` or untyped `unknown` data is passed through boundary functions without Zod parsing.\n- [ ] Error messages output precise Zod validation issues without truncating or swallowing stack trace diagnostics.\n- [ ] Unit tests cover both valid payload parsing and expected validation error throwing for invalid schema inputs.\n",{"name":5,"owner":23,"scope":24,"status":25,"version":26,"metadata":27,"description":34,"l2_propagate":35,"last_reviewed":36,"prerequisites":37},"contract-gate-engineer","common","active","1.0.3",{"type":28,"triggers":29},"contract-safety",[5,30,31,32,33],"\u002Fzod-contract-gate","zod contract validation","schema contract gate","runtime schema validation","Defines Zod runtime schema validation patterns, interface boundaries, and contract safety rules for multi-agent architecture, IPC channels, and API endpoints.\n",true,1794441600000,"Bun runtime, Zod library (^3.25 || ^4.0)","main","b57e612781a79b0e3e60878294ce59c86cc68e5d",".claude\u002Fskills\u002Fzod-contract-gate",9,"https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards","https:\u002F\u002Fgithub.com\u002F5throck","Experienced in digital transformation, enterprise IT, startup acceleration, and business strategy. Focused on building practical systems that connect technolo","2026-11-14 21:22:34",{"source":8,"skillName":5,"commands":47,"prompt":57,"zipAvailable":35},[48,51,54],{"tool":49,"command":50},"npx","npx skills add 5throck\u002Fai-workspace-standards --skill zod-contract-gate",{"tool":52,"command":53},"bunx","bunx skills add 5throck\u002Fai-workspace-standards --skill zod-contract-gate",{"tool":55,"command":56},"pnpm","pnpm dlx skills add 5throck\u002Fai-workspace-standards --skill zod-contract-gate","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fzod-contract-gate\u002FSKILL.md",[],[60,66,72,78,85,92],{"skillNo":61,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":18},"01M73HG1JK5J3A3AMG6WNH8V6E","discovery","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftests\u002Fprocedures-fixtures\u002Ftemplates\u002Fco-fixt\u002Fskills\u002Fdiscovery\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M73HG0VZMCNH9YJX8ERV6R7C","x","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftests\u002Fprocedures-fixtures\u002Ftemplates\u002Fco-bad\u002Fskills\u002Fx\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M73HFZR1J6DMW5BRXG1ND6ET","root-skill","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftests\u002Fprocedures-fixtures\u002Fskills\u002Froot-skill\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":18},"01M73HFSYWV2FPF895DK295NCV","update-bun-packages","Scans, updates, and upgrades Bun dependencies and packages across the AI workspace (L0) or standalone project (L2\u002FL3) while ensuring lockfile consistency, package.json version bumps, and security compliance. Use when: updating bun dependencies, upgrading packages to @latest, checking outdated packages in workspace or templates.","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fcommon\u002Fskills\u002Fupdate-bun-packages\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":18},"01M73HFPZ7G1AHF80CDEJ94SZ9","ui-ux-design-intelligence","Provides comprehensive UI\u002FUX design capabilities including design system creation, component design, visual hierarchy, and user-centered design principles. Use when: building design systems, creating visual designs, designing UI components, or establishing design specifications.","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fcommon\u002Fskills\u002Fui-ux-design-intelligence\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":18},"01M73HFMBER8AQEX2HF02JE2G4","translate","Translation helper for README and documentation files with diff preview and guidance","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fcommon\u002Fskills\u002Ftranslate\u002FSKILL.md",[],[]]