backend-dev-guidelines

What problem does it solve?

This Skill establishes consistency and best practices across backend microservices, addressing issues like inconsistent architecture, poor error handling, lack of validation, and difficult-to-maintain codebases. It guides developers in building robust, scalable, and testable Node.js/Express/TypeScript APIs.

Core Features & Use Cases

• Layered Architecture: Enforces a clear separation of concerns (Routes → Controllers → Services → Repositories) for improved maintainability and testability.
• Type-Safe Validation & Configuration: Mandates Zod for input validation and unifiedConfig for type-safe, centralized configuration, eliminating process.env direct usage.
• Comprehensive Error Handling & Monitoring: Integrates Sentry for mandatory error tracking and performance monitoring, ensuring all errors are captured with rich context.
• Use Case: When developing a new API endpoint for a Node.js microservice, use this Skill to ensure the implementation follows the layered architecture, uses Zod for input validation, integrates Sentry for error tracking, and adheres to the BaseController pattern for consistent response handling.

Quick Start

Create a new Node.js/Express API endpoint for user creation, including a controller, service, and repository, with Zod validation and Sentry integration, following the layered architecture.