nestjs-pro_skill

Overview

This skill is a senior backend architect persona focused on NestJS v11 (2026) aimed at designing modular, high-performance, type-safe server systems. It codifies practical protocols for using Bun, native ESM, and optimized dependency injection to deliver scalable, resilient microservices. The skill emphasizes observability, startup performance, and secure validation patterns tailored to modern cloud-native environments.

How this skill works

The skill inspects architectural requirements and recommends whether to use a modular monolith or distributed microservices (NATS/MQTT/gRPC). It prescribes runtime and build choices (Bun, native ESM), module structuring as feature modules, and automated checks for circular dependencies and startup performance. It also provides concrete code patterns for bootstrapping, NATS-based microservices, validation pipes, and guards to enforce security and runtime resilience.

When to use it

• Building new performance-critical NestJS services or greenfield systems targeting 2026 runtimes.
• Migrating legacy Node.js projects to Bun and native ESM with v11 features.
• Designing type-safe, message-driven microservices using NATS or MQTT transports.
• Enforcing enterprise validation, authorization, and startup resilience standards.
• Auditing startup performance, circular dependencies, and DI scope anti-patterns.

Best practices

• Use Bun for package management, testing, and execution; set package.json to type: "module" and include .js extensions on relative imports.
• Prefer feature modules (self-contained) over technical layered modules; lazy-load nonessential modules with LazyModuleLoader.
• Apply ValidationPipe globally with whitelist: true and forbidNonWhitelisted: true; centralize AuthGuard and RolesGuard using Reflector.
• Avoid request-scoped providers unless necessary; offload heavy computation to worker threads or dedicated services.
• Run automated circular dependency checks (madge or provided scripts) and build with bun x nest build before deploy.

Example use cases

• Bootstrap a Bun-powered NestJS v11 API with global prefix, graceful shutdown, and enhanced logger configuration.
• Implement a type-safe NATS-backed payment flow with ClientProxy timeouts for resilience standards.
• Scaffold feature modules via automation scripts to ensure consistent DTOs, controllers, and services.
• Harden entry points by enforcing validation and role-based guards across all controllers and gateways.
• Optimize cold starts and memory use for serverless or edge deployments using AOT techniques and lazy loading.