Upstream reference (vendored)

This skill and reference/*.md are copied from:

Repository: https://github.com/kumaran-is/claude-code-onboarding
Commit (pin): 2e086adbb37293b58eb8cee69773f5972928db51
Upstream folder: .claude/skills/nestjs-api

Project note: This codebase uses NestJS + Express (default HTTP adapter) and Prisma 6. The reference often mentions Fastify and Prisma 7; follow the same structural patterns and adapt adapter- or version-specific lines to match and .

File

Content

Load When

reference/nestjs-config-basics.md

Static config reader, config module aggregation, fail-fast validation

Project setup, initial configuration

reference/nestjs-config-npm-ts.md

package.json with dependencies, tsconfig.json

Project setup, configuring dependencies

reference/nestjs-config-prisma7.md

Prisma 7.x schema, prisma.config.ts, PrismaService, .env template

Setting up database, writing Prisma queries

reference/nestjs-templates-core.md

main.ts, app.module, core.module templates

Bootstrapping app, creating core module

reference/nestjs-templates-features.md

Feature module, controller, service, DTO templates

Creating modules, controllers, services

reference/nestjs-templates-infrastructure.md

Dockerfile, docker-compose, Vitest config

Containerizing app, configuring test runner

reference/nestjs-enterprise-patterns.md

Exception hierarchy, validation pipe, API versioning

Implementing error handling, input validation, API versioning

reference/nestjs-enterprise-infrastructure.md

Security middleware (Helmet), rate limiting, Swagger, health checks

Adding security headers, rate limiting, API documentation

reference/nestjs-resilience-circuit-breaker.md

Circuit breaker, retry, timeout, database fallback

Adding resilience patterns, handling service failures

reference/nestjs-resilience-context.md

Request context with AsyncLocalStorage, correlation IDs

Adding request tracing, correlation IDs

reference/nestjs-feature-flags.md

Feature flags service, Redis fallback, gradual rollout

Implementing feature flags, gradual rollout

reference/nestjs-observability.md

OpenTelemetry tracing/metrics, structured logging, cloud logging

Adding observability, structured logging, tracing

reference/nestjs-messaging-basics.md

BullMQ queues, background job processing

Adding background jobs, queue processing

reference/nestjs-messaging-queues.md

RabbitMQ reliable messaging, dead letter queues

Implementing RabbitMQ messaging, dead letter queues

reference/nestjs-messaging-streaming.md

Kafka event streaming, high-throughput patterns

Implementing Kafka streaming, high-throughput events

reference/nestjs-testing-unit-basics.md

Unit testing with Vitest, service test patterns

Writing unit tests for services

reference/nestjs-testing-unit-controllers.md

Controller unit tests, test data factories

Writing unit tests for controllers

reference/nestjs-testing-unit-mocks.md

Prisma/Redis/HTTP mocking, ConfigService mocking

Mocking dependencies in unit tests

reference/nestjs-testing-integration-setup.md

E2E testing setup, Testcontainers, supertest

Writing integration tests, E2E tests

reference/nestjs-testing-integration-patterns.md

Auth testing, validation, pagination patterns

Testing auth flows, pagination, validation

reference/nestjs-testing-patterns.md

Circuit breaker testing, AsyncLocalStorage testing

Testing resilience patterns, context propagation

reference/nestjs-testing-ci-troubleshooting.md

Coverage standards, CI/CD, troubleshooting

Configuring CI pipelines, coverage thresholds

reference/nestjs-rest-workflow.md

REST workflow, OpenAPI/Swagger controller setup

Designing REST endpoints, setting up Swagger

reference/nestjs-rest-dto-pagination.md

DTO mapping, pagination, filter patterns

Creating DTOs, implementing pagination

reference/nestjs-rest-upload-errors.md

File uploads, API versioning, ProblemDetail errors

Implementing file uploads, error responses

reference/nestjs-rest-services.md

Service patterns, external API clients, bulk operations, soft delete

Writing service logic, calling external APIs

reference/nestjs-security-auth.md

JWT authentication (RS256), password hashing, token management

Implementing JWT auth, implementing guards

reference/nestjs-security-scanning.md

OWASP scanning, security headers, static analysis

Security auditing, dependency scanning

reference/nestjs-security-validation-logging.md

Input validation, PII masking, Prisma security

Securing input handling, masking sensitive data

reference/nestjs-debugging-logging.md

Debug mode, Prisma query logging, Fastify lifecycle

Debugging requests, tracing Prisma queries

reference/nestjs-debugging-context-di.md

AsyncLocalStorage context, DI debugging, config

Debugging DI issues, context propagation

reference/nestjs-debugging-performance.md

Memory leaks, performance profiling

Diagnosing memory leaks, profiling performance

reference/nestjs-debugging-production.md

Production debugging, structured logging, tracing

Debugging production issues, structured logging

reference/nestjs-review-checklist.md

NestJS review checklist (used by nestjs-reviewer agent)

Code review, pre-PR checklist

reference/nestjs-real-world-issues.md

9 framework-level issues from GitHub/SO with frequency ratings and Vitest-adapted solutions

Debugging DI errors, circular deps, JWT config, memory leaks

reference/nestjs-decision-trees.md

Decision trees for module organization, auth method, testing strategy, caching, error responses

Architecture decisions before implementation

Pattern	Implementation
Modules	`@Module()` with imports/providers/exports, aggregation pattern
Controllers	`@Controller('api/v1/...')` with route decorators
Services	`@Injectable()` with constructor injection
DTOs	Classes with `class-validator` decorators (`@IsString()`, `@IsNotEmpty()`)
Repositories	Prisma Client via `DatabaseService` wrapper
Error handling	`@Catch()` exception filter returning `ProblemDetail` (RFC 9457)
Config	Fail-fast `registerAs()` with static config reader
Migrations	Prisma Migrate in `prisma/migrations/`
Guards	`@UseGuards()` for auth (`JwtAuthGuard`, `RolesGuard`)
Interceptors	`LoggingInterceptor`, `TransformInterceptor` (global)
Pipes	Global `ValidationPipe` with whitelist and transform

Source	URL / Tool	Purpose
Prisma ORM	`https://www.prisma.io/docs/llms.txt`	Prisma schema, migrations, client API
NestJS / TypeScript	`Context7` MCP	Latest NestJS decorators, modules, patterns

Nestjs Api

Upstream reference (vendored)

Nestjs Api

Upstream reference (vendored)

Iron Law

NestJS + Prisma REST API Skill (reference pack)

Conventions & Rules

Quick Scaffold — New NestJS Project

Process

Key Patterns

Reference Files

Common Commands

Documentation Sources

Error Handling

Hard Prohibitions

Post-Code Review

Xurl

Acp Router

Coding Standards

Api Design

Mcp Server Patterns

Backend Patterns