Capstone

Unit 7 · Design Practice·Module 20 of 20·45 min

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

StageTimeWhat happens
Pick and frame5 minState the system and who owns it. One sentence on what finished looks like, agreed out loud before anything is drawn.
Work the sheet20 minDown the worksheet as a group. Leave unanswerable questions unticked and note who would know.
Draw it15 minPut it in the notation. Elements first, then the transitions, then the exits. Exits last, because they are the ones people skip.
Read the findings5 minWhat 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.

Design worksheet0 / 16 answered
personWhat it servesAgent loop, delegation
account_treeIts shapeAgent loop, delegation and handoff
shieldWhat holds itGuardrails, trust boundaries
logoutHow it endsTyped exits
fact_checkHow you would knowEvaluation unit
edit_noteWork down it as a room. The questions nobody can answer are the output of this 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 likeWhat to do
The room designs the system they wish they hadAsk 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 agentEvery 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 drawnGo straight to the exits. Naming the four ways it fails usually rearranges the rest of the drawing.
One person answers every questionAsk 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 buildingA good sign, and the forty minutes is cheaper than the rebuild. Finish the exits and the findings first, then let them go.
quizCheck

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.