By NHI Mgmt Group Editorial TeamBased on Arize: “Prompt templates as configs, not code” (April 30, 2026)

TL;DR: Prompt templates start as code because that keeps them versioned, reviewable, and tied to application deploys, but Arize argues they should move to config once behavior changes independently of the surrounding system. The operational shift matters because prompt iteration then needs its own lifecycle, rollback path, and observability instead of inheriting the release cadence of the host application.


At a glance

What this is: This article argues that prompt templates stop being mere code when they start changing independently of application logic and begin shaping runtime behavior.

Why it matters: AI teams need to govern prompts like configurable runtime assets when behavior changes, experimentation, and rollback no longer fit the application release cycle.


Context

Prompt templates are not just text once they start driving system behaviour independently of surrounding application logic. In AI systems, that creates a governance problem that looks familiar to IAM and configuration management teams: the control surface has shifted, but the operating model may not have.

The article’s central question is when a prompt should remain part of source code and when it should become runtime configuration with its own lifecycle. That distinction matters because prompt changes can alter tool use, routing, and output without any accompanying code change, which means release controls alone are no longer sufficient.


Key questions

Q: When should prompt templates move out of code and into config?

A: Prompt templates should move into config when they change independently of application logic and need their own rollout, rollback, or validation path. If a prompt can alter runtime behaviour without a code change, treating it as config gives teams more control over promotion, tracing, and safe experimentation.

Q: Why do runtime-led AI systems need stricter prompt governance?

A: Runtime-led systems assemble behaviour from layered instructions, so the final prompt outcome depends on precedence rather than a single file. That makes governance harder, because small changes in defaults, overrides, or session context can alter behaviour without any visible application release.

Q: What breaks when prompt changes are tied to application deploys?

A: Teams lose the ability to iterate on behaviour quickly without shipping unrelated code. Small wording changes, tool instructions, or model-specific tweaks then inherit a full release cycle, which slows experimentation and makes rollback more expensive than the prompt change itself.

Q: How should AI teams govern prompt rollout and rollback?

A: Use a staged lifecycle with draft, evaluation, canary, promotion, and rollback so prompt changes move through controlled checkpoints. That approach keeps production stable while still allowing targeted experimentation, and it makes the prompt version behind any output auditable.


Technical breakdown

Prompt-as-code vs prompt-as-config

When prompts live in code, they inherit the normal engineering lifecycle: review, merge, build, deploy, and rollback. That works when prompts behave like static implementation detail. Once prompt changes begin affecting runtime output, tool calls, or model behaviour independently of application logic, the prompt is no longer just source text. It becomes a governed behaviour artifact that needs its own versioning and release discipline.

Practical implication: Treat frequent or behaviour-shaping prompts as first-class configuration rather than inline code.

Instruction precedence in runtime-led AI systems

Runtime-led systems rarely rely on a single prompt string. They assemble behaviour from layered instructions such as built-in defaults, project files, session context, tool instructions, and operator overrides. The important control is precedence, because the final behaviour depends on which layer wins at runtime. In these systems, prompt governance is closer to managing a policy stack than managing a file.

Practical implication: Define and test instruction precedence so overrides do not produce unexpected model behaviour.

Config lifecycle, observability, and rollback

Once prompts become config, they need the same operational properties as other runtime controls: validation, promotion stages, observability, and rollback. The article’s key point is that prompt delivery becomes part of production infrastructure, so teams must know which prompt version, model, tool policy, and rollout cohort produced each result. Without traceability, behaviour changes become hard to explain or reverse.

Practical implication: Version prompt objects with their rollout metadata and trace every production run to the exact config state.


NHI Mgmt Group analysis

Prompt governance has crossed the line from content management into runtime control. Once a prompt changes model output without a code change, it is no longer a static string. That creates a control problem closer to configuration governance than software editing, because the business impact now sits in the behaviour layer. Practitioners should treat prompt ownership, approval, and rollback as a distinct operational domain.

Hybrid AI stacks will become the norm, not the exception. The article shows that many systems already mix code-owned prompts, runtime-owned instruction assembly, and separately managed prompt objects. That means governance models built on a single prompt location will keep failing at scale. The practical conclusion is that teams need policy for where behaviour lives, not just where text is stored.

Prompt lifecycle is an AI governance debt issue. The article points to a familiar pattern: teams postpone configuration discipline until prompt iteration becomes operationally expensive. At that point, they inherit drift, weak traceability, and brittle rollback paths. The named concept here is behaviour contract drift, where prompt, model, tool, and rollout settings move out of sync. Practitioners should manage that contract explicitly before production variation outpaces control.

Runtime configurability is only useful when the surrounding controls are equally explicit. A prompt gateway or config service adds leverage only if it also enforces validation, availability, and provenance. Otherwise, faster prompt changes simply create faster failure. For identity and AI governance teams, the lesson is that control surfaces must be designed together, not bolted on after prompt experimentation starts.

Prompt-as-config validates a broader shift in AI operations. The article reflects a market-wide move from single artifacts to behaviour systems. That matters for agentic AI security because prompts, model choice, tool settings, and rollout metadata increasingly act like managed identities for runtime behaviour. Practitioners should assume that future control models will focus on the behaviour contract, not the prompt alone.

What this signals

Behaviour contract drift: AI teams should expect prompt, model, tool, and rollout settings to diverge unless they are managed as a single governed object. That drift becomes visible only when tracing and versioning are incomplete, so the control problem is as much about provenance as it is about prompt wording.

The operational signal is straightforward: when prompt iteration starts happening more often than application deploys, the team has already crossed the threshold where code-only governance is too slow. At that point, config discipline is not optional if the organisation wants safe experimentation and explainable production behaviour.


For practitioners

  • Define a prompt lifecycle policy Classify prompts as code, runtime config, or hybrid based on how often behaviour changes and whether application logic changes with them.
  • Version the full behaviour contract Track template text, model selection, inference settings, tool assumptions, rollout metadata, and fallback references as one managed unit.
  • Add validation before rollout Check required variables, model compatibility, and output schema expectations before a prompt variant can move into production.
  • Separate prompt promotion from application deploys Use draft, evaluate, canary, promote, and rollback stages so prompt changes do not require a full application release.
  • Trace every production run to a config version Record the exact prompt version, model, tool policy, and cohort that produced each response so behaviour changes are explainable.

Key takeaways

  • Prompt templates stop being simple implementation detail once they change runtime behaviour independently of the surrounding application.
  • The article’s core governance point is that prompt iteration needs versioning, validation, rollout, rollback, and observability as a separate lifecycle.
  • For AI teams, the practical question is not whether prompts belong in code or config by default, but whether behavioural change now outpaces the application release cycle.

Standards & Framework Alignment

This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.

OWASP Agentic AI Top 10 addresses the attack surface, NIST AI RMF and NIST CSF 2.0 set the technical controls, and ISO/IEC 42001:2023 defines the regulatory obligations.

FrameworkControl / ReferenceRelevance
NIST AI RMFGOVERN — AI Governance and AccountabilityThe article is about governing AI behaviour changes through lifecycle controls and accountability.
Recommendation — Establish governance for prompt versioning, approval, traceability, and rollback as part of AI operating controls.
ISO/IEC 42001:2023A.5 — Policies for AI system lifecyclePrompt templates as config are a lifecycle governance issue within an AI management system.
Recommendation — Define lifecycle policy for prompt assets, including approval, change control, and monitored deployment.
NIST CSF 2.0PR.PS-01 — Configuration managementPrompt config, validation, and rollback are configuration-management problems in production AI systems.
Recommendation — Apply configuration management controls to version, validate, and roll back prompt objects as production settings.
OWASP Agentic AI Top 10ASI03 — Identity & Privilege AbusePrompt and tool instructions shape agent behaviour and privilege boundaries at runtime.
Recommendation — Constrain runtime instructions so prompt changes cannot silently expand tool use or decision authority.

Key terms

  • Prompt-as-config: A prompt-as-config model treats instructions as live runtime configuration rather than static source text. The prompt can be versioned, promoted, rolled back, and targeted independently of the application code that consumes it, which makes behavioural governance a first-class operational concern.
  • Behaviour contract: A behaviour contract is the full set of inputs and controls that shape how an AI system acts at runtime. It includes the prompt text, model choice, inference parameters, tool assumptions, output constraints, and rollout metadata, all of which should be managed together when behaviour changes matter.
  • Instruction precedence: Instruction precedence is the ordering rule that determines which prompt layer wins when multiple sources of guidance exist. In runtime-led AI systems, built-in defaults, project files, session context, tool instructions, and overrides may all contribute, so teams need clear precedence rules to predict the final behaviour.
  • Behaviour Contract Drift: The condition where prompt text, model settings, tool policies, and rollout state change out of sync over time. Drift makes AI behaviour harder to predict, trace, and govern because no single version fully describes what the system is doing.

Deepen your knowledge

The NHI Foundation Level course, the industry's only accredited NHI security programme, covers NHI governance, agentic AI identity, and secrets management in a way that helps security teams reason about runtime control surfaces. It is designed for practitioners who need to connect identity governance to AI operations and broader access management.
NHIMG Editorial Note
Published by the NHIMG editorial team on August 20, 2026.
Updated on October 12, 2026.
NHI Mgmt Group, the independent authority on Non-Human Identity, IAM, and Agentic AI security. nhimg.org