Workflows · Record and explain decisions
Why it was decided
The answer to "why did we decide this", with who decided, the reasons, what else was considered and the sources.
Have your agent do it
Fill in the parts in [square brackets], then paste this to your agent.
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.When to use it
- Someone asks why something is the way it is.
- You want the answer saved for the next person who asks.
What to name it
Why [topic], such as “Why a single-page menu”. Keep it that short; agents otherwise tend to write long, descriptive titles.
What it looks like
DocumentWhy a single-page menu
Used in
Related templates
For agents
- Fetch the template from
https://avalandra.com/help/template-files/decision-explainer. - 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
Why [topic], filled in, such as “Why a single-page menu”. 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.