Concepts Overview

This page is a 3-minute orientation. Each topic linked below has its own page with the detail; skim this first to know what you're looking at.

The core idea

A prompt is a version-controlled, environment-released artifact, fetched at runtime by name.

Three implications of that single sentence:

1. Version-controlled — every save creates an immutable version. You don't edit a prompt; you create a new version of it.
2. Environment-released — versions don't go to production by being saved. They get released to environments (development, testing, production) on their own schedule, independently of code deploys.
3. Fetched by name — your application code says "give me the active version of welcome_email for my environment." It doesn't pin a version, doesn't deploy with the text inlined. The platform decides what "current" means.

Everything else is structure around this idea.

The hierarchy