Sales

Documentation Is Not the Deal

Working Draft · August 2026

Force an expert to record every step of a tacit craft and you get one of two things: a performance you have wrecked, or a story you invented afterward to satisfy the file. That is what the sales pipeline does to a salesperson. The tell is that the deal was closed by the one faculty the form cannot hold.


Every serious sales organization runs on a discipline with a name, MEDDIC, or one of its cousins, and the discipline is a demand: document the deal. Log the metrics, the economic buyer, the decision criteria, the decision process, the pain, the champion, and log them as you go, on every opportunity, every week. The premise underneath the demand is that the salesperson’s judgment is a black box, opaque and not quite to be trusted, and that the cure is to pry it open and make each step legible, so a manager can see inside and a company can own what it sees. It is a reasonable-sounding premise. It is also wrong, and the fastest way to see how wrong is to carry the same demand into a room where we already know the answer in our bones.

The one question that sorts it

Ask a single question and every profession sorts itself: is the document the deliverable, or a description of one? For some experts the document is the whole product. A medical examiner’s actual output is the autopsy report, read and contested in a courtroom, and the value lands precisely on the page. A claims adjuster’s deliverable is a documented, defensible determination that someone pays out on. The county assessor, the controller signing the financials, the scientist whose paper and lab notebook are the reproducible result, all of them are paid to convert judgment into a legible record, and demanding rigor of them is not overhead, it is the job. Notice that they run on deep tacit judgment too, the examiner reads a body, the adjuster reads a scene, but their work is to translate that judgment into a determination others can act on. For them, the document is where the value lives.

Now the other kind. A surgeon’s deliverable is a healed eye. A firefighter’s is a dead fire. A comic’s is a room that laughed. For these, the document only ever describes the outcome, and the judgment that produced it stays tacit and does its work directly. Nobody needs to read how the eye was fixed for the eye to be fixed. And a salesperson’s deliverable is a closed deal, which is why the pipeline entry is not the product but a description of one, and a thin description at that. The salesperson is in the second group, and the whole error of the sales pipeline is treating them as if they were in the first.

Narrate the incision

Make an expert in the second group document the first group’s way, in real time, and you meet the first failure mode. Tell a surgeon to log each of the roughly two hundred micro-adjustments of their hands as they make them, and you have blinded the patient. Gary Klein spent years asking fireground commanders how they decide, and the answer kept coming back as a version of I do not make decisions, I just know, because the expert reads the color of the smoke and the feel of the floor and acts on a recognized pattern, with no discrete steps to log. Make a tour golfer record a swing-thought rationale before every shot and you have not observed their game, you have prescribed the yips, the centipede asked which leg moves first and never walked again. Hubert Dreyfus mapped the mechanism decades ago: the novice follows explicit rules, the expert has dissolved the rules into intuition, and dragging the expert back to articulate the rules actively regresses them toward the novice. You do not measure the performance by demanding the log. You degrade it.

The fiction written after

Fine, say the enforcers, then log it afterward, once the work is done. Now you get the second failure mode, which is a fiction. A record produced after the fact is a reconstruction, cleaned up for the reader, not a transcript of the tacit process that actually did the job. The most prestigious example on Earth is the judicial opinion. A judge issues a fully documented chain of reasoning, and a century ago the legal realists took it apart. Judge Hutcheson wrote a famous little confession, The Judgment Intuitive, admitting that the decision arrives first, as a hunch, and the opinion is composed afterward to justify it for the file. The police report is the same, written at a desk from a stop that happened at the roadside. And the pipeline entry the rep fills in after the call is the same again, a tidy account of metrics and champions, assembled to satisfy a manager, describing a deal that was actually felt out in real time across a table. The form is not lying, exactly. It is doing the only thing a post-hoc form can do, which is to invent a legible account of an illegible act.

It is not a document, it is surveillance

Here is the part the word documentation hides. A modern CRM is not a document at all. It is a live database, and the manager reads it inside the system, in real time, watching the rep’s logged activity accumulate long before anything is ever printed for a pipeline meeting. That is not documentation, it is surveillance, and the difference matters, because a document is something you author and a feed is something done to you. Which raises the one profession that exposes the whole arrangement: the criminal. A criminal’s entire craft is anti-documentation, to leave no legible trail, and the only party who ever forces a record out of them is the state, after capture, in the form of a confession. That is what the pipeline actually is. Not a tool the salesperson wields, but a record extracted from the performer for an authority, a confession about work whose real substance no confession can hold. The rep is not writing up their craft. They are being made to account for it, to someone watching.

Why they want it anyway

So why does the organization keep demanding the impossible? Not out of stupidity, out of a real and unmet hunger, for legibility. Michael Polanyi named the underlying fact in a single line, we know more than we can tell, and James Scott showed what institutions do about it, which is to force the illegible into legible form so it can be measured, audited, and owned. That is the honest motive beneath the sales pipeline. The rep’s judgment is the company’s most valuable asset, and it walks out the door every night inside the rep’s head, so the company builds machinery to filet the expertise out of the expert and keep it on a server. The trouble is that the filet kills the fish. Tacit judgment does not survive extraction. You can interrupt it and get a worse performance, or you can reconstruct it afterward and get a fiction, but you cannot lift it out intact and store it, because the knowing was never separable from the knower. The engineer’s commented code is the closest anyone comes, and even that works only because a good comment records the one non-obvious decision for a real future reader, never every keystroke, which is the exact opposite of every step, every time.

What the form cannot hold

The deal, when it finally closes, is closed by the same faculty that removes the cataract and reads the smoke and finds the judge’s hunch: tacit, embodied, relational judgment, the reading of a human being across a table in real time. That faculty is precisely what the form cannot hold. So the pipeline fills with metrics and stages and champions, an elaborate and legible account of the deal, and it captures everything about the deal except the part that did the work. This is why the machinery feels so busy and predicts so little, and why the best reps treat the CRM as a tax rather than a craft. Keep a record, by all means, when a real downstream reader genuinely needs one. But do not mistake the record for the thing. The autopsy is the examiner’s deliverable. The healed eye is the surgeon’s. The closed deal is the salesperson’s, and the documentation of it, however rigorous, however surveilled, however dutifully confessed, is not the deal.

Touchstones: Michael Polanyi, The Tacit Dimension (1966), we know more than we can tell; Gary Klein, Sources of Power (1998), recognition-primed decision-making among firefighters; Hubert and Stuart Dreyfus on skill acquisition and the expert’s regress under forced rule-following; Joseph C. Hutcheson, The Judgment Intuitive (1929), and the legal realists on the hunch that precedes the opinion; James C. Scott, Seeing Like a State (1998), on legibility and metis. A companion to There Is No Such Thing as a Marketing Qualified Lead.