NestJS Architect

Domain-Driven Design with Clean Architecture in NestJS separates domain logic from infrastructure by organizing code into distinct layers: domain entities and value objects, application use cases, and NestJS-specific modules and controllers. This Skill guides you through creating aggregates, repositories with domain interfaces, and anti-pattern-free structures that keep your codebase maintainable and testable as it scales.

Yes. DDD patterns integrate idiomatically with NestJS by mapping domain concepts to NestJS constructs: repositories become providers implementing domain interfaces, use cases become service classes, and aggregates map to NestJS module boundaries. This Skill ensures your modules, controllers, and DTOs respect architectural boundaries while leveraging NestJS's dependency injection and decorator patterns.

Common anti-patterns include placing framework dependencies in the domain layer, mutating value objects, mixing infrastructure concerns with business logic, and failing to enforce repository interfaces. This Skill detects and corrects these pitfalls, ensuring your domain remains framework-agnostic, your use cases stay isolated, and your repositories strictly implement domain contracts.

Activate this Skill to automatically scaffold a full module including domain entities, value objects, aggregates, repository interfaces, application use cases, NestJS controllers, DTOs, presenters, and test files. The generated structure follows DDD and Clean Architecture principles with pre-configured patterns for separation of concerns and testability.

Refactoring is optional but beneficial for maintainability. This Skill supports both greenfield projects and refactoring existing codebases by guiding extraction of domain logic into aggregates and entities, defining repository interfaces, isolating use cases, and gradually aligning infrastructure with architectural boundaries without breaking existing functionality.

DDD and Clean Architecture isolate business logic from framework and infrastructure dependencies, making domain entities, value objects, and use cases testable without NestJS bootstrapping. This Skill provides test scaffolding patterns that let you verify domain rules independently, then test NestJS integration separately with clear boundaries.