event-replay-strategy

Replay historical SaaS events with idempotency checks and configurable batch throttling.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/marquesfelip/agents-and-skills --skill event-replay-strategy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: event-replay-strategy
Source: https://github.com/marquesfelip/agents-and-skills/tree/main/skills/event-replay-strategy
Command: npx skills add https://github.com/marquesfelip/agents-and-skills --skill event-replay-strategy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables safe and repeatable replay of historical SaaS events to bootstrap new consumers, correct derived data, and recover from failures.

Core Features & Use Cases

  • Prerequisites: consumer idempotency to ensure duplicates are harmless in replay.
  • Outbox-based replay source and selective replay across tenants, aggregates, or event types.
  • Replay runner with batching, throttling, dry-run mode, and clear separation from production replay.
  • Kafka replay support via offset resets for replay from a point in time.

Quick Start

Run a dry-run replay for all tenants from the last 7 days using the outbox as the source to verify idempotency and safety before enabling live replay.

Frequently Asked Questions about event-replay-strategy

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

FAQPage Schema
How do I safely replay historical SaaS events to recover from failures?

To safely replay SaaS events, you need a strategy that includes consumer idempotency checks, batch processing with throttling, and a dry-run mode to verify safety before live execution. This approach supports outbox-based replay and Kafka offset resets.

What is the best way to bootstrap a new consumer using event sourcing?

Bootstrapping a new event sourcing consumer is best achieved by replaying historical events from an outbox source. You can perform a selective replay filtered by tenants, aggregates, or event types to populate the new consumer's derived data accurately.

Do I need idempotency checks before replaying Kafka events?

Yes, consumer idempotency is a mandatory prerequisite before replaying Kafka events. Ensuring duplicates are harmless prevents data corruption during full or selective replays, allowing safe recovery and offset resets without side effects.

Can I run a selective event replay for specific tenants or event types?

Yes, you can run a selective event replay across specific tenants, aggregates, or event types. Using a configurable replay gate, the system filters historical outbox events, allowing targeted data correction without processing the entire event store.

How does a dry-run mode work when replaying outbox events?

Dry-run mode works by simulating the outbox event replay process without applying live changes. It allows you to verify consumer idempotency and replay safety for a defined period, such as the last 7 days, before committing to a live replay.

How do I reset Kafka offsets to replay events from a specific point in time?

To replay events from a point in time, you can perform a Kafka offset reset. This replay strategy supports offset resets alongside outbox-source paths, allowing you to reprocess historical events and correct derived data safely.