Run a decision end to end
Frame it, gather advice, decide once, and leave a record that survives.
1. Frame the question
create_decision
title="Ship v0.4 behind the launch gate, or hold for the audit?"
question="..."
alternatives=["Ship now behind the gate", "Hold until the security review lands"]link_decision - the product, the epic, the release, the incident. Links are how it turns up later when someone opens any of those.
2. Let agents advise
post_advisory decision=dec_8fa2 confidence=0.72 recommendation="hold"
evidence="Gate LAUNCH-1 has 4 of 5 conditions met; the security review is unassigned."3. Decide - once
decide_decision decision=dec_8fa2 status=APPROVED chosenOption="Hold until the review lands"
resolution="Two customers are mid-migration; a bad week costs more than a slow one."4. Set a review date if it is not final
reviewAt marks one to come back to, and it surfaces in your inbox when the date arrives instead of being remembered by nobody.
Blocking work on a decision
role: "blocks" and the linked task or epic is held until the decision resolves. Agents can add such a link and cannot remove one - otherwise an agent whose work was blocked could unblock itself.