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

# Using prompts in sessions

> Run saved prompt templates against the current entity with one click.

If you've saved a [prompt template](/platform-guide/prompt-templates) on the Prompts page, you can run it against any entity from inside a Deep Dive session without copy-paste.

## The `/run-prompt` flow

<Steps>
  <Step title="Open or create a session">
    Open a session for the obligor or CUSIP you want to analyse.
  </Step>

  <Step title="Scope the documents">
    Adjust the [document filter bar](/platform-guide/deep-dive/documents-and-filters) (**Years back**, **Disclosure types**, **Include latest OS**) so the template runs against the right corpus.
  </Step>

  <Step title="Open the command menu">
    Type `/` in the chat box.
  </Step>

  <Step title="Pick a template">
    Select **run-prompt** and pick your template. A tag appears in the chat showing which template was run, so the history records exactly what was asked.
  </Step>

  <Step title="Review and iterate">
    Check the answer and its citations. If the scope wasn't right, change the filters and re-run. If the prompt itself needs work, edit it on the [Prompts](https://terrapinfinance.com/platform/prompts) page and re-run.
  </Step>
</Steps>

## Why use a template instead of typing the prompt

* **Repeatability**: the same template on two obligors produces comparable output, which is hard with ad-hoc questions.
* **Speed**: a tuned prompt can be 500+ words; running it from the menu is one click.
* **Audit trail**: the chat history records the template name, so reviewers know exactly what was asked.
* **Re-use in watchlists**: the template you tuned here can be applied to every entity in a [watchlist](/platform-guide/watchlists/assignments) via an assignment.

## Authoring and best practices

For everything about creating, editing, sharing, and writing better templates, see [Prompt Templates](/platform-guide/prompt-templates). For how to phrase any prompt so it retrieves the right evidence, see [Writing effective prompts](/platform-guide/writing-effective-prompts).