Create a Branching Dialogue Lesson

Build a branching scenario where learners make decisions that lead to different outcomes and personalized feedback. This walkthrough uses a paramedic emergency response scenario, but the same techniques apply to any dialogue-based or choose-your-own-adventure lesson.

Try the lesson

This lesson is best viewed on a desktop or tablet computer.

Try it full screen →

How this lesson is built

The lesson is structured around decision points: at each step the learner chooses between two or three options, and each choice routes them to a different next step. Paths eventually converge at a debrief screen that shows personalized feedback based on the choices made.

Step design with templates

The first step in building this lesson is designing one “decision point” step with the right layout — a scenario description at the top and navigation choices below — and saving it as a template. Every subsequent decision step then uses that template, so the layout stays consistent without rebuilding it each time.

Writing the lesson abstract

A detailed lesson abstract describes the full branching structure: the scenario, each decision point, what each choice represents, which step each choice leads to, and which variables track learner decisions. Writing this upfront lets the AI generate the full lesson structure — sections, steps, and variable definitions — in a single request rather than building steps one by one.

Each decision step uses a Navigation Choice component with options that navigate to different steps. Each choice also sets a variable (like choice1 = “A” or “B”) when selected. These variables accumulate as the learner moves through the lesson and are used on the final debrief screen to show what decisions were made.

AI-assisted content generation

After the structure is scaffaolded, the AI generates content for each decision point step using the saved template. Multiple steps can be generated in a single batch request — describe the scenario context for each step and the AI fills in the text and choices while keeping the template layout.

Verifying with the Flow Map

The Flow Map visualizes all steps as nodes and all navigation connections as arrows. After generation, the flow map makes it easy to confirm that every navigation choice points to the right next step and that no paths lead to dead ends.

Conditional debrief screen

The final debrief uses visibility conditions to show different feedback based on the variables set during the lesson. Multiple feedback blocks sit on the same step, each with a condition tied to the learner’s choices. Learners who made optimal decisions see a different message than those who chose a suboptimal path.