Use when designing CI/CD pipelines, GitHub Actions, or release automation. Trigger with CI/CD design request or pipeline task. Loaded by ai-maestro-architect-agent-main-agent
Design and configure CI/CD pipelines, GitHub Actions workflows, cross-platform builds, secret management, and release processes. Produces workflow YAML, configuration, and documentation -- never executes code directly.
gh) installed and authenticatedgh CLICopy this checklist and track your progress:
| Document | Content |
|---|---|
| github-actions.md | Use Cases (Quick Reference), Overview, Part 1: Workflow Basics and Runners, Part 2: Matrix Builds, Secrets, and Conditionals, Part 3: Reusable Workflows and Releases, Part 4: Debugging and Common Patterns, Quick Command Reference |
| cross-platform-builds.md | Use Cases (Quick Reference), Overview, Runner Matrix, Multi-Platform CI Workflow, Build Optimization, Checklist |
| secret-management.md | Use Cases (Quick Reference), Overview, Secret Hierarchy, Required Secrets by Platform, Using Secrets in Workflows, Security Best Practices, Debugging Secret Issues |
| tdd-enforcement.md | Use Cases (Quick Reference), Overview, Core Principles, Coverage Requirements, Complete TDD Workflow, Test Skipping Policy, Mutation Testing |
| release-automation.md | Use Cases (Quick Reference), Overview, Part Files, Release Pipeline Stages, Semantic Versioning, Version Bumping Automation, Changelog Generation |
| release-automation-part1-complete-workflow.md | Tag-Triggered Release |
| release-automation-part2-platform-publishing.md | Homebrew, Windows Store, Docker Hub, Debug Script |
| Issue | Cause | Fix |
|---|---|---|
| CI fails, local passes | Environment differences | Check env vars, dependency versions, path sensitivity |
| Workflow not triggering | YAML error or filter mismatch | Validate YAML, check filters, verify Actions enabled |
| Secrets unavailable | Scope or name mismatch | Verify exact name, correct scope, fork limits |
| Deployment timeout | Network or config issues | Increase timeout, check connectivity, verify creds |
Example: matrix: os: [ubuntu-latest, macos-latest, windows-latest]
| Output Type | Description |
|---|---|
| Workflow YAML | .github/workflows/ directory with CI/CD files |
| Secret Docs | Instructions for configuring secrets via gh CLI |
| Debug Scripts | Workflow validation and local debugging scripts |
| Release Checklist | Step-by-step release process guide |
See Reference Documents table above.