Error Handling

Overview

Standardize error handling across a codebase by implementing a unified error taxonomy, stable error codes, proper propagation chains, and structured logging. The core principle: every error must be categorized, coded, wrapped with context, and split into a safe user-facing message and a detailed internal log entry.

When to use

• The task is to standardize how an existing codebase models, propagates, logs, and returns errors.
• The user needs an error taxonomy, error classes, response envelopes, or correlation-aware logging patterns.
• The problem is inconsistency across layers, services, or endpoints rather than a single failing bug.
• The deliverable is an error-handling framework or pattern, not one-off troubleshooting.

Do NOT use when: