Promptkit Pull Request

<!-- SPDX-License-Identifier: MIT -->
<!-- Copyright (c) PromptKit Contributors -->

---
name: promptkit-pull-request
type: format
description: >
  Output format for PromptKit contributions. Produces PR-ready component
  files, a manifest update, and a pull request description.
produces: promptkit-contribution
---

# Format: PromptKit Pull Request

The output MUST be a complete, PR-ready set of files and a pull
request description. Every file must be ready to commit — no
placeholders, no TODOs, no incomplete sections.

## Output Structure

### 1. Component Files

For each new component, produce the **complete file content** with:

- SPDX license header at the top
- Valid YAML frontmatter with all required fields
- Full body content following the conventions for that component type

Present each file as:

    ### File: <path relative to repo root>

    ```markdown
    <complete file content>
    ```

### 2. Manifest Update

Show the **exact additions** to `manifest.yaml`:

    ### Manifest additions (add to manifest.yaml)

    ```yaml
    <YAML fragment to insert, with a comment indicating where it goes>
    ```

### 3. Pull Request Description

Produce a PR description in this format: