error-model-validation-architect
OfficialDesign safe, predictable API errors.
System Documentation
What problem does it solve?
Design and implement consistent API validation and error-handling behavior for Kotlin plus Spring services. Use when defining error payloads, mapping framework and domain exceptions, standardizing HTTP status codes, adding @ControllerAdvice, preventing internal-detail leakage, or ensuring clients can rely on stable machine-readable error semantics across endpoints.
Core Features & Use Cases
- Establish a stable error taxonomy covering malformed input, not found, conflicts, authentication, authorization, and downstream failures.
- Map errors to explicit HTTP status codes and a machine-readable payload with a consistent contract.
- Provide a centralized error handling strategy using a ControllerAdvice and documented guidelines for developers.
- Use cases include API design-time contracts, auditing and observability of errors, and safe error responses for public endpoints.
Quick Start
Define and implement a stable, machine-readable API error contract for a Kotlin + Spring service, including error taxonomy, status mappings, and a ControllerAdvice-based handler.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: error-model-validation-architect Download link: https://github.com/Kotlin/kotlin-backend-agent-skills/archive/main.zip#error-model-validation-architect Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.