backend-dev-guidelines

Standardize Node.js/Express/TypeScript backend services with layered architecture and governance.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/WilliansHerrera/inventario-w --skill backend-dev-guidelines-williansherrera
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backend-dev-guidelines
Source: https://github.com/WilliansHerrera/inventario-w/tree/main/.agent/skills/backend-dev-guidelines
Command: npx skills add https://github.com/WilliansHerrera/inventario-w --skill backend-dev-guidelines-williansherrera

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Establishes production-grade backend development practices for Node.js/Express/TypeScript services, ensuring consistency, reliability, and maintainability across teams.

Core Features & Use Cases

  • Layered architecture mandate: Routes → Controllers → Services → Repositories → Database to prevent cross-layer leakage.
  • Comprehensive governance: DI, centralized configuration, validation with Zod, robust error handling, and observability requirements.
  • Quality and safety controls: Sentry integration for errors and performance, testing discipline, and anti-pattern avoidance across microservices and monoliths.

Quick Start

Align a new or existing backend service with the guidelines by ensuring routing delegates to controllers, controllers delegate to services, and services call repositories, all under unified config, validation, and observability.

Frequently Asked Questions about backend-dev-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a Node.js and Express backend to prevent logic leaking across layers?

Layered backend architecture separates concerns by routing requests through Routes → Controllers → Services → Repositories → Database. This structure prevents cross-layer leakage, ensuring predictable and maintainable services.

What is the best way to standardize validation and error handling in a TypeScript backend?

Standardize validation and error handling in a TypeScript backend by centralizing configuration and using Zod schemas. Explicit error handling and unified configuration ensure reliable and robust service operations.

How do I enforce observability and testing discipline across microservices and monoliths?

Enforce observability across microservices and monoliths by integrating Sentry for errors and performance monitoring. Strong testing discipline and robust error handling maintain quality and safety controls.

Can I use these backend development guidelines for both microservices and monoliths?

Yes, these backend development guidelines apply to both microservices and monoliths. They mandate consistent practices for routing, controllers, services, repositories, and configuration regardless of architectural scale.

What are common anti-patterns to avoid when building Express and TypeScript services?

Common anti-patterns in Express and TypeScript services include bypassing the Routes → Controllers → Services → Repositories hierarchy, mismanaging dependency injection, and lacking explicit error handling or unified configuration.