> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitagents.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# How to promote a note to a decision

> Turn a useful agent finding into a standing instruction.

Sometimes an agent files an exploratory note that's actually a rule worth keeping. Promoting it turns a one-off observation into a [decision](/concepts/decisions) every agent follows.

## Steps

1. Find the note in your [Inbox](/use/process-inbox) or [Vault](/use/search-vault).
2. Open it and click **Promote to Decision**.
3. Rewrite the content as a clear, imperative directive if needed: a note that says *"clients seem to prefer annual billing"* becomes a decision *"Default to annual billing in proposals."*
4. Set the **scope** — which agents it binds.
5. Save. It's now a standing instruction read on every relevant run.

## When to promote

* A note captures a pattern you want enforced going forward.
* An agent discovered a constraint that should apply to all agents.
* You keep manually repeating the same correction — promote it once and stop repeating it.

<Card title="File as authoritative instead" icon="crown" href="/use/file-authoritative">
  For facts (not actions), promote to ground-truth Knowledge.
</Card>