skills.rest
mariotoffia
mariotoffiaCOMMUNITY
Explore all skills by this author โ†’
Website๐•@mariotoffiaGitHub

design-event-schema

Design versioned JSON Schema domain event contracts with serialization tests.

Updated Oct 27, 2025
Search Tags:#versioning#backward-compatibility#json-schema#schema-evolution#domain-events#event-envelopes
One-click install
npx skills add https://github.com/mariotoffia/gobridge --skill design-event-schema
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: design-event-schema
Source: https://github.com/mariotoffia/gobridge/tree/main/.cursor/skills/design-event-schema
Command: npx skills add https://github.com/mariotoffia/gobridge --skill design-event-schema

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill teaches you how to design robust domain event schemas that support evolution while maintaining backward compatibility across bounded contexts in event-driven architectures.

Core Features & Use Cases

  • Identify domain events and design envelope structures to ensure reliable event processing.
  • Create JSON Schema definitions and versioned contracts for domain events.
  • Implement typed events, constructors, and migration strategies to evolve schemas safely.
  • Test event serialization and enforce compatibility across consumer versions.

Quick Start

Begin by listing domain events for your aggregates, design the envelope, create schemas under contracts/events, implement corresponding types, and set up serialization tests.

Frequently Asked Questions about design-event-schema

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design domain event schemas that maintain backward compatibility?โ–ผ

Design domain event schemas with versioned JSON Schema contracts under contracts/events, using typed events and migration strategies to ensure backward-compatible evolution across bounded contexts.

What is the best way to version event-driven architecture contracts?โ–ผ

Version event-driven architecture contracts by creating JSON Schema definitions for domain events, implementing builder-type event constructors, and enforcing compatibility through serialization tests.

How do I structure an event envelope for reliable domain event processing?โ–ผ

Structure an event envelope by identifying domain events for your aggregates, then designing the envelope structure to support reliable event processing and schema evolution.

How do I evolve JSON Schema definitions across bounded contexts without breaking consumers?โ–ผ

Evolve JSON Schema definitions safely by implementing typed events with migration strategies and enforcing serialization tests that validate backward compatibility across consumer versions.

Can I use JSON Schema for domain event contracts in event-driven architectures?โ–ผ

Yes, JSON Schema is used to create versioned contracts for domain events, defining structured envelope designs and typed events that support reliable processing and safe schema evolution.

When do I need to set up serialization tests for domain event schemas?โ–ผ

Set up serialization tests for domain event schemas when you need to enforce compatibility across consumer versions and ensure backward-compatible evolution of your versioned contracts.

Related Skills

Explore More Software Engineering Skillsโ†’
rodrigo-altissimorodrigo-altissimo

software-engineering-eng-ddd

Analyze business domains to produce bounded contexts, aggregates, and ubiquitous language.

Community
Advanced
Dev-GOMDev-GOM
95

Unity Script Validator

Validate Unity C# scripts for performance and best practices.

Community
Intermediate
semicolon-devteamsemicolon-devteam

create-event-schema

Generate TypeScript event envelope types and Zod schemas from event contracts.

Official
Advanced
doanchienthangdevdoanchienthangdev
4

Schema Registry

Manage event schemas with Avro, Protobuf, and JSON Schema formats.

Community
Advanced