CI/CD Pipeline Skill
This skill governs the design of resilient and efficient automation pipelines. It prioritizes local reproducibility and fast feedback loops.
Workflow: Pipeline Construction
- Interface with Makefile: Ensure every CI step corresponds to a
Makefiletarget. - Implement Fail-Fast: Order the jobs so that the fastest, most critical checks (linting) run first.
- Configure Matrix: Use matrix strategies for High-Performance Architecture (HPA) builds.
- Reference Best Practices: Adhere to the standards in references/best-practices.md.
Workflow: The "Verify-then-Publish" Gate
- Mandate: Before any remote repository push, the agent MUST run the local
make testormake cisuite. - Reporting: If a local check fails, stop and fix the issue before attempting to push.
Workflow: Infrastructure Simulation
- For complex deployments, use a two-tier simulation (e.g., Local Container -> Staging -> Prod) to verify environment-specific variables before final delivery.
Workflow: Error Recovery
- If
make testfails: Read the failure output, fix the issue, and re-run. Never skip or silence a failing test. - If
make ciis not defined: Create it as a target that runs lint, test, and build in sequence. - If matrix build fails for a single platform: Investigate platform-specific issues. Do not disable the failing platform without documenting the rationale.
Verification
Verify this skill produces correct pipeline configuration:
- Verify every CI step has a corresponding
maketarget. - Confirm fail-fast ordering: linting runs before tests, tests before builds.
- Confirm the pipeline includes a local
make testgate before any remote push step. - For matrix builds, confirm at least two platform variants are configured.
Source: pngdeity/ai-guidance-scaffolding — distributed by TomeVault.