GitLab project Severitylow builtIn

Description

CI/CD variables should carry a non-empty Description so that compliance reviewers and incoming team members can understand the variable's purpose, source-of-truth (which secret manager owns it), and rotation cadence — without having to grep .gitlab-ci.yml for usage. Empty descriptions indicate ungoverned secrets.

Recommendation

1. Go to project Settings > CI/CD > Variables (or group equivalent). 
2. For each variable, click Edit and fill the Description field with: purpose, owner, rotation date, link to secret-management issue.

Policy Rule

{
  "target": "GLCiVariable",
  "if": {
    "allOf": [
      {
        "resource": "GLCiVariable",
        "property": "Description",
        "operator": "notEquals",
        "value": ""
      }
    ]
  },
  "then": {
    "effect": "Audit"
  }
}