Prompt Template

Origin & evolution

Parameterised text long predates language models, from printf format strings to email mail-merge. What changed is that the filled-in string now drives a probabilistic system whose behaviour is sensitive to wording, ordering, and example choice. A template that names its variables explicitly, {{customer_name}} or {{ticket_body}}, turns an ad-hoc prompt into something a team can reason about and reuse.

The practice matured into prompt management as products moved prompts out of source code and into dedicated stores. Tooling such as Langfuse and others popularised the split between the template, the editable structure, and its versions, the immutable snapshots. The mantra that prompts are code drove the rest: templates get reviewed, tested, and deployed through staged environments rather than edited live in production.

The current debate is where a template should live and who owns it. Keeping prompts in code couples them to release🚢ReleaseProduct SpecificationA shipped version of the productView reference → cycles, which slows iteration; moving them to a hosted store lets non-engineers edit them, which raises the risk🎲RiskComplianceA risk to the product or businessView reference → of an unreviewed change reaching users. Most teams settle on a template held outside the binary but governed by the same review and versioning discipline as code.

How it works in practice

A support tool defines one prompt template for ticket triage: a system message stating the assistant's role, two few-shot examples of correctly categorised tickets, and slots for {{ticket_body}} and {{customer_tier}}. Every incoming ticket renders the same template with different values, so 4,000 tickets a day share one auditable structure. When the product later adds a billing category, the team edits the template once, in one place, and every request picks up the change. Had the prompt been hardcoded at each call site, the same edit would mean hunting through the codebase and risking drift between copies.

Prompt template vs. its neighbours

• Prompt version🗨️Prompt VersionAI & Machine LearningA version of a prompt templateView reference → is one immutable snapshot of a template at a point in time. The template is the living, editable thing; a version freezes its exact text so a result can be traced to the wording that produced it. Editing the template creates a new version.
• AI model🤖AI ModelAI & Machine LearningAn AI or ML model used within the productView reference → is the system the rendered prompt is sent to. The same template can target different models, and a template tuned for one model often behaves differently on another, which is why the two are separate.
• Feature⭐FeatureProduct SpecificationA product capability or featureView reference → is the product capability💪CapabilityStrategyAn ability that enables value deliveryView reference → the template serves. One feature may rely on several templates; one template may power more than one feature. Keeping them distinct stops prompts from being buried inside feature code.

In the graph

In the Unified Product Graph, prompt_template✒️Prompt TemplateAI & Machine LearningA reusable prompt template lives in the ai domain and sits early in its creation sequence, right after ai_model🤖AI ModelAI & Machine LearningAn AI or ML model used within the productView reference →. Its versions hang off it through prompt_version_evolves_prompt_templatePrompt VersionevolvesPrompt Templatecross-domain, the feature it serves connects through prompt_template_powers_featurePrompt TemplatepowersFeaturecross-domain, and the product that calls it links via product_prompted_via_prompt_templateProductprompted viaPrompt Templatehierarchy. A content calendar📅Content CalendarContent & KnowledgeA content publication calendarView reference → can even schedule a template through content_calendar_schedules_prompt_templateContent CalendarschedulesPrompt Templatehierarchy. Modelling the template as the durable parent and versions as its children is what enforces the domain's anti-pattern against prompts without versioning: an unversioned template is a visible gap in the graph, not a silent one in the code.