Docs The app
Decisions
Decisions is a log of what was decided, in the words of the person who decided it. Agents can propose a decision; only a person can accept it. What was turned down stays easy to find, so nobody proposes it again by accident.
What a decision holds
| Field | Holds |
|---|---|
| Title | One line that names the decision |
| Words | What the person said, word for word |
| Decided by, on | Who decided it, and on which date |
| Status | Proposed, Accepted, Rejected, Parked or Done |
| Context, source | Why it came up, and where the words came from: a session, a message, a doc or something else |
| Tags | Free tags, for the filter |
| Supersedes | An earlier decision that this one replaces |
| Recorded by | Who wrote it down |
A decision belongs to a project, or to the whole workspace. A workspace-wide decision shows in every project, marked "Whole workspace".
Statuses
- Proposed. Recorded and waiting. It is a line in the Your turn of everyone who may decide.
- Accepted. A person who may decide agreed to it.
- Rejected and Parked. Declined, or left for later. Each has its own view, so what was declined is easy to check. A parked or rejected decision can be taken up again, to another of these statuses, but never back to Proposed.
- Done. An accepted decision that has been carried out.
Every change of status needs a person who may decide: an Owner, an Admin or a Reviewer. A row shows who did what, as in "recorded by X, accepted by Y".
Recording a decision
A person who may decide can record a decision directly. A Member can record one too; it waits as Proposed for someone who may decide.
An agent with decisions:propose records one with record_decision. Its decision is always Proposed, and it must say where the words came from. With a token that lists more than one project, it names the project, or records the decision for the whole workspace, which needs a workspace-wide token. An agent can never change a status.
Before proposing, an agent can call read_decisions with decisions:read. It returns matching decisions with their status and who set it, so an agent can tell a proposal from something a person accepted, and leave rejected and parked ideas alone.
Editing and superseding
While a decision is Proposed, its title, words, context, source, tags, who decided and the date can be edited by whoever recorded it or by a person who may decide. After that they are fixed.
A correction is a new decision that supersedes the earlier one. Only a person who may decide says that a decision supersedes another, when recording it or while it is Proposed. So a correction an agent proposed is linked to the decision it replaces by the person who accepts it. The earlier decision stays in the log, and is marked as replaced only when the new one is accepted.
The Decisions tab
A list, newest first, with a reading pane. The views are All, Proposed, Accepted, Done, Rejected and Parked, each with its count, with a tag filter and a text search. A row shows the title, the person's words in quotes, who decided and when, the status, and who recorded it. The pane has Accept, Reject and Park on a proposed decision, Mark done on an accepted one, and Edit while it is proposed, for whoever may use them.
The source of this page will be on GitHub when the repository opens. Something wrong or unclear? Write to us.