Ci cd pipeline
Use when designing, debugging, or fixing CI/CD pipelines — GitHub Actions, GitLab CI, JenkinsFrom its SKILL.md
npx -y skills add tspry/superpowers-devops --skill ci-cd-pipelineAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
2.3 KB, as published. Nobody here has run it
CI/CD Pipeline
Mode Detection
- Repo mode — templates in
tooling/ci/. Scaffold or modify pipeline configs. - Chat mode — user pastes pipeline config or failure logs. Diagnose and provide corrected config.
Pipeline Design Principles
- Fast feedback — lint and test before build; build before deploy
- Fail fast — stop the pipeline at the first failure
- Secrets via secret store — never hardcode credentials
- Idempotent deploys — running the same deploy twice should be safe
- Gate production — require passing tests before any production deploy
Standard Pipeline Stages
lint → test → build → push image → deploy staging → smoke test → deploy production
GitHub Actions
Debugging failures
# Enable debug logging by setting repository secret:
ACTIONS_STEP_DEBUG = true
ACTIONS_RUNNER_DEBUG = true
Common issues:
| Issue | Fix |
|---|---|
Context access might be invalid | Check secret/var name spelling |
Resource not accessible by integration | Add permissions: block to workflow |
Process completed with exit code 1 | Read that step's full log output |
| Workflow not triggering | Check on: trigger matches branch/event |
Useful patterns
# Run only on main branch
on:
push:
branches: [main]
# Matrix builds
strategy:
matrix:
node-version: [18, 20, 22]
# Reuse secrets
env:
DATABASE_URL: ${{ secrets.DATABASE_URL }}
GitLab CI
Common issues:
| Issue | Fix |
|---|---|
| Job stuck in pending | Check runner availability and tags |
artifacts not found in later stage | Define artifacts: in the producing job |
| Cache not working | Check cache: key is consistent |
Jenkins
Common issues:
| Issue | Fix |
|---|---|
| Build never starts | Check agent availability and labels |
| Credentials not found | Verify credential ID in Jenkins credentials store |
| Workspace dirty | Add cleanWs() at start of pipeline |
Tooling Templates
tooling/ci/github-actions/— reusable workflow templatestooling/ci/gitlab-ci/— .gitlab-ci.yml templatestooling/ci/jenkins/— Jenkinsfile templatestooling/ci/starters/— full CI/CD setups by stack