Skip to the template

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

Filled with sample contentOpen the file on its own
DocumentDecision launch date

Used in

  1. Why it was decidedThe answer to "why did we decide this", with who decided, the reasons, what else was considered and the sources.
  2. 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 read warnings in the response for anything the renderer removed.
  • If the prompt still contains [square brackets], ask the person what goes there.
Support