# Decision record template

> One decision with its reason, who made it, its source and what it replaces.

Source: https://avalandra.com/help/templates/decision-record · Group: Record and explain decisions
Template file: https://avalandra.com/help/template-files/decision-record

## What to name it

Decision [topic], filled in, such as "Decision launch date". Keep it that short.

## 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.

## Have your agent do it

```text
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.
```

## Used in

- [What you can do with your agent](https://avalandra.com/help/what-your-agent-can-do#record-a-decision)
- [Update a decision when it changes](https://avalandra.com/help/update-a-decision-when-it-changes)
- [Follow up after a meeting](https://avalandra.com/help/follow-up-after-a-meeting#record-what-was-decided)

## Related templates

- [Why it was decided](https://avalandra.com/help/templates/decision-explainer.md): The answer to "why did we decide this", with who decided, the reasons, what else was considered and the sources.
- [Pruning review](https://avalandra.com/help/templates/pruning-review.md): Suggestions 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. Don't add a title or label inside the document; Avalandra shows its name above it. 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.
- Delete sections with nothing in them, link every claim to its source with web_url, create it with `ava document create` (kind html, source_format html, parent_id for the folder), and read `warnings` in the response.
- If the prompt still contains [square brackets], ask the person what goes there.
