Skills

Specification Beats Prompting

Prompting is a technique with a half-life of months. Specification is a discipline, and it is what the technique is standing in for.

My Career Crusader8 min read815 words

The interfaces improved, the systems got better at inferring intent, and the specific tricks stopped mattering. What remains underneath is older and considerably more durable: the ability to state precisely what you want, under what constraints, and how anyone will know whether they got it. Engineering calls this a specification. Procurement calls it a requirement. Most professions have no word for it, which is part of why so few people are good at it.

Why it became the bottleneck When work was expensive to produce, a vague brief was affordable. You described roughly what you wanted, someone spent two days on it, you looked at the result and corrected course. The cost of ambiguity was absorbed by the cost of production. Production is now fast enough that ambiguity is the expensive part. A vague request produces a confident, fluent, well-formatted answer to a question slightly different from the one you meant — and it produces it quickly enough that it gets circulated before anyone examines it. There is a second effect that matters more. A human junior given a bad brief pushes back. They ask what you meant, they flag the contradiction, they notice that two of your requirements are incompatible. That friction was doing enormous unacknowledged work, and it is gone. Nothing now absorbs your ambiguity on your behalf.

What a specification contains Four parts. Most people write the first and stop.

The output. What is being produced, in what form, for whom, to be used how. "A summary" is not a specification. "A one-page summary for a partner who has not read the file, focused on what

changed since the last hearing" is.

The constraints. What must be true, what must not appear, what the boundaries are. Length, tone, jurisdiction, timeframe, sources permitted. Constraints are where domain knowledge enters, and they are the reason a specification cannot be written by someone who does not know the field. The failure modes. What going wrong looks like. This is the part that separates a real specification from a wish. If you have done the work before, you know how it goes wrong — the thing people always get backwards, the figure that is usually stale, the caveat that always gets dropped. Writing those down converts your experience into something transferable. The acceptance criteria. How you will tell whether it is right, specifically enough that two people checking would reach the same verdict. Most professional work has never had this articulated even for human output, which is why quality conversations in most organisations are so unproductive.

Practising it You can build this deliberately and the practice is not abstract.

Take a piece of work you routinely delegate or produce, and write the specification for it as though handing it to a competent stranger. Then actually hand it over — to a colleague, or to a tool — and see what comes back. The gap between what you meant and what you got is your specification error, and it is instructive in a way that no amount of reading is. Do this five or six times and something shifts. You stop describing outputs and start describing conditions. That shift is the skill. The second practice is to write acceptance criteria for work you receive. When someone brings you something to review, notice that you are applying criteria you have never stated. Write them down. Within a month you will have converted a large amount of tacit standard-setting into a document, which is both a specification and, incidentally, the most useful training material your team has ever had.

Why this is a position, not just a technique Specification is the work that survives automation of a task, because someone has to define what the automated thing should do and what correct looks like. That someone must know the domain, must have done the work, and must be able to articulate standards that were previously tacit. It is a small group in any organisation, and it is a much smaller group than the set of people who can do the task. Being in that group is the single clearest route from executing work to defining it. And unlike most repositioning moves, it does not require permission — you can start writing specifications for work you already do, today, and the artefacts you produce make the case on their own.

The uncomfortable corollary

Writing a good specification for your own work makes that work more automatable. This is true and it is not a reason to stop. The choice is not between the work being specified and not specified. It is between you writing the specification and someone less informed writing a worse one. In the first case you own the definition of correct. In the second you are described by it.

people checking the output would reach the same verdict. Most professions have never written these down for anything.

Apply this to your role

How exposed is your own week?

The free AI Exposure Audit breaks down your working week by automation risk — and gives you a personalised 30/90/365-day action plan. No account required.

Take the free audit
Share this articleXLinkedInFacebook