SYSTEM DESIGN
FIELD NOTE 02 / 06The prompt is not the system.
Revenue teams keep treating AI like a very talented freelancer with no manager, no operating manual and no definition of done. Then they blame the prompt when the work drifts.
Stop specifying what the AI should say. Start specifying how the work should happen.
SHARE THIS FIELD NOTE
Pass the useful signal on.
We mistook an instruction for an operating model.
The first wave of workplace AI taught everyone the same ritual. Open a blank box. Explain what you want. Inspect the answer. Add three more adjectives. Repeat until the work looks plausible or the meeting starts.
This is useful for personal tasks. It is a poor foundation for revenue work that repeats across people, systems and customers. A prompt describes an output. It rarely defines who owns the decision, which data is authoritative, what the AI may change, how quality is judged or what happens when the situation does not fit the happy path.
The result is prompt folklore. One colleague has a magic paragraph. Another has seventeen examples in a document called FINAL_v6. The organisation has activity, but no shared system it can inspect or improve.
A prompt can start the work. It cannot govern the work.
The specification is becoming the valuable artefact.
Software teams are rediscovering specifications because AI can generate implementation faster than humans can explain intent. In spec-driven development, the important work moves upstream: define what the system must do, turn that into a plan, decompose the work, then let an agent implement against explicit constraints.
The same inversion matters for revenue teams. If an AI system prepares account research, the specification should not begin with tone of voice. It should begin with the decision the research supports. What must the seller know before the call? Which sources are allowed? How recent must a signal be? Which claims require a citation? What should be omitted when confidence is low?
Once the specification is explicit, prompts become implementation details. Models can change. Tools can change. The commercial intent remains legible.
Specify the revenue system in five parts.
A useful specification is not a 90-page requirements document. It is a compact contract between the business, the people doing the work and the system acting on their behalf.
Intent → Context → Decisions → Actions → Evidence
- 01Intent
The commercial outcome and the user decision the system exists to improve.
- 02Context
Authoritative inputs, recency rules, exclusions and the business knowledge required.
- 03Decisions
Judgements the system makes, thresholds it uses and cases it must escalate.
- 04Actions
What it may draft, recommend, update or send, including approvals and permissions.
- 05Evidence
Quality checks, outcome measures, logs and feedback used to improve the next run.
A specification defines the shell that makes variable model behaviour dependable.
Stop asking AI to behave like software.↗“Research this account” is a request. Not a system.
Suppose a sales team wants AI-generated pre-call briefs. The request sounds simple. The hidden decisions are not. Which company is the account when names collide? Does a job advert count as evidence of a strategic priority? How old can a funding announcement be before it becomes trivia? Should the system infer pain from a technology choice?
A system specification makes those questions visible before they become inconsistent output. It can require two sources for material claims, separate observation from inference, ignore signals older than six months, show uncertainty and ask for approval before anything enters the CRM.
The generated brief may still vary. The process around it should not. Inputs, permissions, decision rules, checks and ownership can remain explicit even when language is probabilistic.
- Define the decision before the deliverable.
- Name the authoritative sources before connecting tools.
- Write the exception before polishing the happy path.
- Choose the approval point before granting autonomy.
- Decide what evidence changes the specification after launch.
A specification should learn without becoming folklore again.
The first specification will be wrong. Real customers produce exceptions that workshops do not. The objective is not to predict every edge case. It is to give new knowledge somewhere to go.
When a brief repeatedly mistakes subsidiaries for parent companies, update the entity rule. When sellers ignore a section, inspect whether the information is weak or merely badly placed. When a compliance reviewer rejects a claim, change the evidence threshold. The system improves because operational feedback changes an explicit artefact, not because somebody quietly adds another sentence to a private prompt.
This is the shift from using AI to operating AI. The prompt stops being the product. The managed loop becomes the product.
SOURCES & FURTHER READING
Follow the thinking.
The social post that prompted the broader operating-system argument.
↗02GitHub Spec KitGitHub's specification-driven workflow and reference material.
↗03Spec-driven developmentThe case for specifications as the primary artefact rather than disposable documentation.
↗