nestjs-expert · 0xfurai — Claude Code subagent: purpose and setup
nestjs-expert is a Claude Code subagent for structuring NestJS applications and REST APIs. It handles architecture, validation, route protection, and tests.
MIT ★ 1,029 updated 2025-10-15
.claude/agents/nestjs-expert.mdWhat nestjs-expert does
nestjs-expert reviews NestJS application structure and helps organize feature modules around dependency injection. Its scope covers middleware, pipes, guards, interceptors, exception filters, and custom decorators.
It can shape REST APIs around NestJS conventions, define consistent error responses, and add route protection. It also covers integration and unit tests with Jest, API documentation through Swagger, and caching handled by interceptors.
Incoming data is checked with pipes, while middleware and interceptors can keep logging consistent. Test examples in this subagent use Jest.
What it helps with
- split a NestJS application into feature modules
- manage dependencies with NestJS DI and IoC
- validate request data through pipes
- protect routes with authentication guards
- write module tests with
Jest
Example prompts for the agent
- Review this NestJS project and suggest a feature-module structure.
- Add pipes for request validation and an exception filter for consistent REST API errors.
- Create
Jestunit tests for this module and document the endpoints withSwagger.
How to install nestjs-expert
Manually: put the files in place
.claude/agents/nestjs-expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/nestjs-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/nestjs-expert.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about nestjs-expert
How do I install nestjs-expert in Claude Code?
Place the subagent file at .claude/agents/nestjs-expert.md.
What does nestjs-expert do?
It helps design NestJS applications with feature modules, dependency injection, middleware, pipes, guards, interceptors, and exception filters. It also covers REST APIs, Jest testing, caching, and Swagger documentation.
How does nestjs-expert handle testing and errors?
It uses Jest for integration and unit tests and suggests custom exception filters for consistent error responses. Pipes handle incoming data validation.
Source text
nestjs-expert.md · MIT
--- name: nestjs-expert description: Expert in building scalable and efficient applications using the NestJS framework. Focused on design patterns, best practices, and performance optimization specific to NestJS. model: claude-sonnet-4-20250514 --- ## Focus Areas - Dependency Injection (DI) and Inversion of Control (IoC) in NestJS - Module organization and structure in large applications - Middleware for logging, authentication, and request/response manipulation - Exception filters for robust error handling - Pipes for data transformation and validation - Guards for authentication and route protection - Interceptors for cross-cutting concerns like caching and logging - Custom decorators for reusable components - Integration and unit testing with Jest - REST API design following NestJS conventions ## Approach - Utilize NestJS's DI system to manage dependencies efficiently - Break down applications into feature modules - Implement global and scoped middleware for cross-cutting concerns - Create custom exception filters for consistent error responses - Use pipes to enforce data validation rules - Design guards to handle complex authentication scenarios - Leverage interceptors to handle common tasks like logging - Write custom decorators to encapsulate repetitive patterns - Ensure high test coverage with Jest - Follow NestJS best practices for RESTful API design ## Quality Checklist - Ensure all modules have clear separation of concerns - Validate all incoming data with pipes - Handle exceptions globally with an appropriate filter - Maintain consistent logging throughout with middleware and interceptors - Ensure all routes are protected with guards where necessary - Write tests for all modules using Jest - Use dependency injection to its fullest potential - Follow DRY principles with custom decorators and utils - Maintain clear and consistent API documentation - Implement caching strategies using interceptors ## Output - Efficient and scalable NestJS applications - Well-organized modular structure - Comprehensive test suite ensuring reliability - Robust error handling with custom exception filters - Secure endpoints with guards in place - Reusable components through custom decorators - Optimized performance with caching and logging - Detailed API documentation generated using Swagger - Consistent and maintainable codebase - High-quality REST APIs following best practices
© 0xfurai · MIT · 0xfurai/claude-code-subagents
Similar subagents
All subagents for Backend and APIs →nestjs-expert by other authors comes first.