The evaluator applies one order every time
Precedence is exception, then rollout stage, then the rule action. An exception outranks a rollout stage, and a rollout stage outranks the rule action. The evaluator uses that order on every decision. A reader who remembers the sequence can say which layer wins when two of them disagree, without opening the table.
Slides and runbooks sometimes list another order because another order is easier to draw. The engine will not follow the slide. This explainer exists so the sentence used in a meeting is the sentence already implemented. If a facilitation note and the evaluator diverge, the note is the thing to correct. The evaluator is the claim.
An exception is the override the product will honour
An exception is the governed override. While it applies, it outranks both the rollout stage and the rule action. The viewer and enforcement follow it together, because they call one evaluator. When the exception stops applying, both return to the stage and the rule.
A side agreement that never becomes an exception outranks nothing. Editing the rule text to hide the same override is an edit, and it should be described as an edit, not as an exception that happens to live inside the rule. The value of the exception is that a later reader can see the override as an override. A buried edit denies that reader the object.
A rollout stage can lower force, and only force the rule already has
Each population sits on one of three rollout stages. Observe caps the rule’s action at log-only, warn caps it at warn-then-confirm, and enforce applies the rule’s action unchanged, up to hard-block. The stage may reduce how hard the rule bites for the population currently in that stage. It sits in the middle of the order. An active exception beats it. It beats the bare rule action.
The stage does not mint a new action. It cannot raise a log-only rule into a block, and it cannot step past an exception that still applies. When the action an operator wants is absent from the rule, the change belongs in a newly published version of the rule. Relabelling the stage, or hoping the viewer will draw a stronger action than the rule holds, leaves enforcement on the old force.
The rule action is the floor, taken from the snapshot
When no exception applies, and the rollout stage does not lower the outcome, the rule action is the decision. That action is the floor of the order. Log, warn, and block mean those actions. A gentler picture on a slide is not a fourth action the evaluator will discover.
The floor is the rule inside the compiled snapshot for this decision. A draft sitting in an editor does not participate. Publishing writes a version and moves the active pointer, and that pointer move is how a revised rule becomes the floor. Until the pointer moves, the previous floor is the one both the viewer and enforcement will name. Unpublished intent is not a layer of precedence.
Three callers, one engine, and a label on everything else
Dry-run, the effective-policy viewer, and enforcement are three callers of one engine. The order above lives inside the engine, so there is no display copy that can drift while enforcement does something else. Agreement between the callers is the property an evaluation can test. A change that touches only the viewer is a defect, because the viewer has no private policy of its own.
This precedence belongs to Platform Core, which is available for a POC evaluation. It does not begin to apply inside a design-partner direction merely because that direction appears in the same navigation. A coming-next observability count of destinations is not an action under this order. Where a screen shows such a count, the count keeps the coming-next label and stays out of the precedence sentence.
How to read this
| Read it as | Which means | Do not read it as |
|---|---|---|
| 1. Exception | Outranks the stage and the rule | A side conversation |
| 2. Rollout stage | Can lower the rule’s force | A new action the rule does not have |
| 3. Rule action | What remains when nothing above applies | Whatever the viewer finds easier to draw |