TypeScript Plugin Agents Guide

This guide provides comprehensive documentation for all TypeScript, JavaScript, NestJS, React, and React Native specialized agents available in the Developer Kit TypeScript Plugin.

---

Table of Contents

1. Overview
2. NestJS Backend Development Agents
3. React Frontend Development Agents
4. TypeScript Development Agents
5. React Native Development Agents
6. Agent Usage Guidelines
7. See Also

---

Overview

The TypeScript Plugin provides specialized agents for TypeScript/JavaScript development with focus on NestJS backend, React frontend, and React Native mobile development. These agents have deep expertise in their respective frameworks and can help with development, code review, security, testing, and architecture.

Available Agents

• NestJS Agents: 6 specialized agents for NestJS backend development
• React Agents: 2 specialized agents for React frontend development
• TypeScript Agents: 4 specialized agents for general TypeScript development
• React Native Agents: 1 specialized agent for React Native mobile development

---

NestJS Backend Development Agents

nestjs-backend-development-expert

File: agents/nestjs-backend-development-expert.md

Purpose: NestJS backend development specialist for building production-ready Node.js applications.

When to use:

• Building new NestJS features
• Implementing NestJS modules, controllers, services
• Working with NestJS dependency injection
• Implementing NestJS middleware, guards, interceptors
• NestJS configuration and environment setup

Key Capabilities:

• Module organization and structure
• Controller and service pattern implementation
• Dependency injection with NestJS
• Middleware, guards, interceptors, pipes
• NestJS configuration management

---

nestjs-code-review-expert

File: agents/nestjs-code-review-expert.md

Purpose: NestJS code quality and best practices review with framework-specific patterns.

When to use:

• Reviewing NestJS code before commits
• Ensuring NestJS best practices compliance
• Identifying framework-specific anti-patterns
• Validating module design and dependencies
• Reviewing NestJS integration code

Key Capabilities:

• NestJS specific code quality assessment
• Framework pattern validation (modules, controllers, services)
• Dependency injection review
• NestJS decorator usage validation
• Framework-specific best practices

---

nestjs-database-expert

File: agents/nestjs-database-expert.md

Purpose: NestJS database integration and ORM patterns specialist.

When to use:

• Integrating databases with NestJS (TypeORM, Prisma, Mongoose)
• Designing database schemas and models
• Implementing repository patterns
• Database migration planning
• Optimizing database queries

Key Capabilities:

• ORM integration (TypeORM, Prisma, Mongoose)
• Repository pattern implementation
• Database schema design
• Migration planning and execution
• Query optimization

---

nestjs-security-expert

File: agents/nestjs-security-expert.md

Purpose: NestJS security implementation specialist covering authentication, authorization, and OWASP.

When to use:

• Implementing authentication and authorization
• Securing NestJS endpoints
• Reviewing NestJS security configurations
• Implementing guards and decorators
• OWASP compliance for NestJS

Key Capabilities:

• Authentication strategy implementation (JWT, sessions)
• Authorization guards and decorators
• Security configuration review
• OWASP vulnerability prevention
• Best practices for secure NestJS apps

---

nestjs-testing-expert

File: agents/nestjs-testing-expert.md

Purpose: NestJS testing strategies for comprehensive test coverage of backend applications.

When to use:

• Writing unit tests for NestJS modules
• Designing e2e testing strategies
• Testing NestJS controllers and services
• Mocking dependencies in NestJS tests
• Testing NestJS middleware and guards

Key Capabilities:

• Unit testing for NestJS components
• E2E testing with NestJS test utilities
• Mocking strategies for dependencies
• Test coverage optimization
• Testing NestJS-specific features

---

nestjs-unit-testing-expert

File: agents/nestjs-unit-testing-expert.md

Purpose: NestJS unit testing best practices with Jest and testing utilities.

When to use:

• Writing focused unit tests for NestJS
• Testing NestJS providers and services
• Mocking NestJS dependencies
• Testing NestJS controllers in isolation
• Achieving high test coverage

Key Capabilities:

• Jest-based unit testing for NestJS
• Provider and service testing
• Controller testing in isolation
• Mock testing strategies
• Test coverage optimization

---

React Frontend Development Agents

react-frontend-development-expert

File: agents/react-frontend-development-expert.md

Purpose: React frontend development specialist for building modern web applications.

When to use:

• Building new React features
• Implementing React components and hooks
• Working with React state management
• Integrating with APIs and backend services
• React performance optimization

Key Capabilities:

• Component design and implementation
• React Hooks patterns and best practices
• State management (Context, Redux, Zustand)
• API integration and data fetching
• Performance optimization

---

react-software-architect-review

File: agents/react-software-architect-review.md

Purpose: React architecture design review focusing on component structure, state management, and scalability.

When to use:

• Reviewing React application architecture
• Evaluating component design patterns
• Assessing state management strategy
• Planning React refactoring efforts
• Validating architectural decisions

Key Capabilities:

• Component architecture review
• State management assessment
• Design pattern evaluation
• Scalability and performance review
• Refactoring recommendations

---

TypeScript Development Agents

typescript-refactor-expert

File: agents/typescript-refactor-expert.md

Purpose: TypeScript code refactoring with clean code principles, type safety, and TypeScript best practices.

When to use:

• Refactoring TypeScript code
• Improving type safety
• Applying TypeScript-specific patterns
• Reducing code complexity
• Migrating JavaScript to TypeScript

Key Capabilities:

• TypeScript type system optimization
• Clean code principles for TypeScript
• Design pattern implementation
• Code complexity reduction
• TypeScript to JavaScript migration

---

typescript-security-expert

File: agents/typescript-security-expert.md

Purpose: TypeScript security vulnerability assessment covering OWASP, XSS, CSRF, and dependency vulnerabilities.

When to use:

• Security auditing TypeScript applications
• Identifying frontend security issues
• Reviewing authentication implementation
• Checking for XSS and CSRF vulnerabilities
• Validating cryptographic practices

Key Capabilities:

• OWASP vulnerability detection
• XSS and CSRF prevention
• Authentication and authorization review
• Dependency vulnerability scanning
• Secure coding practices for TypeScript

---

typescript-software-architect-review

File: agents/typescript-software-architect-review.md

Purpose: TypeScript architecture design review focusing on patterns, type safety, and architectural decisions.

When to use:

• Reviewing TypeScript application architecture
• Evaluating type system design
• Assessing scalability and modularity
• Validating architectural decisions
• Planning TypeScript refactoring

Key Capabilities:

• TypeScript architecture patterns
• Type system design review
• Module organization assessment
• Scalability evaluation
• Architectural decision validation

---

typescript-documentation-expert

File: agents/typescript-documentation-expert.md

Purpose: TypeScript documentation generation for APIs, components, and technical manuals.

When to use:

• Generating API documentation from TypeScript code
• Creating component documentation
• Writing technical guides
• Documenting type definitions
• Creating user manuals

Key Capabilities:

• API documentation from TypeScript types
• Component documentation generation
• Type definition documentation
• Technical manual writing
• JSDoc and TSDoc generation

---

React Native Development Agents

expo-react-native-development-expert

File: agents/expo-react-native-development-expert.md

Purpose: React Native mobile development specialist with Expo for building iOS and Android applications.

When to use:

• Building React Native apps with Expo
• Implementing mobile-specific features
• Working with React Native components
• Integrating device APIs (camera, location, etc.)
• Mobile app deployment and publishing

Key Capabilities:

• Expo development workflow
• React Native component implementation
• Device API integration
• Mobile-specific UI/UX patterns
• App deployment to stores

---

Agent Usage Guidelines

When to Use TypeScript Plugin Agents

TypeScript Plugin agents are most effective for:

• NestJS Development: Building backend services, REST APIs, GraphQL APIs
• React Development: Building frontend applications, SPAs, PWAs
• React Native: Building mobile applications with Expo
• Code Quality: Reviewing and refactoring TypeScript code
• Security: Auditing TypeScript applications for vulnerabilities
• Architecture: Designing and reviewing TypeScript application architecture

How to Invoke Agents

Agents can be invoked in several ways:

1. Automatic Selection: Claude automatically selects the appropriate agent based on task context
2. Direct Invocation: Use agent name in conversation (e.g., "Ask the nestjs-backend-development-expert...")
3. Tool Selection: When using the Task tool, specify the subagent_type parameter

Agent Selection Guide

---

See Also

• TypeScript Commands Guide - TypeScript plugin commands
• NestJS Skills Guide - NestJS framework skills
• Frontend Skills Guide - React, TypeScript, UI skills
• Core Agent Guide - All agents across plugins