webhook-architect

Installation
SKILL.md

Webhook Architect Protocol

This skill focuses on building outbound webhooks that don't fail silently and don't overwhelm the consumer. An outbound webhook system must be treated as a mission-critical distributed system.

Core assumption: The consumer's server will go down. It will timeout. A good webhook architecture guarantees eventual delivery without blocking the main application flow.


1. Event Payload Design (Static)

Design the JSON structure of the event that will be sent.

  • Envelope Pattern: Wrap the actual data in a standard envelope containing routing information.
    • event_id (UUID for tracing/idempotency).
    • event_type (e.g., order.created, payment.failed).
    • created_at (ISO 8601 Timestamp).
    • data (The actual payload, kept minimal or providing a full object).

2. Delivery & Reliability Strategy

Define how the system handles failure:

  • Timeouts & Retries: Implement exponential backoff (e.g., retry instantly, then 1m, 1h, 6h, 24h).
Related skills

More from fatih-developer/fth-skills

Installs
3
GitHub Stars
4
First Seen
Mar 3, 2026