Error Handling Contracts

Core Workflow

1. Identify clients, failure modes, transport, user-facing surfaces, and logging or observability needs.
2. Define an error envelope with code, message, details, correlation ID, retry guidance, and documentation link where useful.
3. Map domain failures to status codes or exception types.
4. Separate client-safe messages from internal diagnostics.
5. Specify retryability, idempotency, rate-limit behavior, and partial failure handling.
6. Add tests and examples for expected error cases.

Safety Rules