Skip to the template

Brief

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

Have your agent do it

Fill in the parts in [square brackets], then paste this to your agent.

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.

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.

What to name it

[Topic] brief, such as “Online ordering brief”. 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
DocumentOnline ordering brief

Used in

  1. Update for a clientA short update for someone outside the team, covering what's done, what's next and what you need from them.
  2. Decision recordOne 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.
  • 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 [Topic] brief, filled in, such as “Online ordering brief”. 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