amadeus-dlc Error Handling
Choose error mechanisms by recoverability and caller responsibility.
Workflow
Classify each error as domain, validation, application, infrastructure, programming defect, or fatal system condition.
Use typed
Result/Either-style returns for recoverable domain and validation errors.Use exceptions or panics for defects and truly exceptional infrastructure failures when callers cannot make a local decision.
Preserve causal context without leaking secrets.
Put retry, timeout, and circuit-breaker policy at integration boundaries.
Rules
Domain errors should be explicit in function signatures where the language supports it.
Do not use exceptions for ordinary business branching.
Log once at the boundary that handles or reports the error.
Convert low-level errors into application-facing errors at layer boundaries.
Reference
Read references/guidelines.md for detailed patterns.
Detailed Reference
For non-trivial implementation, review, or refactoring work, read references/details.md before giving final guidance. It contains the detailed rules, examples, smells, and migration notes that do not belong in the short invocation body.
Output
Return the error taxonomy, mechanism choices, API changes, and tests.