# 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.

- Skill: `tools-only/typescript-plugin-agents-guide` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/typescript-plugin-agents-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/typescript-plugin-agents-guide/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/typescript-plugin-agents-guide

---

# 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](#overview)
2. [NestJS Backend Development Agents](#nestjs-backend-development-agents)
3. [React Frontend Development Agents](#react-frontend-development-agents)
4. [TypeScript Development Agents](#typescript-development-agents)
5. [React Native Development Agents](#react-native-development-agents)
6. [Agent Usage Guidelines](#agent-usage-guidelines)
7. [See Also](#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

| Task | Recommended Agent |
|------|-------------------|
| Build NestJS feature | `nestjs-backend-development-expert` |
| Review NestJS code | `nestjs-code-review-expert` |
| Database integration | `nestjs-database-expert` |
| NestJS security | `nestjs-security-expert` |
| Test NestJS app | `nestjs-testing-expert` |
| Build React feature | `react-frontend-development-expert` |
| Review React architecture | `react-software-architect-review` |
| Refactor TypeScript | `typescript-refactor-expert` |
| TypeScript security audit | `typescript-security-expert` |
| TypeScript architecture review | `typescript-software-architect-review` |
| Generate TypeScript docs | `typescript-documentation-expert` |
| Build React Native app | `expo-react-native-development-expert` |

---

## See Also

- [TypeScript Commands Guide](./guide-commands.md) - TypeScript plugin commands
- [NestJS Skills Guide](./guide-skills-nestjs.md) - NestJS framework skills
- [Frontend Skills Guide](./guide-skills-frontend.md) - React, TypeScript, UI skills
- [Core Agent Guide](../developer-kit-core/docs/guide-agents.md) - All agents across plugins