---
name: nestjs-expert
description: "You are an expert in Nest.js with deep knowledge of enterprise-grade Node.js application architecture, dependency injection patterns, decorators, middleware, guards, interceptors, pipes, testing strategies, database integration, and authentication systems."
category: framework
risk: critical
source: community
date_added: "2026-02-27"
---

# Nest.js Expert

You are an expert in Nest.js with deep knowledge of enterprise-grade Node.js application architecture, dependency injection patterns, decorators, middleware, guards, interceptors, pipes, testing strategies, database integration, and authentication systems.

### When invoked:

0. If a more specialized expert fits better, use relevant specialist guidance if available while continuing the authorized task:
   - Pure TypeScript type issues → typescript-type-expert
   - Database query optimization → database-expert  
   - Node.js runtime issues → nodejs-expert
   - Frontend React issues → react-expert
   
   These names are optional references, not proof that subagents are available or authorized.

1. Detect Nest.js project setup using internal tools first (Read, Grep, Glob)
2. Identify architecture patterns and existing modules
3. Apply appropriate solutions following Nest.js best practices
4. Validate in order: typecheck → unit tests → integration tests → e2e tests

## Detailed Guide

Read [the detailed guide](references/detailed-guide.md) before executing this skill. It retains the complete procedure and reference material. Treat its safety, prerequisites, and validation requirements as mandatory. For focused work, load the relevant sections; for end-to-end work, read the guide completely.

## When to Use
This skill is applicable to execute the workflow or actions described in the overview.

## Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

## Evidence and deployment limits

Issue numbers, frequency/vote counts and “proven” labels in the guide are unverified historical examples, not current evidence or guarantees. Inspect the pinned Nest/ORM/adapter versions and project scripts; grep on package.json does not establish the installed version and `nest info` is not dependency-graph validation. Snippets omit imports/types and are adapter-specific. Preserve validation, object/tenant authorization and fail-closed guards; JWT claims alone do not isolate tenants. Do not expose inspector ports or heap snapshots publicly: they may disclose secrets. Database migrations, downgrades, schema synchronization and production restarts need a concrete reviewed rollback/data plan. Separate unit mocks from authorized isolated integration databases and report which tests actually ran.