What architecture does this skill follow?

It implements a strict layered architecture separating concerns into Routes, Controllers (extending BaseController), Services for business logic, and Repositories for data access.

Can I use this for existing projects?

Absolutely. The skill includes guidelines for migrating from legacy patterns to modern, structured backend practices and refactoring controllers or middleware.

Does it support error tracking?

Yes, it includes built-in patterns for Sentry integration, ensuring all exceptions are captured and reported for better observability and production monitoring.

How does it handle input validation?

The skill mandates using Zod schemas to validate all incoming request data, ensuring type safety and preventing malformed inputs from reaching the business logic layer.

Why use unifiedConfig instead of process.env?

Using a unifiedConfig system provides centralized, type-safe access to environment variables, reducing runtime errors and improving configuration management across different microservices.

Backend Development Guidelines

Name: Backend Development Guidelines
Author: claudiodearaujo

byclaudiodearaujo

•

API Development

Standardizes Node.js, Express, and TypeScript microservice development using a layered architecture and robust patterns for validation, error handling, and data access.

This skill provides a comprehensive framework for building robust backend services by enforcing architectural consistency across Node.js and TypeScript environments. It guides developers through the implementation of layered patterns—separating routes, controllers, services, and repositories—while integrating essential tools like Prisma for database access, Zod for validation, and Sentry for error tracking. Whether you are bootstrapping a new microservice or refactoring legacy code, these guidelines ensure production-grade quality, unified configuration management, and high testability through standardized implementation patterns.

Key Features

01Integrates Sentry for automated error tracking and performance monitoring

02Standardizes input validation using Zod schemas for type-safe APIs

03Simplifies configuration management through a unifiedConfig system instead of raw process.env

04Enforces layered architecture across Routes, Controllers, Services, and Repositories

051 GitHub stars

06Provides a BaseController pattern for consistent HTTP request handling

Use Cases

01Implementing standardized error handling and monitoring across multiple backend services

02Refactoring legacy Express APIs into a structured, maintainable layered architecture

03Architecting new Node.js/TypeScript microservices from scratch with a proven structure

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claudiodearaujo/sistema-de-narra-o-de-livro backend-dev-guidelines

For use in Claude.ai and ChatGPT

Download Skill