| description | Use when building cross-platform cloud automation scripts, Azure infrastructure orchestration, or CI/CD pipelines requiring PowerShell 7+ with modern .NET interop, idempotent operations, and enterprise-grade error handling. Specifically:\n\n<example>\nContext: Team needs to automate Azure VM lifecycle management across multiple subscriptions with proper logging and error recovery.\nuser: "Create PowerShell scripts to provision, configure, and decommission Azure VMs across 5 subscriptions. Need idempotent operations, comprehensive logging, and -WhatIf/-Confirm support for safety."\nassistant: "I'll build a PowerShell 7 automation suite using Az module with subscription context handling, implement idempotent patterns with resource existence checks, add structured logging via Write-Host/Error, support -WhatIf/-Confirm parameters for safety, and include error recovery with retry logic and proper authentication using Managed Identity."\n<commentary>\nUse powershell-7-expert for cloud automation requiring multi-tenant orchestration, subscription/tenant context management, and enterprise safety patterns like WhatIf support and comprehensive error handling. This agent handles Azure-specific patterns and modern .NET interop.\n</commentary>\n</example>\n\n<example>\nContext: Building GitHub Actions workflows that need cross-platform (Windows, Linux, macOS) CI/CD automation with complex orchestration logic.\nuser: "Set up GitHub Actions workflows using PowerShell that run on Windows, Linux, and macOS runners. Need to handle artifact management, environment-specific configurations, and integration with Azure DevOps."\nassistant: "I'll architect GitHub Actions workflows leveraging PowerShell 7's cross-platform capabilities: use $PSVersionTable and platform detection for environment-specific logic, implement artifact handling with consistent paths across OSes, create environment-specific config files, integrate Azure DevOps APIs via PowerShell SDK, and add comprehensive logging for CI/CD debugging."\n<commentary>\nUse powershell-7-expert when building CI/CD pipelines that require PowerShell's cross-platform capabilities and complex orchestration logic. This agent applies PowerShell 7 features like pipeline operators, null-coalescing, and modern exception handling for production-ready pipelines.\n</commentary>\n</example>\n\n<example>\nContext: Enterprise needs advanced M365/Graph API automation for user provisioning and Teams governance across complex organizational hierarchies.\nuser: "Implement PowerShell automation for Graph API to provision M365 users, set up Teams, manage group memberships, and enforce governance policies. Need performance optimization for large-scale operations (10k+ users)."\nassistant: "I'll build high-performance Graph API automation using PowerShell 7: parallelize user provisioning with ForEach-Object -Parallel, implement batch operations for efficiency, use .NET 6/7 HttpClient for Graph API calls, add comprehensive error handling with custom exception classes, cache authentication tokens, and implement retry logic with exponential backoff for reliability."\n<commentary>\nUse powershell-7-expert for enterprise M365/Graph automation requiring high performance, parallel processing, and modern .NET interop. This agent applies PowerShell 7 parallelism features and handles complex Graph API scenarios with proper rate limiting and batching.\n</commentary>\n</example> |
