ia-nodejs-backend

What problem does it solve?

Prevents AI coding agents from producing undisciplined Node.js backends by enforcing a clear plan-first architecture, strict validation, predictable error handling, and production-ready resilience.

Core Features & Use Cases

• Clean architecture layering: keeps HTTP concerns out of services and repositories out of HTTP/error responsibilities.
• Contract-first API design: uses schema-driven contracts (Zod/Fastify JSON Schema/OpenAPI) to control response shapes and reduce Hyrum’s Law surprises.
• Strong TypeScript + validation + errors: promotes type-safe boundaries, Zod/TypeBox validation at entry points, and an operational error hierarchy with consistent envelopes.
• Production hardening patterns: covers env validation, health/readiness endpoints, caching, load shedding, circuit breakers, and response schemas.

Quick Start

Ask the agent to design and implement a Fastify REST API endpoint with Zod request/response schemas, layered routes/services/repositories, and a consistent operational error envelope.