refactor:nestjs

What problem does it solve?

This Skill helps teams transform tangled NestJS/TypeScript codebases into modular, maintainable, SOLID-compliant architectures by eliminating circular dependencies, god objects, and fat controllers. It guides applying NestJS patterns like modules, providers, decorators, guards, interceptors, pipes, DTOs with class-validator, exception filters, CQRS, repository patterns, and event-driven architecture to improve code quality and scalability.

Core Features & Use Cases

• Module organization and encapsulation: separates features into cohesive modules with clear boundaries.
• SRP-driven refactoring: splits large services into focused ones (e.g., AuthService, ProfileService).
• Pattern enforcement: ensures proper use of guards, interceptors, pipes, DTOs, error handling, and CQRS.
• Use Case: You have a monolithic NestJS app with a bloated User service; use this Skill to extract responsibilities into discrete modules and services, clean DTOs, and implement guards and interceptors for cross-cutting concerns.

Quick Start

Run a linted, rule-based refactor plan by applying the NestJS refactor guidelines to your codebase. Begin with identifying god services, then extract responsibilities into focused services and modules, update controllers to delegate to services, and implement DTOs, guards, interceptors, and CQRS as needed.