# Brief template

> A new working document, such as a brief, spec or plan, written from what's in the Space.

Source: https://avalandra.com/help/templates/brief · Group: Write and share
Template file: https://avalandra.com/help/template-files/brief

## What to name it

[Topic] brief, filled in, such as "Online ordering brief". Keep it that short.

## When to use it

- You're starting a piece of work and want what's known in one place.
- A plan needs writing up for others to review.

## Have your agent do it

```text
Write a one-page brief for [what it's about] from what's in the [name of your Space] Space, and put it in the [folder name] folder. Use the template at https://avalandra.com/help/template-files/brief, and tell me the link when it's done. Name it with a topic of two or three words followed by "brief", and nothing longer.
```

## Used in

- [What you can do with your agent](https://avalandra.com/help/what-your-agent-can-do#write-and-update-documents)

## Related templates

- [Update for a client](https://avalandra.com/help/templates/client-update.md): A short update for someone outside the team, covering what's done, what's next and what you need from them.
- [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/brief. 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.
