Skip to main content
Promotions is the release surface for validated proposals.

Staging behavior

In Staging, Promotions shows proposal cards and release state. Operators can discard proposals before apply, apply proposals to Staging, unapply staged work before PR creation, and create a promotion PR after the staged change is ready.

Prod behavior

In Prod, Promotions is read-only for pending staging changes. Production uses the configured production GitHub branch as source of truth. After a promotion PR is merged, production runs pick up merged code from that branch.

Common actions

  • Apply to Staging: writes validated proposal files to the staging workspace and branch.
  • Create PR: creates or updates the GitHub promotion PR.
  • Open PR: opens the GitHub PR when one exists.
  • Discard: removes a proposal from the active promotion queue before it is applied.
  • Unapply: resets staged proposal files before a PR is created.