annsa_decide
Destructive
Record what a person decided. A person uses it to answer a question an agent raised or sign off a priority. As an agent you can list principles, propose one, approve or dismiss a proposed spec change, or pass on a person's exact words with person_words. To ask a person something, use annsa.work escalate instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | No | For principle: 'list', 'propose' (an agent's), or 'write', 'retire' and 'activate' (a person's). | |
| area | No | For scope=area: the part of the product the rule covers. | |
| take | No | For sign with do_this: the option you chose, in a few words. | |
| text | No | For direct or ask_back: the words. | |
| label | No | What to call this session, up to 60 characters. Shown as who did it. | |
| scope | No | How far the decision reaches: priority, area (needs area) or company. area or company also writes a principle. | |
| title | No | For principle: the rule's title. | |
| topic | No | For principle: what the rule is about. | |
| action | Yes | approve: Accept another writer's proposed section text, by update_id. dismiss: Turn down a proposed section text; the current text stays. answer: Record a person's answer to the open ask on a priority. An agent passes on the person's exact words with person_words. Picking an option labelled Merge, Ship it, Park it or Retract the ship runs it; free text is only recorded. ask_back: A person asks the agent a question back on a priority. A person's action. direct: A person gives the agent holding a priority a direction; the agent reads it on its next reply. A person's action. choose: Record a person's pick on a Needs you question (send disagreement_id). One option, or neither. A person's action. sign: Record a person's decision on a priority (do_this, do_nothing, park or dismiss), with because. A person's action. principle: Your decision memory. Agents can list principles or propose one; a person writes, retires or reactivates them. A proposal applies at once. | |
| answer | No | For choose: the option picked, or neither. For principle: the answer behind the rule. | |
| option | No | For answer: the option's label. | |
| person | No | The email or user id of the person whose words they are. | |
| because | No | For sign: why, in a sentence. | |
| decision | No | For sign: do_this, do_nothing, park or dismiss. | |
| wrong_if | No | For sign: what would show the decision was wrong. | |
| principle | No | For principle: the rule, in a sentence. | |
| ruled_out | No | Options you ruled out, one per entry as 'option — why'. | |
| update_id | No | For approve or dismiss: the proposed change, from annsa.spec's updates. | |
| may_decide | No | For sign: what the agent may decide on its own from here. Needs answered_by. | |
| supersedes | No | For principle: the principle this replaces. | |
| answered_by | No | The person who decided, when you're passing on their words. | |
| priority_id | No | The long id, instead of priority_number. | |
| person_words | No | The person's exact words, not a summary. Recorded as their quote. | |
| principle_id | No | For principle retire or activate: which one, from principle op=list. | |
| falsifier_due | No | For sign: when to check wrong_if, like 2026-12-31. | |
| while_waiting | No | For sign: what the agent may keep doing until the answer comes. | |
| decision_until | No | For sign: when this decision expires, like 2026-12-31. | |
| must_come_back | No | For sign: what the agent has to bring back to a person. | |
| disagreement_id | No | For choose: the id of the Needs you question, from the Needs you list. | |
| priority_number | No | The # number, e.g. 20 for #20. | |
| review_condition | No | For sign: when to look at this decision again, in a sentence. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| who | No | ||
| record | No | ||
| message | No | ||
| success | No |