backend-dev-guidelines

Guide Node.js Express TypeScript microservice development with layered architecture and validation.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/AndyAnh174/BanThuoc-SEO --skill backend-dev-guidelines-andyanh174
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backend-dev-guidelines
Source: https://github.com/AndyAnh174/BanThuoc-SEO/tree/main/.agent/skills/backend-dev-guidelines
Command: npx skills add https://github.com/AndyAnh174/BanThuoc-SEO --skill backend-dev-guidelines-andyanh174

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide to building robust, maintainable, and scalable backend microservices using Node.js, Express, and TypeScript, ensuring consistency and adherence to best practices.

Core Features & Use Cases

  • Layered Architecture: Understand and implement a clean separation of concerns (routes, controllers, services, repositories).
  • Best Practices: Follow 7 key rules for consistent code, including using BaseController, Zod validation, Sentry error tracking, and the repository pattern.
  • Use Case: When starting a new backend feature, like adding a new API endpoint for user management, consult this guide to ensure you follow the established patterns for routes, controllers, services, and data access.

Quick Start

Follow the 7 key rules outlined in this guide when developing any new backend feature.

Frequently Asked Questions about backend-dev-guidelines

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

FAQPage Schema
What is layered architecture in backend microservices and how does it separate concerns?

Layered architecture in backend microservices separates concerns into routes, controllers, services, and repositories. This structure ensures maintainable Node.js and Express applications by isolating business logic from data access and routing layers.

How do I validate request data in Node.js and Express using Zod?

You validate request data in Node.js and Express using Zod by defining schema validation rules within your controller patterns. This enforces consistent backend practices and prevents invalid data from reaching your service or repository layers.

What's the best way to structure a new TypeScript backend API endpoint?

The best way to structure a TypeScript backend API endpoint is following the repository pattern and using a BaseController. This enforces consistent code practices across microservices, standardizing routing, service logic, and data access implementation.

How do I integrate Sentry error tracking into a Node.js and Express microservice?

You integrate Sentry error tracking into a Node.js and Express microservice as part of your core backend development rules. This ensures robust error monitoring and consistent configuration management across all your distributed services.

Does this backend microservice guide require any specific configuration management setup?

This backend microservice guide includes configuration management as a core best practice. You establish consistent configuration handling across Node.js and Express services to ensure maintainable and scalable distributed architectures.

When do I need the repository pattern for backend microservices?

You need the repository pattern for backend microservices when establishing a clean separation of concerns between your data access and business logic. It ensures maintainable TypeScript service layers by abstracting database interactions.