Workflows · Record and explain decisions
Decision record
One decision with its reason, who made it, its source and what it replaces.
Have your agent do it
Fill in the parts in [square brackets], then paste this to your agent.
Record a decision in the [name of your Space] Space: [what was decided], because [the reason]. Link it to [where it was decided]. Use the template at https://avalandra.com/help/template-files/decision-record. Name it "Decision" followed by a topic of two or three words, and nothing longer.When to use it
- A decision is made, in a meeting or anywhere else.
- A decision changes and the old one needs marking as replaced.
What to name it
Decision [topic], such as “Decision launch date”. Keep it that short; agents otherwise tend to write long, descriptive titles.
What it looks like
DocumentDecision launch date
Used in
Related templates
- Why it was decidedThe answer to "why did we decide this", with who decided, the reasons, what else was considered and the sources.
- Pruning reviewSuggestions for pruning a Space, grouped by what to do, with the evidence and reason for each. Nothing changes until you decide.
For agents
- Fetch the template from
https://avalandra.com/help/template-files/decision-record. - Keep its
<style>blocks and class names. Replace every piece of sample content with content from the record, and never carry over its names, Spaces, documents or dates. - Title the document
Decision [topic], filled in, such as “Decision launch date”. No longer, descriptive titles, and no title or label repeated inside the document: Avalandra shows the name above it. - Delete sections with nothing in them, and link every claim to its source with web_url.
- Create it with
ava document create(kind html, source_format html, and a parent_id for the folder), then readwarningsin the response for anything the renderer removed. - If the prompt still contains [square brackets], ask the person what goes there.