Prompt Schema

---
name: prompt-schema
type: convention
version: "1.0"
language: en
status: stable
tags: [schema, front-matter, conventions]
---

# Prompt Schema - Agent Prompt Framework V1

This document defines the shared YAML front matter schema and the
type-specific content schemas for all files in this framework.

---

## Shared Front Matter (all file types)

Every file in this framework - regardless of type - must include
the following YAML front matter block at the top.

| Field      | Type   | Required | Description                                                                |
| ---------- | ------ | -------- | -------------------------------------------------------------------------- |
| `name`     | string | ✅        | Unique identifier of the file (kebab-case)                                 |
| `type`     | string | ✅        | One of: `persona`, `mode`, `output-template`, `shared-block`, `convention` |
| `version`  | string | ✅        | Semantic version string, e.g. `"1.0"`                                      |
| `language` | string | ✅        | ISO 639-1 code, e.g. `en`, `hu`                                            |
| `status`   | string | ✅        | One of: `draft`, `stable`, `deprecated`                                    |
| `tags`     | list   | optional | Free-form keywords for filtering/searching                                 |

**Example:**