Use this agent when designing user interfaces, optimizing user experience, or creating interaction patterns. Examples include:\n\n<example>\nContext: User is designing a new feature UI.\nuser: "I need to design the user interface for a patient appointment booking system"\nassistant: "I'm going to use the Task tool to launch the ui-ux-architect agent to design an intuitive, accessible appointment booking interface with optimal user experience."\n<commentary>UI/UX design requires expertise in user-centered design, information architecture, interaction patterns, and usability - perfect for ui-ux-architect.</commentary>\n</example>\n\n<example>\nContext: User has usability concerns.\nuser: "Users are finding our dashboard confusing and hard to navigate"\nassistant: "Let me use the ui-ux-architect agent to analyze the dashboard UX issues and redesign the information architecture and navigation."\n<commentary>UX problem-solving requires systematic analysis of user flows, mental models, and interaction design principles.</commentary>\n</example>\n\n<example>\nContext: User is creating a new design system.\nuser: "We need to establish design patterns and UI guidelines for our application"\nassistant: "I'm going to use the Task tool to launch the ui-ux-architect agent to create a comprehensive design system with patterns, components, and guidelines."\n<commentary>When design systems or UI patterns are needed, use the ui-ux-architect agent to provide expert guidance on consistency and user experience.</commentary>\n</example>

## Role

Use this agent when working with NestJS controllers, routing, request handling, and HTTP decorators. Examples include:\n\n<example>\nContext: User needs to create or modify NestJS controllers.\nuser: "I need to create REST API controllers with proper routing and request validation"\nassistant: "I'll use the Task tool to launch the nestjs-controllers-architect agent to design comprehensive NestJS controllers with proper routing, decorators, and request handling patterns."\n<commentary>Controller design requires deep knowledge of NestJS routing, HTTP decorators, request/response handling, and validation - perfect for nestjs-controllers-architect.</commentary>\n</example>\n\n<example>\nContext: User is implementing complex routing and middleware.\nuser: "How do I implement nested routes, custom decorators, and request interceptors in NestJS controllers?"\nassistant: "Let me use the nestjs-controllers-architect agent to implement advanced routing patterns and custom decorator solutions with proper middleware integration."\n<commentary>Advanced controller patterns require expertise in NestJS routing mechanics and decorator composition.</commentary>\n</example>\n\n<example>\nContext: User is working with file uploads and response handling.\nuser: "I need to handle file uploads, streaming responses, and custom headers in my NestJS controllers"\nassistant: "I'm going to use the Task tool to launch the nestjs-controllers-architect agent to implement file handling and advanced response manipulation in controllers."\n<commentary>When complex HTTP handling concerns arise, use the nestjs-controllers-architect agent to provide expert controller solutions.</commentary>\n</example>

Use this agent when creating, reviewing, or maintaining OpenAPI/Swagger API documentation specifications. Examples include:\n\n<example>\nContext: User needs to document their REST API.\nuser: "I need to create comprehensive Swagger/OpenAPI documentation for our REST API with all endpoints, schemas, and examples"\nassistant: "I'm going to use the Task tool to launch the swagger-api-documentation-architect agent to create complete OpenAPI 3.0 specification with detailed schemas, examples, and security definitions."\n<commentary>OpenAPI/Swagger documentation requires expertise in spec structure, schema definitions, security schemes, and best practices - perfect for swagger-api-documentation-architect.</commentary>\n</example>\n\n<example>\nContext: User has existing API code and needs documentation.\nuser: "I have 50 API endpoints already implemented. Can you generate proper Swagger documentation for them?"\nassistant: "Let me use the swagger-api-documentation-architect agent to analyze the endpoints and create comprehensive OpenAPI documentation with proper schemas, responses, and examples."\n<commentary>Generating OpenAPI specs from existing code requires systematic analysis and proper spec structure.</commentary>\n</example>\n\n<example>\nContext: User is experiencing Swagger validation errors.\nuser: "Our Swagger spec has validation errors and the UI isn't rendering properly"\nassistant: "I'm going to use the Task tool to launch the swagger-api-documentation-architect agent to debug the OpenAPI spec, fix validation errors, and ensure proper rendering."\n<commentary>When OpenAPI/Swagger specification issues arise, use the swagger-api-documentation-architect agent to provide expert debugging and optimization.</commentary>\n</example>