# Prompt file

URL: /code/project-structure/prompt-file · Id: `convention:prompt-file`

> A prompt file holds one Template of model instructions that a Role, a Function or a Workflow step fills and sends to a model.

A prompt file holds one [Template](/business/nouns/template) of model instructions that a [Role](/business/nouns/role), a [Function](/business/nouns/function) or a [Workflow](/business/nouns/workflow) step fills and sends to a model.

| Property | Value |
| --- | --- |
| Path | `prompts/[prompt].md` |
| Holds | [Template](/business/nouns/template) |
| Kind | file |
| Leaders | db-first, git-first |
| Team | [Quality Team](/agents/quality) |
| Written by | [Change.merge](/business/nouns/change/merge) |
| Compiled by | [StartupBuilder](/code/builders/startup) |

### Example
`prompts/close-summary.md` in a Startup repository. Closewise, a sample business, declares a `Close` Noun.

```md title="prompts/close-summary.md"
---
description: Summarize a finished Close for the agency owner.
inputs: { close: Close }
model: draft
evaluators: [tie-out]
---
Write three sentences for the owner of {{close.client.name}}.
Say whether the {{close.period}} books balance, and name any entry still unmatched.
Never estimate a number the Close does not hold.
```

### Props
The frontmatter keys the file takes. The body is its prose.

| Prop | Type | Required | Description |
| --- | --- | --- | --- |
| `description` | `string` | Yes | When it is used, in one sentence. |
| `inputs` | `json` | No | The fields it fills, each with its type; the body reads each as `{{name}}`. |
| `model` | `string` | No | The task class it runs under, such as `draft` or `classify`; never a model name. |
| `evaluators` | list of [Evaluator](/business/nouns/evaluator) | No | The Evaluators that grade every output; a new version must score no worse before it merges. |

### Generates
[StartupBuilder](/code/builders/startup) compiles it into these records, Verbs and routes.

| Kind | What |
| --- | --- |
| Records | [Template](/business/nouns/template), [Version](/business/nouns/version), [Variant](/business/nouns/variant) |
| Verbs | None. |
| Routes | None. |