Evidence kitevidence-folder-template/03-cicd-change-management/README.md
CI/CD & change management
CI/CD and change management
Evidence that production code changes are reviewed, approved, and traceable.
Evidence that code changes to production go through review, approval, and leave an audit trail. SOC 2 CC8.1 territory; customer security questionnaires ask for this routinely.
What goes here
- Branch protection configuration (the rule that gates the production branch)
- Deploy approval configuration (GitHub Environments or equivalent)
- Release evidence — last 30 production deploys with author and approver
- Rollback procedure documentation
Owner
Engineering leads typically own the policy; Platform owns the CI/CD plumbing.
Common gotchas
- Required reviews can be bypassed by admins. Set "Do not allow bypassing the above settings" on GitHub branch protection — admins included.
- Stale CODEOWNERS file. Reviewers listed who left the company. Audit quarterly.
- Production deploys from forks. Without explicit environment protection, a fork PR can run production-context workflows. Use GitHub Environments + restrict secrets to the production environment.
- Approval by author. "Required PR review" should disallow approving your own PR. Confirm in the rule.
Cross-references
- Controls map: rows 3.1 – 3.5 in
../../controls-map.md - Platform guide for GitHub:
../../platforms/github.md - Questionnaire answers: questions 6-7 in
../../questionnaire-answer-examples.md