Skip to content
cccskills
FreePublished on GitHub

nestjs-best-practices

NestJS production best practices: 40 reglas en 10 categorías (arquitectura, DI, errores, seguridad, performance, testing, DB/ORM, API, microservicios, devops) priorizadas por impacto. Usar al escribir/revisar código NestJS.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3 stars(GitHub 3 + cccskills 0)

Run score Not tested

See how to install

Files included (10)

  • SKILL.md3.6 KB
  • references/api-design.md1.1 KB
  • references/architecture.md1.9 KB
  • references/database.md1.2 KB
  • references/dependency-injection.md1.5 KB
  • references/error-handling.md1.1 KB
  • references/microservices-devops.md1.5 KB
  • references/performance.md1.0 KB
  • references/security.md1.4 KB
  • references/testing.md973 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

nestjs-best-practices — Guía priorizada por impacto

40 reglas para aplicaciones NestJS production-ready, organizadas en 10 categorías y priorizadas de CRITICAL a LOW-MEDIUM. Cada regla del catálogo (en references/) trae impacto, ejemplo incorrecto, ejemplo correcto y link a docs.

MANDATORY WORKFLOW

No aplicar las 40 reglas a ciegas. Diagnosticar primero, priorizar por impacto.

Step 0: Determinar scope

  1. ¿Código nuevo o auditoría de existente? Si es auditoría, leer primero el módulo/servicio objetivo.
  2. ¿Qué categoría aplica? Mapear el área del problema (ver tabla) o usar all para review completa.
  3. ¿Hay síntomas concretos? (crashes, lentitud, N+1, leaks) → ir directo a la categoría relevante.

Step 1: Priorizar por impacto

Aplicar en este orden — no bajar de nivel hasta resolver el anterior:

PrioridadCategoríaImpactoReference
1ArchitectureCRITICALreferences/architecture.md
2Dependency InjectionCRITICALreferences/dependency-injection.md
3Error HandlingHIGHreferences/error-handling.md
4SecurityHIGHreferences/security.md
5PerformanceHIGHreferences/performance.md
6Database & ORMMEDIUM-HIGHreferences/database.md
7TestingMEDIUM-HIGHreferences/testing.md
8API DesignMEDIUMreferences/api-design.md
9MicroservicesMEDIUMreferences/microservices-devops.md
10DevOps & DeploymentLOW-MEDIUMreferences/microservices-devops.md

Step 2: Aplicar + verificar

Para cada regla relevante: leer el ejemplo correcto en el reference, aplicarlo, y verificar contra el checklist de cierre.

Step 3: Checklist de cierre

  • Sin dependencias circulares (madge --circular o equivalente)
  • Constructor injection en todos los providers; cero ModuleRef.get() en runtime
  • ValidationPipe global + DTOs decorados en todos los endpoints
  • Guards declarativos para auth/authz (no checks manuales)
  • Sin N+1 (eager loading / joins donde corresponde)
  • Migraciones versionadas, synchronize: false en prod
  • Graceful shutdown (SIGTERM) + health checks
  • Structured logging (JSON)

Si todo el checklist pasa → código COMPLIANT. Antes de escribir cambios significativos, confirmar el approach con el usuario (Question → Decision → Approval).

Tabla de mapeo síntoma → categoría

SíntomaCategoría
Crash al arrancar / módulos no resuelvenArchitecture, DI
Lentitud en endpoints, muchas queriesPerformance, Database
Errores 500 inconsistentes / leaks de stack tracesError Handling
Endpoints expuestos / brute force / data sensibleSecurity
Tests frágiles o que llaman servicios realesTesting
Respuestas inconsistentes / circular refsAPI Design

Adaptado de kadajett/agent-nestjs-skills. El repo original compila reglas atómicas (rules/*.md) a un AGENTS.md vía build script; acá se reorganizó al formato skill+references de Arcane.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Plan, design, and implement A/B tests and experiments with statistical rigor. Covers hypothesis frameworks, sample sizing, metrics, and result analysis.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Web/mobile accessibility decision guide: WCAG 2.2 AA, ARIA, keyboard nav, focus management, contrast, testing. Use for: a11y, accessibility, wcag, aria, screen reader, keyboard, contrast.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Generate, iterate, and scale ad creative for paid advertising across Google, Meta, LinkedIn, and X. Covers platform specs, creative frameworks, and quality validation.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Musica interactiva para juegos: layering vertical, re-secuenciacion horizontal, stingers, reglas de transicion con sync points, y mapeo de estados de gameplay a musica. Usar para: musica adaptativa, sistema de musica dinamica, transiciones musicales, combat music.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Design multi-agent systems, create agent architectures, define communication patterns, and build autonomous agent workflows with structured evaluation frameworks.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Inter-agent communication protocol for C-suite agent teams. Defines invocation syntax, loop prevention, isolation rules, response formats, and quality loops.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

See all skills by SebastianLuser

Report a problem with this skill