Example

Decide, then build

A choice that holds up several pieces of work is written once, as a decision beside the work it holds, and the answer is what starts all of it.

5 steps, driven by a person and an agent. Every step is a step in an end-to-end test, run against a listening server on every pull request, so the graph moves the way the run moved it.

Why it is shaped this way

An engineering PRD is really two things: a choice somebody has to make, and the implementation that follows from it — here two pieces, a job and a screen, that cannot start until the choice is made. A choice that holds one task is that task waiting on whoever decides; one that holds two is a decision of its own, held by the person who decides, that blocks each of them. The pieces stay active, because they are committed work: what holds them is the open decision, and readiness already says so. Nothing is offered to an agent while the question is open — the answer is a person's — and closing the decision with its answer is the whole of what makes both pieces ready. The answer stays where it was given: a change of mind later is a new decision that supersedes it.