Promptfile v1 Reference

.spore.md
Header Reference

Dedicated schema reference for valid front matter, supported values, and common parser failures. Use this when prompts are being skipped, rejected, or mis-indexed.

Back to Support Open Main FAQ Email Support
• Promptfile version: v1 • Header schema focus • Parser troubleshooting

Minimum Valid Example

Baseline 
---
id: "2F6C9B6E-1E3A-4E2E-9E66-7B3A0F1B6D35"
pulse_mode: "Support"
pulse_vibe: "calm-support"
title: "Support Reply"
author: "Spore Team"
---

You are a support assistant. Reply to {{customer_name}} about {{issue}}.

Header Fields Reference

Schema Map
Field Required Type Notes
promptfile No int Standard version is 1. (Defaults to 1 if omitted).
id Yes string Must be a valid UUID. Persistence key.
pulse_mode Yes string Use one of the supported values listed below.
pulse_vibe Yes string Kebab-case slug recommended (e.g., dry-utilitarian).
title Yes string Human-readable prompt title.
goal No string One-line prompt intent.
author No string Optional creator attribution.
tags No string[] Defaults to an empty array if omitted.
inputs No map Input definitions keyed by variable name.
output No map Supports format, max_words, max_chars.
tribe_id No string Groups prompts for tribe-level sharing flows.
confidentiality No string low | medium | high, defaults to low.

Supported pulse_mode Values

Use these profiles to ensure consistency with system templates and filters.

Strategy Shipping Marketing Creative Support Documentation Shielding Testing

Input & Output Cheatsheet

  • → inputs.*.type: string, text, number, boolean, enum, json
  • → inputs.*.required: boolean (default: true)
  • → inputs.*.pattern: optional regex string validation
  • → output.format: markdown, text, json, html

Common Header Errors

Troubleshooting

Field Absence

Usually missing id, title, pulse_mode, or pulse_vibe. Parser rejects the file.

ID Collision

Duplicate UUID across the workspace causes index shadowing or merge failures.

UUID Validation

Header id must be a standard UUID string format. Placeholder strings like "1" will fail.

Date Strictness

updated_at requires ISO8601 date-time format for proper timeline sorting.

Variable Gap

Every {{variable}} in the prompt body must be explicitly defined in the inputs map.

Version Lock

Unsupported promptfile version. Expected version is integer 1.