Engineering Standards

Use when writing or refactoring Java, Spring Boot, React, or TypeScript code to ensure clean code, SOLID principles, immutability, and robust exception handling.

SahilKhan30 Updated

File contents

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 record types for DTOs/API contracts and TypeScript readonly / immutable patterns.
  • Explicit Error Handling: Centralize exception handling in Spring @RestControllerAdvice and React Error Boundaries.
  • Fail Fast: Validate request payloads using standard annotations (@NotNull, @NotBlank, @Positive) at REST boundaries.

MUST NOT

  • Catch generic Exception blindly without logging or proper HTTP status mapping.
  • Suppress stack traces or return empty generic error bodies (500 Internal Error without error code).
  • Invent requirements or force unneeded abstractions.

SahilKhan30/claude-skill/tree/main/.claude/skills/core/engineering-standards commit 734fbbd599

Frequently asked questions

npx skillmds@latest add sahilkhan30/engineering-standards