backend-dev-guidelines

Implement scalable Node.js backends with layered architecture, DI, and Sentry observability.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/abzhaw/juliaz_agents --skill backend-dev-guidelines-abzhaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backend-dev-guidelines
Source: https://github.com/abzhaw/juliaz_agents/tree/main/.agent/skills/backend-dev-guidelines
Command: npx skills add https://github.com/abzhaw/juliaz_agents --skill backend-dev-guidelines-abzhaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide codifies opinionated backend development standards to prevent architectural drift and ensure reliable, maintainable Node.js services.

Core Features & Use Cases

  • Layered architecture with Routes → Controllers → Services → Repositories and explicit separation of concerns.
  • Dependency injection, Zod validation, centralized configuration, and centralized observability with Sentry.
  • Use cases include onboarding new microservices, refactoring legacy code, and enforcing consistent project governance across teams.

Quick Start

Implement a fresh backend service following the canonical architecture, integrating DI and validators, enabling Sentry observability, and organizing code into the standard folder structure.

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 scalable Node.js backend with layered architecture?

A scalable Node.js backend uses a layered architecture separating Routes, Controllers, Services, and Repositories to enforce strict separation of concerns and prevent architectural drift in microservices.

What is the canonical directory structure for production-grade Node.js microservices?

The canonical directory structure for production-grade Node.js microservices organizes code into routes, controllers, services, repositories, and centralized config folders to ensure maintainable and consistent project governance.

How do I implement centralized error handling and observability with Sentry in Express?

Centralized error handling and observability with Sentry in Express is implemented by integrating Sentry monitoring alongside Zod validation to capture errors and validate inputs across backend services.

Does this Node.js backend guideline work with Prisma and dependency injection?

This Node.js backend guideline works with Prisma and dependency injection by codifying DI patterns alongside repository layers, ensuring scalable data access and maintainable service architecture.

What is the best way to enforce consistent naming conventions and Zod validation in Node.js?

The best way to enforce consistent naming conventions and Zod validation in Node.js is by adopting opinionated backend development standards that codify strict rules across controllers and services.

When should I refactor legacy Node.js code into a layered architecture?

You should refactor legacy Node.js code into a layered architecture when preventing architectural drift and ensuring reliable, maintainable services becomes critical for team scaling and project governance.