# Why it was decided template

> The answer to "why did we decide this", with who decided, the reasons, what else was considered and the sources.

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

## What to name it

Why [topic], filled in, such as "Why a single-page menu". Keep it that short.

## When to use it

- Someone asks why something is the way it is.
- You want the answer saved for the next person who asks.

## Have your agent do it

```text
Why did we decide [the decision you're asking about]? Look in the [name of your Space] Space, tell me who decided and when, and link me to where it was decided. Save the answer using the template at https://avalandra.com/help/template-files/decision-explainer. Name it "Why" followed by a topic of a few words, and nothing longer.
```

## Used in

- [What you can do with your agent](https://avalandra.com/help/what-your-agent-can-do#ask-about-a-decision)

## Related templates

- [Decision record](https://avalandra.com/help/templates/decision-record.md): One decision with its reason, who made it, its source and what it replaces.

## For agents

- Fetch the template from https://avalandra.com/help/template-files/decision-explainer. 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.
