Skip to main content
AI & ML OpsLast reviewed 2026-09-20

PromptOps

Treating prompts as versioned production artifacts: a registry, change review, regression evaluation on a fixed test set, staged rollout and rollback — because a prompt edit is a behaviour change with no compiler to catch it.

Overview

Read the full PromptOps guidance
WHAT IT IS PromptOps is the practice of managing prompts the way any other production artifact is managed: stored in version control or a registry rather than pasted into code, changed through review, evaluated against a fixed regression set before release, rolled out in a way that can be reversed, and attributable to whoever changed them. **Not this:** PromptOps is not LLMOps: it is the narrower practice of managing prompts as reviewed, evaluated, reversible artifacts, not the operation of the surrounding application and its providers. WHY IT EXISTS A prompt is code with none of code's safety net. Editing one word changes system behaviour for every user, no compiler objects, no type checks, and the effect is often visible only in aggregate across many outputs. Teams routinely ship prompt changes through a path that would never be accepted for a database migration — directly, unreviewed, untested, and untracked. PromptOps exists to close that gap without pretending a prompt is a deterministic function. WHEN TO USE IT Adopt it as soon as a prompt is in a production path and more than one person can edit it. The trigger is shared ownership: the first time someone asks "why did the output change?" and nobody can say what was altered, the practice has already become overdue. WHO OWNS IT The engineering team shipping the feature owns the prompt registry and the release path. Whoever owns the feature's quality — often a product manager or domain expert — owns the evaluation set, because deciding what a good output looks like is a domain judgment, not an engineering one. Subject-matter reviewers own approval for prompts in regulated or high-consequence contexts. WHAT GOOD LOOKS LIKE Every production prompt has a version, an owner and a change history you can read. Changes go through review by someone other than the author. A fixed regression set of representative inputs runs against a candidate prompt and the result is compared with the incumbent before release, so a change that improves one case and breaks five is caught. Rollout is staged or flagged, and reverting is fast and routine. Which prompt version produced a given output is recorded, so a complaint can be traced to a change. HOW TO IMPLEMENT Get prompts out of inline string literals and into a registry with versions — this single step makes every later practice possible. Add authorship and review to the change path, reusing your existing code-review mechanics rather than inventing a parallel process; the versioning discipline in /gitops applies unchanged. Build the regression set from real inputs, including the cases that have already caused complaints, and keep it small enough to actually run. Compare candidate against incumbent rather than against an absolute score, because absolute quality scores drift and relative comparisons stay meaningful. Add version stamping to outputs last, and you gain traceability for support. HOW TO ASSESS YOURSELF Ask who changed the production prompt most recently and what it did to output quality. Ask whether a prompt change could reach users without a second person seeing it. Ask how long a rollback takes. Take the scored self-assessment at /assess, then sequence the findings with /roadmaps; the review checklists at /checklists cover the recurring evaluation pass.

Capabilities

  • Prompt change review

    A second person approving a prompt change before it reaches users, using the same review mechanics as code.

  • Prompt registry

    Production prompts stored as versioned artifacts with an owner and a readable change history, not as inline string literals.

  • Prompt regression evaluation

    Running a candidate prompt against a fixed set of representative inputs and comparing with the incumbent, so a change that fixes one case and breaks five is caught.

  • Staged rollout and rollback

    Releasing a prompt change behind a flag or to a subset, with reverting treated as routine.

  • Version attribution

    Recording which prompt version produced a given output, so a complaint can be traced to the change that caused it.

Practices

  • Evaluation set curation

    Growing a fixed set of real cases — especially the ones that have already caused complaints — and keeping it small enough that it actually runs.

  • Prompt peer review

    A second reader on every prompt change, with the domain expert rather than only the engineer judging whether the output is right.

Metrics

  • Prompt change lead time

    Time from an agreed prompt change to it serving traffic, including review and evaluation.

    Unit: hours. Good direction: down.

  • Regression catch rate

    Share of prompt changes that degraded quality and were caught by evaluation before release rather than by a user afterwards.

    Unit: percent. Good direction: up.

  • Unreviewed prompt changes

    Production prompt changes that reached users without a second person seeing them.

    Unit: changes per quarter. Good direction: down.

Tools

  • LangSmith

    Tracing, dataset and evaluation tooling for LLM applications, including prompt-level comparison runs.

    Visit site ↗
  • Langfuse

    Open-source observability, prompt management and evaluation for LLM applications, including retrieval traces.

    Visit site ↗
  • promptfoo

    Test runner for prompts that compares candidate against incumbent across a fixed set of cases in a pipeline.

    Visit site ↗

Architecture patterns

Reference architectures and their trade-offs live in the blueprints library.

Maturity

  1. L1 ReactivePrompts live inline as string literalsrequired stage

    Prompts are embedded in code or configuration with no version, owner or history, and a change is indistinguishable from any other edit.

  2. L2 RepeatablePrompts are versioned artifacts with an ownerrequired stage

    Production prompts live in a registry or version control with a readable change history and a named owner.

  3. L3 StandardizedEvery change requires a second reader

    Prompt changes go through review by someone other than the author, with a domain expert judging output quality, before reaching users.

  4. L4 MeasuredRegression evaluation compares against the incumbent

    A fixed set of representative inputs runs against candidate and incumbent, catching the change that fixes one case and breaks five.

  5. L5 OptimizedStaged rollout with traceable output versions

    Changes release behind a flag or to a subset, reverting is routine, and the prompt version that produced any output can be identified.

Maturity for promptops is measured, not guessed — every score traces to your answers. See how maturity is scored.

Put it to work

  • LLMOps

    LLMOps is specialized by this area

  • RAGOps

    RAGOps complements this area

Sources