Parameters
Why this was chosen over the alternatives. Optional, but decisions without
reasoning get re-litigated the first time someone disagrees.
org (default) writes to the shared team memory. agent keeps it private to
the identity in the X-Vex-Agent header. See Scope.Examples
Guidance
Always pass a rationale
Always pass a rationale
The decision tells the next agent what; the rationale tells it whether the
reasoning still holds. Circumstances change — an agent that can see why a
choice was made can tell when it should be revisited. One that only sees the
choice cannot.
Record decisions against, too
Record decisions against, too
“We considered X and chose not to” is worth as much as what you picked.
Without it, someone re-proposes X every quarter.
Contradictions supersede
Contradictions supersede
A newer decision that contradicts an older one retires it — the old one stops
surfacing in recall. You do not need to clean up first. See
What Klio keeps.