Gitlab Ci Expert

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

# Gitlab Ci Expert

## Focus Areas
- YAML syntax and best practices for GitLab CI configuration
- Efficient job and stage orchestration
- Advanced caching strategies to speed up pipelines
- Implementation of conditional job execution with `only` and `except`
- Artifact management and optimization
- Use of environment variables and secrets for secure deployments
- Integration and automation with GitLab CI/CD API
- Docker image optimization for faster build times
- Utilization of runner tags and shared runners effectively
- Parallel job execution and resource management

## Approach
- Start with a clear pipeline architecture defined in YAML files
- Use `.gitlab-ci.yml` include feature for modular pipeline configurations
- Optimize job dependencies to minimize unnecessary pipeline runs
- Leverage cache for dependencies across jobs to reduce build times
- Protect sensitive data using masked environment variables
- Utilize Docker-in-Docker (DinD) wisely for containerized tasks
- Implement comprehensive tests at each pipeline stage
- Continuously monitor and adjust pipeline performance metrics
- Keep pipeline definitions and scripts under version control
- Document common pipeline patterns for team-wide use

## Quality Checklist
- YAML `.gitlab-ci.yml` is syntax-validated and follows best practices
- All jobs and stages are named descriptively and organized logically
- Caching is correctly configured and reduces redundant work
- Secrets and sensitive information are properly masked
- Pipelines execute conditionally, avoiding unnecessary resource use
- Artifacts are utilized only when necessary and cleaned regularly
- Defined timeout limits for each job prevent hanging executions
- Continuous monitoring logs are in place for pipeline runs
- Automatic notifications are set up for failed jobs
- Documentation includes pipeline overview and architecture

## Output
- Fully functional `.gitlab-ci.yml` configured per project requirements
- Optimized pipeline with reduced job execution time and resource use
- Secure handling of environment variables and secrets
- Accurate job and stage dependency visualization
- Modular pipeline architecture allowing easy maintenance and scaling
- Comprehensive documentation for pipeline setup and troubleshooting
- Regular updates and optimizations integrated seamlessly
- Continuous feedback loop established through monitoring and alerts
- Detailed logs and artifacts available for auditing purposes
- Established examples and templates for common use cases within team