Read more · slide 01 / 07 · the purpose
The real purpose.
Rigour is not there to produce documents. It is there so the people who rely on the work know what they will get, and then get exactly that.
-
1
Specified
What it must do, how it works, how it looks. Written down first.
functionaltechnicalvisual
-
2
Agreed
Read and approved by the people who rely on it, before anything is built.
-
3
Met
Built to what was agreed, proved by checks, and kept true when it changes.
every slide that follows comes back to these three
you the agent builds · you decide, at each step that matters
Where surprises come from
Most disappointments in a build are not bugs. They are expectations that lived in someone's head: the delivery day nobody mentioned, the button that was meant to be the only one, the total that had to come from the server.
An AI agent does not remove that gap. It fills it, quickly and confidently, with its own guess. Vibe coding accepts the guess. Rigour closes the gap before the agent starts.
Three properties, one method
The goal is output that is sustainable, easy to maintain and agreed. Each one comes from one of the three principles.
- Sustainable because it is specified. The next build starts from the same written documents, not from what someone remembers.
- Agreed because the people who rely on it read and approve the same pages, before anything is built.
- Easy to maintain because it is met and kept true. A change starts in the spec, the old version is kept, and the build is proved against the new one.
Focused, not heavy
A good spec is short. It says what this piece of work must do, how it will work and how it will look, and nothing else. The aim is focus: a clear target the agent can hit and a reviewer can check.
That is what "met to a t" means here. Not perfection in the abstract, but a result that matches what was written and agreed, line by line.
When it is too much
For a quick prototype or a throwaway idea, vibe coding is fine. This way of working comes from decades of running IT and digital programmes. For a very small job it may be more than you need. For work that has to be right, it earns its keep.
Who it suits, and what it asks of you, is on As much as the work needs.
Carries forward: the three principles from slide 01. Slide 03 opens the first one, Specified.