system-error-handling-strategy

Classify errors into eight classes and prescribe handling strategies across service boundaries.

1|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/SSiertsema/claude-code-plugins --skill system-error-handling-strategy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-error-handling-strategy
Source: https://github.com/SSiertsema/claude-code-plugins/tree/main/system-error-handling-strategy/skills/system-error-handling-strategy
Command: npx skills add https://github.com/SSiertsema/claude-code-plugins --skill system-error-handling-strategy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

System-wide error-handling strategy for classifying and responding to failures across services, with defined propagation, translation, and observability rules.

Core Features & Use Cases

  • Classification of errors into Programmer, Validation, Domain, Transient, Resource, Poison, External contract, and Unknown
  • Per-class strategies (fail-fast, retry budgets, circuit-break, DLQ, escalate) and clear propagation rules
  • Propagation and translation across boundaries with structured error details, traceability, and observability
  • Observability integration: metrics, logs, and alerts to support fast incident response

Quick Start

Outline your system-wide error-handling strategy by classifying error sources, selecting per-class responses, and defining propagation and observability rules.

Frequently Asked Questions about system-error-handling-strategy

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

FAQPage Schema
How do I handle system-wide error handling and classification across microservices?

System-wide error handling classifies failures into Programmer, Validation, Domain, Transient, Resource, Poison, External contract, and Unknown categories. It prescribes per-class strategies like fail-fast, retry budgets, or circuit breaking, and enforces explicit propagation with structured details across service boundaries.

What is the best way to propagate and translate errors across service boundaries?

Propagate and translate errors across service boundaries by enforcing structured error details, explicit translation rules, and observability requirements. This ensures reliable detection, alerting, and tracing while maintaining traceability for fast incident response.

When should I use a circuit breaker, dead-letter queue, or exponential backoff budget?

Apply circuit breakers, dead-letter queues, and exponential backoff budgets when handling transient dependency failures and poison data. These mechanisms ensure safe escalation and recovery by preventing cascading failures and dropping unrecoverable messages.

How do you classify transient dependency failures versus poison data in distributed systems?

Classify transient dependency failures as temporary network or service issues requiring retry budgets and circuit breaking. Classify poison data as invalid payloads causing repeated failures, routing them to a dead-letter queue to prevent endless processing loops.

Does system-wide error handling require idempotency and observability rules for incident response?

Yes, system-wide error handling requires idempotency to prevent duplicate side effects during retries and observability rules integrating metrics, logs, and alerts. These rules support fast incident response and reliable failure detection across services.

Why does my retry strategy cause cascading failures instead of safe recovery?

Retry strategies cause cascading failures without exponential backoff budgets, circuit breakers, and timeouts. Enforce these error handling patterns alongside dead-letter queues and structured error details to ensure safe escalation and recovery.