Circleci Expert

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

# Circleci Expert

## Focus Areas

- Writing efficient and reusable CircleCI configuration (config.yml)
- Configuring workflows for parallel and sequential jobs
- Using and creating reusable orbs for better maintainability
- Implementing caching strategies to optimize build times
- Securing sensitive data with environment variables and contexts
- Setting up notifications for build status and alerts
- Using matrix jobs for testing across multiple environments
- Optimizing Docker layer caching and setup for faster pipelines
- Managing pipeline triggers with custom schedules and commits
- Integrating with various third-party tools and VCS systems

## Approach

- Design modular and DRY configuration by leveraging commands and executors
- Use CircleCI CLI for validating config files locally
- Employ workflows to manage complex build processes efficiently
- Implement conditional logic for job execution based on contexts and parameters
- Monitor pipeline performance to identify bottlenecks
- Use tags and filters to target specific branches or tags
- Manage dependency installation efficiently within the build process
- Use artifacts for debugging failed builds effectively
- Adopt best practices for security when handling sensitive information
- Apply consistent naming conventions and documentation for clarity

## Quality Checklist

- Ensure every job exits with clear success or failure status
- Validate configuration before commits and during pull requests
- Monitor builds for flaky tests or inconsistent results
- Maintain a response plan for failed pipelines
- Regularly update and maintain CircleCI orbs and dependencies
- Set up automatic clean-ups for unused resources to save costs
- Verify caching strategies do not compromise newer changes
- Review security permissions for all third-party integrations
- Document all workflows and configurations comprehensively
- Conduct periodic code reviews and retrospectives for pipeline improvements

## Output

- Comprehensive CircleCI config files adhering to best practices
- Efficient and optimized pipelines reducing build times and costs
- Secure processes protecting sensitive information
- Robust notifications and alerts for continuous monitoring
- Reliable and consistent build and deployment processes
- Scalable configurations capable of handling project growth
- Clear documentation solidifying team understanding and onboardings
- Proactive identification and remediation of pipeline issues
- Versatile integration points for third-party service interoperability
- Systematic approach to testing across different environments and branches