backend-dev-guidelines

Enforce Node.js, Express, and TypeScript microservice standards with layered architecture and validation.

Updated Dec 4, 2025
One-click install
npx skills add https://github.com/mjmmattoni98/recipe-hub --skill backend-dev-guidelines-mjmmattoni98
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backend-dev-guidelines
Source: https://github.com/mjmmattoni98/recipe-hub/tree/main/.agents/skills/backend-dev-guidelines
Command: npx skills add https://github.com/mjmmattoni98/recipe-hub --skill backend-dev-guidelines-mjmmattoni98

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enforces opinionated backend development standards for Node.js microservices, ensuring consistency, reliability, and maintainability across the codebase.

Core Features & Use Cases

  • Layered Architecture: Enforces a strict routes → controllers → services → repositories pattern.
  • Standardized Error Handling: Integrates Sentry for comprehensive error tracking and uses a BaseController for consistent error responses.
  • Input Validation: Mandates Zod for validating all external input.
  • Configuration Management: Uses unifiedConfig for type-safe, centralized configuration.
  • Testing Discipline: Requires unit and integration tests for all backend code.
  • Use Case: A new backend developer joins the team and needs to understand the established patterns for building new API endpoints, refactoring existing code, or debugging issues.

Quick Start

Follow the architectural doctrine outlined in the SKILL.md file when developing new backend features.

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 Express microservice for maintainability?

Structure Node.js Express microservices using a strict layered architecture: routes call controllers, controllers call services, and services call repositories. This separation enforces maintainability and consistency across your backend codebase.

What is the best way to validate external input in TypeScript backend services?

The best way to validate external input in TypeScript backend services is using Zod. Mandating Zod for all incoming requests ensures type-safe validation and prevents invalid data from reaching your business logic.

How do I standardize error handling and tracking in Node.js microservices?

Standardize error handling in Node.js microservices by integrating Sentry for comprehensive error tracking and using a BaseController pattern to ensure consistent error responses across all API endpoints.

Does this backend architecture pattern support Prisma and dependency injection?

Yes, this backend architecture pattern supports Prisma repositories for database access and mandates dependency injection. These standards ensure your Node.js services remain testable and decoupled.

How do I manage type-safe configuration across Node.js microservices?

Manage type-safe configuration across Node.js microservices by using a centralized unifiedConfig. This approach consolidates environment variables and settings into a single, validated configuration source.

What testing discipline is required for Express backend APIs?

Testing discipline for Express backend APIs requires writing both unit and integration tests for all backend code. This ensures reliability and prevents regressions when building new API endpoints or refactoring.