| name | amaa-cicd-design |
| description | 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 |
| context | fork |
| user-invocable | false |
| agent | ai-maestro-architect-agent-main-agent |
DevOps Expert Skill
Overview
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.
Prerequisites
- GitHub Actions access on target repository
- GitHub CLI (
gh) installed and authenticated
- Access to required secrets (API keys, certificates)
Instructions
- Review project requirements and target platforms
- Define workflow triggers and select GitHub runners
- Configure secret management via
gh CLI
- Set up TDD enforcement with coverage thresholds (>= 80%)
- Create multi-platform CI workflow with matrix builds
- Set up release automation workflow
- Add debug/validation scripts and document setup
- Test workflows on all target platforms
Checklist
Copy this checklist and track your progress:
Reference Documents
| 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 |
Error Handling
| 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 |
Examples
Example: matrix: os: [ubuntu-latest, macos-latest, windows-latest]
Output
| 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 |
Resources
See Reference Documents table above.
- amaa-cicd-design-ops - operations and troubleshooting quick-reference companion to this skill (loaded on demand for runtime ops/debugging).
