backend-dev-guidelines
Construye Backends de Node.js en Producción con Mejores Prácticas
También disponible en: BrianDai22,diet103,Dimon94,DojoCodingLabs
Deja de adivinar la arquitectura de backend. Obtén guías completas para servicios en capas de Node.js con Express, TypeScript, repositorios Prisma y validación Zod que escalan de forma confiable.
Descargar el ZIP de la skill
Subir en Claude
Ve a Configuración → Capacidades → Skills → Subir skill
Activa y empieza a usar
Pruébalo
Usando "backend-dev-guidelines". Crear un endpoint de registro de usuario
Resultado esperado:
- Esquema de validación Zod generado para entrada de usuario
- UserController creado extendiendo BaseController con método createUser
- UserService implementado con lógica de negocio e inyección de dependencias
- UserRepository creado con consultas Prisma
- Registro de ruta agregado con asyncErrorWrapper
- Seguimiento de errores Sentry y evaluación BFRI incluidos
Usando "backend-dev-guidelines". Refactorizar consultas de base de datos en línea en rutas
Resultado esperado:
- Lógica de negocio extraída de rutas hacia nuevo UserService
- UserRepository creado para encapsular operaciones Prisma
- UserController actualizado para orquestar llamadas al servicio
- Límites de error apropiados agregados con BaseController
- Pruebas unitarias escritas para capa de servicio
- BFRI mejoró de -2 (peligroso) a 8 (seguro)
Auditoría de seguridad
SeguroStatic analysis flagged 544 patterns across 12 markdown documentation files (5337 lines). All findings are FALSE POSITIVES - the detected patterns exist in markdown code examples and documentation, not executable code. This skill provides secure backend development guidelines that explicitly teach against risky patterns like direct process.env usage. Safe for publication.
Puntuación de calidad
Lo que puedes crear
Desarrollo de Nuevos Microservicios
Genera un microservicio de backend completo desde cero siguiendo patrones listos para producción con capas apropiadas, validación y manejo de errores.
Refactorización de Código Legado
Refactoriza manejadores de ruta monolíticos en una arquitectura en capas apropiada con controladores, servicios y repositorios para mejorar la mantenibilidad.
Incorporación de Equipos y Estándares
Establece estándares consistentes de desarrollo de backend entre equipos con patrones claros para arquitectura, pruebas y manejo de errores.
Prueba estos prompts
Crea un UserController que siga el patrón BaseController con métodos para getUser, listUsers, createUser y updateUser. Incluye manejo de errores apropiado con integración de Sentry.
Crea un UserService que reciba UserRepository mediante inyección de dependencias. Incluye métodos para findById, getAll, create, update y delete con separación apropiada de lógica de negocio.
Implementa una funcionalidad completa de registro de usuario con esquema de validación Zod, controlador que extiende BaseController, servicio con lógica de negocio y repositorio con Prisma. Incluye puntuación BFRI para la implementación.
Refactoriza este manejador de ruta monolítico a una arquitectura en capas apropiada. Identifica rutas, controladores, servicios y repositorios. Agrega manejo de errores apropiado, validación y seguimiento de Sentry. Calcula BFRI antes y después.
Mejores prácticas
- Usa siempre arquitectura en capas: las rutas delegan a controladores, los controladores llaman a servicios, los servicios usan repositorios
- Nunca uses process.env directamente - accede a la configuración a través de unifiedConfig para seguridad de tipos y testeabilidad
- Valida toda entrada externa con esquemas Zod antes de procesar - cuerpos de solicitud, parámetros de consulta y parámetros de ruta
Evitar
- Lógica de negocio en manejadores de ruta - las rutas solo deben delegar a controladores
- Uso directo de Prisma en controladores - siempre abstraer a través de repositorios
- Usar console.log para errores - todos los errores deben capturarse en Sentry
Preguntas frecuentes
¿Por qué usar arquitectura en capas en lugar de poner la lógica en las rutas?
¿Qué es BFRI y cómo lo calculo?
¿Por qué no puedo usar process.env directamente en mi código?
¿Necesito extender BaseController para todos los controladores?
¿Cuándo debo usar transacciones en mis servicios?
¿Cómo pruebo servicios que usan inyección de dependencias?
Detalles del desarrollador
Autor
sickn33Licencia
MIT
Repositorio
https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/backend-dev-guidelinesRef.
main
Estructura de archivos