[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M73CGWR9BSWBQNJ7FE606MNJ":3,"skill-same:01M73CGWR9BSWBQNJ7FE606MNJ":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},"01M73CGWR9BSWBQNJ7FE606MNJ","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\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","skills\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\u002Fskills\u002Fzod-contract-gate\u002FSKILL.md",[],[60,68,73,78,83,88],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":67},"01M7BBJDYHJMGTJYSC37JVWY8S","i18n-layout","Text layout and encoding guidance: character encoding (UTF-8, legacy Korean code pages, BOM hazards), line endings, RTL\u002Fbidi handling, and script-specific font selection (Hangul focus). Use when: encoding is corrupted or mojibake appears, an RTL locale must render correctly, fonts must be chosen for a script, or CRLF\u002FBOM issues surface.","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":69,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":67},"01M7BBJ9XHAAS1AVGKZZ841VBZ","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.hermes\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":74,"name":62,"nameZh":6,"description":63,"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":67},"01M7BBJ5C3X8TKFKG5R9P9P49W","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.gemini\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":79,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":67},"01M7BBJ1B52X0QMJ2QVBMPJB37","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.codex\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":84,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":67},"01M7BBHX91BW2Q2R276MRX5AW3","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.claude\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":89,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":67},"01M7BBHQWGXPSFRWN1PRC2NMMV","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.agents\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[]]