errorx-conventions

What problem does it solve?

Standardizes and guides Go error construction to prevent inconsistent use of stdlib errors and ensure all production code uses errorx conventions. It reduces lint errors and improves error classification across the codebase.

Core Features & Use Cases

• Namespace guidance: maps Go error shapes to the correct errorx namespaces to yield actionable error reporting.
• Migration traps: highlights common migration pitfalls when converting from errors.New/fmt.Errorf to errorx wrappers.
• Sentinel patterns: prescribes how to declare and use sentinel errors with errorx types.
• Test considerations: clarifies lint exemptions for *_test.go files and testing strategies.
• Best-practice enforcement: codifies rule sets to maintain consistent error composition in cmd/, internal/, and pkg/.

Quick Start

Apply these conventions when editing Go error handling in production code to ensure consistent error wrapping with errorx.