Skip to main content
ALTAIRA LABS
DocsBlog
● open specification·spec cc-by-4.0·code mit·current draft v1.5.1·status: stablean open standard from altairalabs
where every agent starts: define → prove → run → operate

One open spec to define, package, and ship an agent.

PromptPack is the declarative format for a production agent — the models it requires, its prompts, tools, workflows, guardrails, and the quality checks it must pass — in a single portable, versioned artifact. Author once, run it on any PromptPack-compatible runtime.

one file·every provider·versioned·open
customer-support.promptpack.json1 file
// everything the agent needs, declared once
id · name · versionidentity & semver
template_enginevariable syntax
toolsdefine once, reuse
fragmentsshared text blocks
promptsspecialized, per scenario
evalsquality checks travel along
workflow · agentsorchestration
skills · requiresknowledge & providers
the format in motion
§ 01 — the problem

AI agent development is fragmented.

Each framework has its own format for prompts, tools, workflows, and test scenarios. When you change frameworks or providers, you rebuild from scratch.

Agent logic — now critical business logic — lacks engineering discipline.

§ 02 — the solution

A vendor-neutral JSON format.

PromptPack packages AI agent behavior into one portable file:

  • Framework-agnostic prompt definitions
  • Reusable tool specifications
  • Workflow and agent-loop orchestration
  • Version-controlled agent logic
  • Works with any runtime or provider
§ 03 — anatomy of a promptpack

One file describes the whole agent.

A promptpack is plain JSON validated against a published schema. A valid pack needs only identity, a template engine and one prompt — everything beyond that is optional, so you can grow into full multi-agent orchestration without changing format.

customer-support.promptpack.jsonvalidated · schema v1.5.1
{
  "$schema": "https://promptpack.org/schema/latest/…",
  "id": "customer-support",
  "name": "Customer Support Pack",
  "version": "1.0.0",
  "template_engine": { "syntax": "{{variable}}" },
  "tools": {
    "lookup_order": { "type": "function" }
  },
  "fragments": {
    "brand_voice": "Friendly, professional tone."
  },
  "prompts": {
    "support": {
      "system_template": "You are a {{role}}. {{fragments.brand_voice}}",
      "tools": ["lookup_order"]
    }
  },
  "evals": [
    { "id": "tone-check", "type": "llm_judge" }
  ]
}
01
id · name · version
Identity and semantic version — required, alongside template_engine and prompts.
02
tools
External functions defined once, referenced by any prompt.
03
fragments
Reusable text blocks interpolated into templates for consistency.
04
prompts
Specialized, templated system prompts with typed variables and tool bindings.
05
evals
Automated quality checks with Prometheus metrics — shipped alongside the prompts.
+
Add workflow, agents, skills and requires as the pack grows.
§ 04 — capabilities

New capabilities arrive as optional sections.

spec versions
v1.0 → v1.5.1
v1.4
Agent Loops
Terminal states, retry budgets, replayable artifacts.
v1.3
Workflows & Multi-Agent
State-machine orchestration with A2A definitions.
core
Multi-Prompt Architecture
Specialized prompts per scenario or workflow stage.
core
Tool Integration
Define tools once, reference them across all prompts.
v1.2
Evals & Guardrails
Quality policy and safety travel with the pack.
v1.5.1
Provider Requirements
Declare needed providers for coverage and parity.
01 / reuse

Stop building the same agents over and over.

Package prompts, tools, workflows, and agent loops into one deployable unit. Share proven behavior across teams and organizations.

02 / package

Deploy agents, not just prompts.

Specialized prompts, external tools, workflow state machines, and guardrails — all in one file. No more scattered configuration.

03 / verify

Know your agent works before you deploy.

Built-in evals and testing metadata show which models perform best and how reliably — no "works on my machine" surprises.

§ 05 — the constellation

The open spec at the base of the family.

PromptPack is neutral by design — the community standard everything else builds on. The commercial products in the AltairaLabs constellation each add their own layer on top of the same file.