Prompt Registry

# Prompt Registry

The **Prompt Registry** is the core of Promptly. It acts as the version control system for your AI prompts.

## Managing Prompts

When you navigate to the Registry, you will see a list of all prompt templates available in the current project.

<p align="center">
  <img src="../../screenshots/project-prompts.png" alt="Prompt List" width="100%" />
</p>

Each row displays the prompt name, description, tag chips (e.g., `ABA`, `AUTISM`, `BEHAVIOR`), approval status badge, version number, and the last-updated timestamp. Use the grid/list toggle and the **+ New Prompt** button in the top-right corner.

### 1. Creating a New Prompt
Click "New Prompt" to open the creation dialog. You will need to provide:
* **Name:** A unique identifier for the prompt (e.g., `customer-support-greeting`).
* **Content:** The actual prompt text. You can use Handlebars-style variables like `{{user_name}}` which the Runtime API will interpolate.
* **Model Configuration:** Select the target LLM (e.g., GPT-4, Claude 3, Gemini 1.5 Pro) and configure parameters like `temperature` and `max_tokens`.

### 2. Versioning
Every time you make a change to a prompt, a new immutable version is created. This allows you to safely rollback if a prompt causes regressions in production.
* Example: Version `1` is deployed. You create a draft for Version `2`. Once Version `2` is approved and deployed, Version `1` is archived but preserved in the history.

### 3. Prompt Detail

Click any prompt to open the detail page with the full Monaco editor, actions sidebar, and version history.

<p align="center">
  <img src="../../screenshots/prompt-detail.png" alt="Prompt Detail" width="100%" />
</p>

The prompt detail page includes:

* **Content Panel** — An integrated Monaco Editor (the same editor powering VS Code) with Edit, Split, Preview, and Format modes. The editor supports markdown rendering and syntax highlighting for Handlebars variables.
* **Properties Sidebar** — Shows the Prompt ID, status badge (APPROVED, DRAFT, etc.), format, and timestamps.
* **Actions** — Clone Prompt, Submit for Review, and Delete Prompt buttons.
* **Last Scan** — A compact card showing the latest vulnerability scan result: status badge, score, finding count, and finding titles with severity chips. Click **View Full Report** to drill into the scan details.
* **Version History** — A table listing all versions with the change description, author, and date.

### 4. Editor Experience
The registry includes an integrated Monaco Editor (the same editor powering VS Code). It provides:
* Syntax highlighting for Handlebars variables.
* Auto-completion for known parameters.
* Inline linting for potential issues (e.g., unbalanced brackets).

## Runtime Delivery

Once a prompt version is in the `DEPLOYED` state, it is immediately available to your backend services via the Promptly Runtime API: