---

name: error-handling description: Error-handling conventions (error mapping/presentation, what to throw vs return, user-facing output). Use when adding errors or changing failure behavior.

Error Handling

When to use

Use this when the task mentions:

• error mapping, user-facing messages, exit codes
• “how should this failure be surfaced”
• standardizing error shapes across packages

Canonical repo doc

Read your repo’s error-handling conventions doc (commonly docs/error-handling.md).