Engineering Standards Skill
Purpose
Enforce clean code practices, SOLID principles, immutability, and strong error handling across full-stack financial codebases.
1. Core Principles
MANDATORY
- Immutability: Use Java
recordtypes for DTOs/API contracts and TypeScriptreadonly/ immutable patterns. - Explicit Error Handling: Centralize exception handling in Spring
@RestControllerAdviceand React Error Boundaries. - Fail Fast: Validate request payloads using standard annotations (
@NotNull,@NotBlank,@Positive) at REST boundaries.
MUST NOT
- Catch generic
Exceptionblindly without logging or proper HTTP status mapping. - Suppress stack traces or return empty generic error bodies (
500 Internal Errorwithout error code). - Invent requirements or force unneeded abstractions.