PromptX v0.1.1

Changelog

All notable changes to the PromptX specification will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[0.1.1] - 2026-02-23

Added

• ready-to-run/ folder with 10 self-contained, copy-paste programs: email-drafter, meeting-notes, learning-plan, startup-evaluator, standup-generator, eli5-explainer, debate-simulator, code-detective, interview-coach, recipe-planner
• ready-to-run/README.md with usage instructions, program table, and provider compatibility guide
• Execution preamble (HTML comment block) to all sample programs — ensures reliable execution across AI providers without needing the runtime template
• Hardcoded defaults to all sample @variables — every sample now runs standalone with zero user interaction required
• "Try It in 30 Seconds" section to root README.md with direct links to ready-to-run programs
• Two new FAQ entries: execution preamble explanation, and samples/ vs ready-to-run/ distinction

Changed

• templates/runtime.promptx — restructured with phase headers (Parsing / Execution / Context Management / Output Delivery), improved rule specificity, added @parallel isolation note and loop termination guarantees
• docs/QUICK-START.md — updated code examples to use the execution preamble, added "fastest path" pointer to ready-to-run/, expanded Step 5 with both learning paths
• README.md — updated Quick Start to offer three paths (instant / learn basics / full power), added ready-to-run/ to navigation
• All 9 sample programs — replaced @input() calls with sensible defaults; added customization comments

Fixed

• Sample programs failing to self-execute when pasted into AI chats (root cause: missing execution directive; fix: embedded preamble)

[0.1.0] - 2026-02-23

Added

• Initial PromptX specification
• Core program structure: @program, @version, @description, @config, @variables, @pipeline, @output
• Cognitive primitives: @think, @decide, @recall, @search, @create, @verify, @transform, @compose
• Control flow: sequential, branching (@if/@elif/@else), for-each loops, while loops, parallel branches
• State management: $variables, @set, @append, @push, @pop, @clear
• Error handling: @on_error, @retry, @strategy, @fallback
• Subroutines: @define/@end_define, @call
• Context management: @context_budget, @context_action, @checkpoint, @continuation_prompt
• Runtime prompt template
• Program template
• 8 sample programs (3 basic, 3 intermediate, 2 advanced)
• Documentation: specification, quick start, cognitive primitives, control flow, patterns, provider compatibility, FAQ
• Contributing guidelines
• GitHub issue templates (bug report, feature request, test results)

PromptX v0.1.0 — Initial Specification

Changelog

All notable changes to the PromptX specification will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[0.1.0] - 2026-02-23

Added

• Initial PromptX specification
• Core program structure: @program, @version, @description, @config, @variables, @pipeline, @output
• Cognitive primitives: @think, @decide, @recall, @search, @create, @verify, @transform, @compose
• Control flow: sequential, branching (@if/@elif/@else), for-each loops, while loops, parallel branches
• State management: $variables, @set, @append, @push, @pop, @clear
• Error handling: @on_error, @retry, @strategy, @fallback
• Subroutines: @define/@end_define, @call
• Context management: @context_budget, @context_action, @checkpoint, @continuation_prompt
• Runtime prompt template
• Program template
• 8 sample programs (3 basic, 3 intermediate, 2 advanced)
• Documentation: specification, quick start, cognitive primitives, control flow, patterns, provider compatibility, FAQ
• Contributing guidelines
• GitHub issue templates (bug report, feature request, test results)