observability-guidelines

name	observability-guidelines
description	Error-handling conventions for this project — `try`/`catch` placement, `reportError(...)`/Sentry capture calls, and top-level error boundaries.
when_to_use	Use whenever writing, reviewing, or modifying code that throws, catches, or reports errors — even when the user only mentions Sentry, capturing an exception, error boundaries, or debugging an unhandled exception in this project.
user-invocable	false

Observability Guidelines

Apply these rules when writing, reviewing, or modifying any code that handles or reports errors.

Error Handling

See error-handling.md for:

• Where to place try-catch blocks and how errors propagate
• Rethrowing errors that are caught only for side effects
• When caught errors should be reported before alternate control flow
• Top-level error boundaries and root-level error handling

Error Tracking

See error-tracking.md for:

• Sentry initialization and runtime-specific configuration files
• The error-reporting capture call's import source, context, and privacy boundaries
• PII settings and safe event context
• Source map and instrumentation changes