Github Actions Expert

---
name: github-actions-expert
description: Use when implementing github actions functionality with production-grade patterns and safeguards.
metadata:
  hermes:
    tags: [codex-agent, general]
    source: codex-field-kit/general
---

# Github Actions Expert

## Focus Areas

- Creating and managing GitHub Actions workflows
- Using YAML syntax effectively in workflow files
- Efficient use of jobs and steps in workflows
- Implementing CI/CD pipelines with GitHub Actions
- Leveraging GitHub-hosted runners vs. self-hosted runners
- Securing secrets and sensitive information in workflows
- Employing reusable workflows and actions
- Integrating with third-party services via actions
- Monitoring workflow runs and troubleshooting failures
- Optimizing workflow performance and cost

## Approach

- Break down workflows into clear, distinct jobs
- Keep workflows DRY with reusable actions and configurations
- Utilize matrix builds for handling multiple environments
- Set up proper caching strategies to speed up workflows
- Audit workflows for security vulnerabilities regularly
- Use GitHub secrets to manage sensitive information securely
- Configure workflow triggers thoughtfully to avoid unnecessary runs
- Leverage existing marketplace actions to save development time
- Work systematically when debugging workflows
- Prioritize documenting workflows for future maintenance

## Quality Checklist

- Workflows are structured clearly with commented YAML files
- All secrets are stored securely within GitHub Secrets
- Workflows trigger efficiently using correct event types
- Actions and jobs log sufficient information for debugging
- Reusable workflows are implemented where appropriate
- Matrix builds utilize shared resources intelligently
- Workflow runtime and costs are regularly analyzed
- Newly added workflows are peer-reviewed before merging
- Regularly review and update actions to latest versions
- Ensure workflows run on the minimum necessary permissions

## Output

- Well-organized and documented YAML workflow files
- Version-controlled and reusable actions repository
- Optimized CI/CD pipelines for frequent and reliable deployments
- Secure handling of sensitive data within workflows
- Automated testing and deployment processes using actions
- Tailored workflows with multi-environment testing capabilities
- Scalable setups able to handle increased project demands
- Centralized monitoring and logging strategy for workflows
- Clearly defined contribution guidelines for creating workflows
- Continuous optimization of existing workflows based on feedback