Capstone
By the end of this module
- Design a system for a real decision your team owns
- Draw it, and read the findings the notation reports back
- Leave with a list of the questions nobody in the room could answer
Definition
The last session is not a module. The room designs something real, draws it, and reads what the drawing says back. Everything in the course was preparation for being able to answer the questions below about a system somebody actually owns.
Pick the subject in advance. It should be a decision or a workflow somebody in the room is responsible for, small enough to draw in forty minutes, and something at least one person disagrees about. A system everyone already agrees on teaches nothing.
Running the Session
| Stage | Time | What happens |
|---|---|---|
| Pick and frame | 5 min | State the system and who owns it. One sentence on what finished looks like, agreed out loud before anything is drawn. |
| Work the sheet | 20 min | Down the worksheet as a group. Leave unanswerable questions unticked and note who would know. |
| Draw it | 15 min | Put it in the notation. Elements first, then the transitions, then the exits. Exits last, because they are the ones people skip. |
| Read the findings | 5 min | What does the drawing report that nobody wrote? Unmodelled exits, prompted obligations, empty hook points. |
One person drives the drawing and does not decide anything. The useful split is that whoever owns the system answers the questions, whoever knows the notation writes it down, and everybody else argues. A room where the person at the keyboard is also the person deciding produces their design rather than the room's.
The Worksheet
Work down this as a group. The questions nobody can answer are the output of the exercise, not a failure of it.
A Worked Answer
A finished example lives in this repository at course/reference-design.puml. It is the payout assistant the course has been using throughout, written in the agentic notation, and it is deliberately imperfect: seven exit types unmodelled, one obligation enforced by nothing, five hook points empty.
Use it as a comparison at the end rather than a template at the start. A room that sees it first tends to reproduce its shape, including its gaps. A room that draws its own first gets the more useful experience of finding different gaps and having to defend them.
What Good Looks Like
The session has gone well if the room leaves with these four things, and none of them is a finished design.
- A drawing that someone would be willing to show a colleague who was not there.
- A list of exits the system can reach and cannot currently record.
- A list of obligations that turn out to be instruction, with a decision on each about whether that is acceptable.
- The name of a person to go and ask, for every question the room could not answer.
Failure Modes of the Exercise
| What it looks like | What to do |
|---|---|
| The room designs the system they wish they had | Ask what it does today. Draw the current one first; the better version is a second diagram and a much easier conversation once the first exists. |
| Everything becomes an agent | Every agent is a model call on the critical path. Ask what would break if two of them were one, and most of the time the honest answer is nothing. |
| Only the happy path gets drawn | Go straight to the exits. Naming the four ways it fails usually rearranges the rest of the drawing. |
| One person answers every question | Ask the quietest engineer what happens when the second tool call fails. The people who operate a system know different things from the people who designed it. |
| The room wants to start building | A good sign, and the forty minutes is cheaper than the rebuild. Finish the exits and the findings first, then let them go. |
Forty minutes in, the room cannot agree whether a compliance check is a control or a requirement. What is the best use of the remaining time?
After the Course
The knowledge base this course sits inside goes further on most of these topics, and the modules link into it throughout. The two worth reading next depend on which way the room leaned: Decision Models if the interest was in making the cheap decisions cheaply, and Agentic Zero Trust if the uncomfortable conversation was about blast radius.
The more useful follow-up is not reading. It is running the worksheet again, on a different system, in three months, and seeing how many of the questions have better answers.
