Parameters
string
required
The decision that was made.
string
Why this was chosen over the alternatives. Optional, but decisions without
reasoning get re-litigated the first time someone disagrees.
'org' | 'agent'
default:"org"
org (default) writes to the shared team memory. agent keeps it private to
the identity in the X-Vex-Agent header. See Scope.string
Optional space slug. Omit to write to the org’s default store.
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.