Research decisions

Use a document when you need to compare evidence and explain a decision. This example chooses a venue for a fictional community workshop.

Supply the evidence

Give your connected agent these fictional proposals:

Venue	Hire cost	Capacity	Confirmed access	Equipment
Cedar Hall	$180	24	Step-free	Tables included
River Room	$120	18	Step-free	Tables included
Orchard Studio	$160	25	Unconfirmed	Table hire costs $40

The workshop needs room for 20 people, step-free access, and tables. The venue budget is $200. Ask:

Use the supplied fictional proposals to create a durable Venue decision
document in the Community workshop Space. Reuse that document if it exists.
Compare the options against our requirements. Cite each proposal by name,
include equipment in the total, and distinguish confirmed details from
questions. Do not invent missing facts or contact anyone.

Review the result

Open the document. Check that Cedar Hall costs $180, River Room does not meet capacity, and Orchard Studio costs $200 with access still unconfirmed. The comparison should explain why an unresolved requirement affects the choice.

Annotate the recommendation:

Separate the preferred option from a confirmed booking. List what we
must confirm before committing.

Ask the agent to address that annotation. Review its revision, then Pin the document so it leads the Space.

Update the evidence

In a later session, provide a revised fictional Cedar Hall proposal: hire cost is now $220, with all other details unchanged. Ask the agent to find the existing decision, update the affected comparison, and explain whether its recommendation changes.

The revision should show Cedar Hall over budget, keep Orchard’s access question open, and avoid presenting any option as satisfying all confirmed requirements. Use document history to compare the change.

For a large set of sources that need separate fields and updates, consider a records collection. Three proposals do not require one.