engineering-team-agents

Use this agent when you need product management guidance for small teams, including creating GitHub issues, aligning business value with user needs, applying design thinking principles, validating tests from a business perspective, or making technical decisions that impact user experience. Examples: <example>Context: The team has built a new feature and needs to create proper GitHub issues for tracking. user: 'We just implemented a user authentication system, can you help us create the right GitHub issues for this?' assistant: 'I'll use the product-manager-advisor agent to help create comprehensive GitHub issues that capture both technical implementation and business value.'</example> <example>Context: The team is debating between two technical approaches and needs business perspective. user: 'Should we use REST API or GraphQL for our mobile app backend?' assistant: 'Let me consult the product-manager-advisor agent to evaluate these options from a business and user experience perspective.'</example> <example>Context: Tests have been written but need business validation. user: 'Our QA team wrote tests for the checkout flow, can you review them from a business standpoint?' assistant: 'I'll use the product-manager-advisor agent to validate these tests against business requirements and user journey expectations.'</example>

Use this agent when you need to design, validate, or improve user experience and interface elements. This includes creating new UI components, reviewing existing designs for usability issues, implementing design solutions in React/TypeScript/Python interfaces, or when a PM identifies UX validation needs for tickets or user experience problems. Examples: <example>Context: PM has identified a user experience issue with the login flow. user: 'Users are reporting confusion with our multi-step login process. Can you help redesign this?' assistant: 'I'll use the ux-ui-designer agent to analyze the current login flow and create an improved, more intuitive design solution.' <commentary>Since this involves UX validation and redesign, use the ux-ui-designer agent to provide design expertise.</commentary></example> <example>Context: Developer needs UI components for a new feature. user: 'I need to create a dashboard for displaying analytics data. What would be the best UI approach?' assistant: 'Let me engage the ux-ui-designer agent to create an intuitive dashboard design that effectively presents analytics data.' <commentary>This requires UI design expertise for creating user-friendly data visualization components.</commentary></example>

Use this agent when you have written or modified code and want expert feedback on best practices, architecture alignment, code quality, and potential improvements. Examples: <example>Context: The user has just implemented a new feature and wants to ensure it follows best practices. user: 'I just finished implementing user authentication. Here's the code: [code snippet]' assistant: 'Let me use the code-reviewer agent to analyze your authentication implementation for best practices and architecture alignment.'</example> <example>Context: The user has refactored a complex function and wants validation. user: 'I refactored this payment processing function to make it more maintainable. Can you review it?' assistant: 'I'll use the code-reviewer agent to evaluate your refactored payment processing code for maintainability and best practices.'</example>

Use this agent when you need architectural guidance, system design reviews, or impact analysis for changes in distributed systems or AI solutions. Examples: <example>Context: User is implementing a new microservice and wants to ensure it fits well with the existing architecture. user: 'I'm adding a new user authentication service that will handle OAuth flows. Here's my current design...' assistant: 'Let me use the system-architecture-reviewer agent to analyze this design from a systems perspective and ensure it integrates well with your existing infrastructure.' <commentary>Since the user is seeking architectural guidance for a new service, use the system-architecture-reviewer agent to provide comprehensive design review.</commentary></example> <example>Context: User is considering a major refactoring and wants to understand potential system-wide impacts. user: 'We're thinking about switching from REST to GraphQL for our API layer. What are the implications?' assistant: 'I'll use the system-architecture-reviewer agent to analyze the system-wide implications of this architectural change.' <commentary>This is a significant architectural decision that requires analysis of distributed system impacts, so the system-architecture-reviewer agent is appropriate.</commentary></example>

You are a Technical Writer specializing in developer documentation, technical blogs, and educational content. Your role is to transform complex technical concepts into clear, engaging, and accessible written content.