The recruiter-facing layer. A working demo can't explain its own design decisions — this can.
The six problems
1 · Non-determinism vs. authored branches. Real agents vary run to run; a prototype must use pre-written states — without feeling on-rails.
2 · The invisible made visible. Tool-calling and handoffs happen under the hood. Surfacing them risks re-introducing the terminology overload this design exists to prevent.
3 · Time compression. A real workflow runs over hours; the prototype compresses it to seconds while keeping cause and effect legible.
4 · Safe but real-feeling consequence. Productive failure is the teaching tool. The cost of a bad approval must land emotionally yet stay recoverable.
5 · Branching explosion. Writing out every possible path is impossible; removing choice entirely teaches nothing.
6 · Authentic agency. The learner's choices must genuinely change what happens, or it quietly becomes manipulation.
The resolution
Concentrate effort on the few moments that carry the teaching — verify, allocate, intervene — and write out the branches with vivid consequences only there. Everything between is compressed and guided. The invisible process is surfaced just-in-time, one concept per moment.