Promotion path
Promote it yourself. Keep every rule.
Developers move work from dev to staging to production without asking the platform team. The gates that team set run on every step.
The real cost
Every promotion is still a ticket
Getting a tested build into the next environment usually means asking the platform team, who check it, redeploy it and close the ticket. Multiply that by every service and every stage, and your platform team spends its week as a release desk.
Developers wait at every stage
A build that passed QA on Tuesday reaches staging when someone has time, not when it’s ready.
The platform team repeats itself
The same checks, run by hand, for every promotion of every service.
Production strays from staging
A redeploy by hand is a chance to type a different value than the one staging proved.
One platform, three views
What a promotion path changes for each team
Set the rules once
The problem
You’re the gate between every environment.
With Cycloid
Promotion policies at tenant, team or Blueprint level, checked on the source before anything reaches the next stage.
The outcome
You design the path. You don’t walk everyone down it.
Push your own build forward
The problem
A tested build waits for someone else to move it.
With Cycloid
Press Promote to staging. If a gate fails, it tells you which one.
The outcome
Your pace, inside the rules.
How it works
From Promote to staging to running in production
01 · Press promote
Promote to staging is a button on the deployed resource. The platform checks the gates before it opens anything.
02 · The gates run on the source
Soak time, required earlier stages, an approval, a scorecard level such as Silver, a Blueprint version. A failed gate names itself.
03 · The wizard opens prefilled
The first arrival creates a new resource in the target environment. After that, promotion updates the existing one in place, environment fields untouched.
04 · Rules stack, never relax
Tenant sets the floor. Teams and Blueprints can add gates, never remove one.
05 · Compose it, promote it as one
A composition built from slots in the catalog promotes as a unit, and every child passes every gate.
Promotion is opt-in, set at tenant or team level. Dev to staging can promote itself once the gates pass. A hotfix can skip the gates only for people holding the bypass permission, and the bypass is logged. It never applies to a first deployment, which always starts at the first stage.
The short version
The rules a promotion follows
3
levels a promotion rule can be set at
0
ways a narrower rule can relax a wider one
1
unit a composition promotes as
1st
stage every new deployment enters, bypass or not
Promote checkout-api to staging.

One gate failed. It’ll pass once the scorecard reaches Silver.
Promotion · checkout-api, dev to staging
1 gate failed
Soak time
Passed
Approval
Not required
Scorecard, Silver or above
Bronze today
Working with your assistant
Ask what's blocking staging, get the gate that failed
Does the assistant get its own permissions?
No. There’s no service account and no elevated assistant role. If you can’t deploy to production, neither can the assistant you’re talking to, in Cycloid’s own assistant or any compliant MCP host.
Ask your assistant to promote checkout to staging and it starts the same promotion as the button. Same gates, same wizard, acting as you.
If the scorecard gate fails, that’s the answer you get, named. Your assistant can’t skip a gate you couldn’t skip yourself.
Frequently asked questions
No. The first promotion into an environment creates a new resource there from the same pinned Blueprint version. Later promotions update that target in place, so its environment settings stay as they are.
Only for people holding the promotion bypass permission. The bypass is audit-logged, and it never applies to a first deployment, which always enters the chain at its first stage.
The chain follows the environment types you have. Two stages make a shorter path, and when you add staging later you update the policy to include it. Nothing else in the chain has to change.
Yes, from a composition. The deployer fills the slots the author allowed, each child needs its own use permission, and the whole composition then promotes through the chain as one unit.
Bring the release that always needs a ticket
Twenty minutes and the path from dev to production your team walks by hand today. We’ll set it up as a promotion policy and show you a gate refusing a build that isn’t ready.