---
id: "guide-vs-scenario"
type: "concept"
title: "Guides vs scenarios vs journeys"
summary: "Guides are bounded procedures; scenarios branch on state; journeys compose an end-to-end outcome."
problem: "Mixing learning, diagnosis, and production procedures confuses agents and operators."
why: "Clear types keep invariants and confirmation boundaries enforceable."
mentalModel: "Scenario chooses a guide; journey sequences several guides and decisions."
audiences: ["developers", "builders"]
related: ["explicit-authoring"]
packageVersion: "1.4.2"
updatedAt: "2026-07-30T16:00:45.570Z"
---
# Guides vs scenarios vs journeys

Guides are bounded procedures; scenarios branch on state; journeys compose an end-to-end outcome.

## Problem

Mixing learning, diagnosis, and production procedures confuses agents and operators.

## Why

Clear types keep invariants and confirmation boundaries enforceable.

## Mental model

Scenario chooses a guide; journey sequences several guides and decisions.