mcpField
E
event-sourcing-architect

event-sourcing-architect

github.com/sickn33Development48.7k326 installsUpdated today
Repository

About event-sourcing-architect

event-sourcing-architect is a skill for architects and developers designing event-sourced systems. It covers event stores, CQRS, projections, sagas, versioning, and consistency, while emphasizing cautious adoption and projection-rebuild validation.

Key features

  1. 01Event store design
  2. 02CQRS and read/write separation
  3. 03Projection building and rebuilding
  4. 04Saga and process orchestration
  5. 05Event versioning and snapshots
  6. 06Consistency and idempotency guidance

Use cases

  1. 01Designing systems with audit trails
  2. 02Modeling workflows with compensating actions
  3. 03Querying past system state
  4. 04Building event-driven microservices

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill event-sourcing-architect

After installing, type/event-sourcing-architectin Claude Code to confirm it loaded.

Details

From the project README

Event Sourcing Architect

Expert in event sourcing, CQRS, and event-driven architecture patterns. Masters event store design, projection building, saga orchestration, and eventual consistency patterns. Use PROACTIVELY for event-sourced systems, audit trail requirements, or complex domain modeling with temporal queries.

Capabilities

  • Event store design and implementation
  • CQRS (Command Query Responsibility Segregation) patterns
  • Projection building and read model optimization
  • Saga and process manager orchestration
  • Event versioning and schema evolution
  • Snapshotting strategies for performance
  • Eventual consistency handling

Use this skill when

  • Building systems requiring complete audit trails
  • Implementing complex business workflows with compensating actions
  • Designing systems needing temporal queries ("what was state at time X")
  • Separating read and write models for performance
  • Building event-driven microservices architectures
  • Implementing undo/redo or time-travel debugging

Do not use this skill when

  • The domain is simple and CRUD is sufficient
  • You cannot support event store operations or projections
  • Strong immediate consistency is required everywhere

Instructions

  1. Identify aggregate boundaries and event streams
  2. Design events as immutable facts
  3. Implement command handlers and event application
  4. Build projections for query requirements
  5. Design saga/process managers for cross-aggregate workflows
  6. Implement snapshotting for long-lived aggregates
  7. Set up event versioning strategy

Safety

  • Treat committed events as immutable by default; approved privacy/retention/legal deletion requirements need a deliberate redaction/key-deletion/migration design and audit trail, not a blanket claim that events can never be deleted.
  • Rebuild projections in staging before running in production.

Best Practices

  • Events record domain assertions with version/provenance; corrections are new events by default, not proof that every recorded assertion was objectively true
  • Keep events small and focused
  • Version events from day one
  • Design for eventual consistency
  • Use correlation IDs for tracing
  • Implement idempotent event handlers
  • Plan for projection rebuilding
  • Use durable execution for process managers and sagas — frameworks like DBOS persist workflow state automatically, making cross-aggregate orchestration resilient to crashes

Related Skills

Works well with: saga-orchestration, architecture-patterns, dbos-*

Example

User request:

Build systems requiring complete audit trails.

Limitations

  • Record actual aggregate concurrency/ordering guarantees, idempotency keys and projection lag; sagas compensate business effects but are not automatic rollback of every external action. Replay must suppress real notifications/payments and other effects unless separately authorized.
  • Do not introduce event sourcing/CQRS where a simpler design meets the task; retain policy and deletion boundaries, and test projection rebuild before claiming audit completeness.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Comments

Markdown supported