What architecture does this skill follow?

It follows a strict four-layer architecture: Routes for routing only, Controllers for request handling, Services for business logic, and Repositories for data access.

Is TypeScript required for this skill?

Yes, the guidelines are specifically designed for TypeScript to ensure type safety, especially when using Zod for input validation and Prisma for database schema consistency.

How does it handle error tracking?

The skill enforces Sentry integration across all layers, ensuring that every error is captured and reported while maintaining a clean error boundary via middleware.

Can I use this for existing projects?

Absolutely. The skill includes a navigation guide and migration patterns to help refactor legacy code into the recommended layered structure and modern async patterns.

Does this skill support database management?

Yes, it is optimized for Prisma ORM and includes best practices for the Repository pattern to ensure clean and decoupled data access layers.

Backend Development Guidelines

Name: Backend Development Guidelines
Author: claudiodearaujo

byclaudiodearaujo

•

API Development

Implements a standardized, layered architecture for Node.js microservices using Express, TypeScript, and Prisma.

This skill provides a comprehensive framework for building robust backend services by enforcing a strict layered architecture (Routes-Controllers-Services-Repositories). It streamlines the development process with built-in patterns for Zod input validation, Sentry error tracking, and unified configuration management, ensuring high consistency across microservices while preventing common anti-patterns like business logic leakage into routes or direct environment variable access.

Key Features

01Strict layered architecture enforcement (Routes to Repositories)

02Automated input validation using Zod schemas

03Standardized BaseController for consistent API response handling

04Secure configuration management through unifiedConfig patterns

051 GitHub stars

06Centralized error tracking and monitoring with Sentry integration

Use Cases

01Scaffolding new Node.js/Express microservices with TypeScript

02Refactoring legacy backend code into a structured, testable architecture

03Implementing database-driven features using Prisma and the Repository pattern

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