Files

T

shancheas 0b0bdd9c4b Add new skills for backend patterns, coding standards, continuous learning, and NestJS best practices

- Introduced backend patterns skill with guidelines on API design, database optimization, and server-side best practices.
- Added coding standards skill outlining universal coding principles for TypeScript, NestJS, and Node.js development.
- Implemented continuous learning skill to automatically extract reusable patterns from Cursor sessions.
- Created NestJS best practices skill detailing architecture patterns, dependency injection, error handling, and security measures.
- Included various rules and templates for NestJS best practices to ensure production-ready applications.

2026-08-20 18:30:39 +07:00

4.6 KiB

Raw Blame History

name, description, license, metadata

name

description

license

metadata

nestjs-best-practices

NestJS best practices and architecture patterns for building production-ready applications. This skill should be used when writing, reviewing, or refactoring NestJS code to ensure proper patterns for modules, dependency injection, security, and performance.

MIT

author	version
Kadajett	1.2.0

NestJS Best Practices

When a rule mentions TypeORM, apply the same idea with Drizzle ORM (drizzle/schema.ts and drizzle-kit migrations). This project does not use TypeORM.

When to Apply

Reference these guidelines when:

Writing new NestJS modules, controllers, or services
Implementing authentication and authorization
Reviewing code for architecture and security issues
Refactoring existing NestJS codebases
Optimizing performance or database queries
Building microservices architectures

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Architecture	CRITICAL	`arch-`
2	Dependency Injection	CRITICAL	`di-`
3	Error Handling	HIGH	`error-`
4	Security	HIGH	`security-`
5	Performance	HIGH	`perf-`
6	Testing	MEDIUM-HIGH	`test-`
7	Database & ORM	MEDIUM-HIGH	`db-`
8	API Design	MEDIUM	`api-`
9	Microservices	MEDIUM	`micro-`
10	DevOps & Deployment	LOW-MEDIUM	`devops-`

Quick Reference

1. Architecture (CRITICAL)

arch-avoid-circular-deps - Avoid circular module dependencies
arch-feature-modules - Organize by feature, not technical layer
arch-module-sharing - Proper module exports/imports, avoid duplicate providers
arch-single-responsibility - Focused services over "god services"
arch-use-repository-pattern - Abstract database logic for testability
arch-use-events - Event-driven architecture for decoupling

2. Dependency Injection (CRITICAL)

di-avoid-service-locator - Avoid service locator anti-pattern
di-interface-segregation - Interface Segregation Principle (ISP)
di-liskov-substitution - Liskov Substitution Principle (LSP)
di-prefer-constructor-injection - Constructor over property injection
di-scope-awareness - Understand singleton/request/transient scopes
di-use-interfaces-tokens - Use injection tokens for interfaces

3. Error Handling (HIGH)

error-use-exception-filters - Centralized exception handling
error-throw-http-exceptions - Use NestJS HTTP exceptions
error-handle-async-errors - Handle async errors properly

4. Security (HIGH)

security-auth-jwt - Secure JWT authentication
security-validate-all-input - Validate with class-validator
security-use-guards - Authentication and authorization guards
security-sanitize-output - Prevent XSS attacks
security-rate-limiting - Implement rate limiting

5. Performance (HIGH)

perf-async-hooks - Proper async lifecycle hooks
perf-use-caching - Implement caching strategies
perf-optimize-database - Optimize database queries
perf-lazy-loading - Lazy load modules for faster startup

6. Testing (MEDIUM-HIGH)

test-use-testing-module - Use NestJS testing utilities
test-e2e-supertest - E2E testing with Supertest
test-mock-external-services - Mock external dependencies

7. Database & ORM (MEDIUM-HIGH)

db-use-transactions - Transaction management
db-avoid-n-plus-one - Avoid N+1 query problems
db-use-migrations - Use migrations for schema changes

8. API Design (MEDIUM)

api-use-dto-serialization - DTO and response serialization
api-use-interceptors - Cross-cutting concerns
api-versioning - API versioning strategies
api-use-pipes - Input transformation with pipes

9. Microservices (MEDIUM)

micro-use-patterns - Message and event patterns
micro-use-health-checks - Health checks for orchestration
micro-use-queues - Background job processing

10. DevOps & Deployment (LOW-MEDIUM)

devops-use-config-module - Environment configuration
devops-use-logging - Structured logging
devops-graceful-shutdown - Zero-downtime deployments

How to Use

Read individual rule files for detailed explanations and code examples:

rules/arch-avoid-circular-deps.md
rules/security-validate-all-input.md
rules/_sections.md

Each rule file contains:

Brief explanation of why it matters
Incorrect code example with explanation
Correct code example with explanation
Additional context and references

Full Compiled Document

For the complete guide with all rules expanded in a single document, see AGENTS.md in the repository.

4.6 KiB Raw Blame History