Start here · Beginner
Getting Real Work out of a Model
Draft, open for academic review
You already use ChatGPT, Claude or Gemini. This is how to stop getting average answers.
Your progress here is recorded once you pass the AI, Actually Explained exam.
The film · 15 min
You already use ChatGPT, Claude or Gemini. This is how to stop getting average answers.
95 MB · captions in English · nothing downloads until you press play
Read the transcript
There is no secret vocabulary
Most advice about prompting is a list of phrases. This course is not that. It starts one level down, with what actually happens when you press send, because almost every technique that works is a consequence of that mechanism, and almost every technique that does not is a guess about a different machine. Over the next twelve minutes we walk the whole course, from the block of text the model receives to the checking you design in advance. There is no secret vocabulary here. There is a habit of under-describing your own problem, and you can drop it.
1. What a prompt actually is
One flat block of text
Your message is not what the model receives. The product assembles one flat block of text: a system prompt you did not write, the whole conversation so far, and your new message at the end. It reads that, answers, and forgets. There is no memory. When you send message twelve, messages one to eleven are re-sent as text, which is why a mistake in turn three is still in the room at turn thirty. There is no formatting either. Bold, colour and cell borders do not arrive. And the block is counted in tokens rather than words. This figure shows the same seventy-five word passage in five languages. English is the cheap case. Hindi, Bengali and Tamil cost two to four times as much.
Why the same prompt gives a different answer
Send the same prompt twice and you get two different answers. That is not the model changing its mind. At every step it produces a probability for every possible next token, and something outside the model picks one. That picker is the sampler, and its main setting is temperature. Low temperature where there is a right answer, higher when you want range. Two things follow. Pressing regenerate draws again from the same pile, so if the prompt is the problem, every draw comes from the same wrong pile. And a prompt that worked once has not been tested. Run it five times over the same three items before you run it over two hundred. What moves between those five runs is what you left to chance.
Six slots, and what is not among them
A working prompt fills six slots. The task, which is a verb, an object and a finished state. The context, which is the material itself plus the facts that change what a good answer is. Examples, where a rule is easier to show than to state. Constraints, few and checkable. The output shape, including what to leave out. And the escape hatch, which says what to do when the task cannot be done as asked. Most disappointing prompts have filled one and a half. Not on that list: no persona, no years of experience, no offer of a tip. Those came from narrow studies on the models of twenty twenty-three, and their effects are usually smaller than the variation between two runs of an unchanged prompt.
2. The material you give it
Paste the source, not your account of it
Context is most of the job, and one mistake dominates all the others. People describe their problem instead of showing it. My colleague sent a rude email and I want to reply firmly. Every important word there is your interpretation, and your interpretation is the thing you wanted help with. Any document task has three layers. The artefact itself. The surrounding facts, with dates. And your reading of it. The first two are what the model cannot get anywhere else. The third is worth including as a question, never as the input. So paste the email, the traceback, the clause, the header row and five real rows. And if you cannot paste, redact and paste, because the meaning is carried by the clauses rather than by the names.
Where the instruction goes
Once a prompt runs longer than a page, position stops being neutral. An instruction before long material helps the model read purposefully. An instruction after it is followed more reliably, because the request sits close to the answer. Those pull in opposite directions, so do both. The task in one sentence at the top, the material in the middle, the precise instruction again at the bottom, for about twenty words. This figure shows the other half of it. Material in the middle of a long context is used less well than material at either end. Newer models handle it better, and better is not solved. So put the most important document last, say where to look, and prefer the twelve-page extract to the three-hundred-page manual.
What actually happens to an attachment
Attaching a file is not the same as pasting it, and four things can happen. The text layer is pulled out and the layout is lost. A scan goes through character recognition, where a three read as an eight looks exactly like a fact. The page is sent as an image. Or the document is chopped into chunks, indexed, and only the passages that look relevant reach the model. That last one produces a specific and nasty failure. Ask whether a contract mentions arbitration anywhere, and a negative answer might mean the arbitration chunk was never retrieved. So ask first. How many pages did you receive, what is the first line of page one, and what is the last line of the document.
3. Teaching by example
Examples teach everything they share
Some things are easier to show than to describe, which is why a handful of labelled examples can carry a boundary that three paragraphs of rules cannot. The catch is that examples transmit everything they have in common, not only the part you were thinking about. This figure is a real case. Four of five examples labelled refund, and refund becomes the safe guess. The same thing happens with length, with politeness, and with language. If every example is formal English, a customer writing in Hinglish gets formal English back. The audit takes one minute. Read your examples as a set, ignore the content, and finish this sentence four times: all of these are something. Whatever that something is, you have taught it.
The awkward case, and proving it helped
Choose examples where a careful person could have got it wrong. Three variations of where is my parcel teach nothing. The information lives where two reasonable people would disagree, and you find those by labelling fifty real items and keeping the ones where you hesitated. Then state the rule and show it, with a short reason beside each label, because an example on its own does not say what it is an example of. And check that the examples helped. Ten held-out items, three runs of each version, and count. This figure shows the two results you will actually get. Ranges that do not overlap, which is a real difference. Or ranges that overlap completely, which means your examples cost tokens and bought noise.
4. The shape of the answer
Reasoning first, structure last
Format is part of the request. Say the container, say what to leave out, and say what to do about gaps. Write not stated rather than inferring, because a missing figure otherwise becomes a plausible one, and a plausible figure is much harder to catch than a blank. But there is a trade, and this figure is about it. Ask for a bare score from one to ten and nothing else, and the scores will look arbitrary, because the text is where the work happens and you asked for the conclusion with the working removed. So make room first. One sentence of specific reasoning per item, then the tidy block at the end.
Build the failure into the format
You cannot verify forty rows carefully, whatever you say at the start. What you can do is build the failure into the shape of the output, so the rows needing attention identify themselves. Four devices, all cheap. A stated empty value, so a gap stays visible instead of being filled. A source column carrying the exact sentence each value came from, checkable in four seconds with a text search. A confidence field with three mechanically defined values, rather than a percentage calibrated to nothing. And a permitted refusal, with a shape, that names what is missing. None of this makes the values right. It buys visibility, which is a smaller claim and a much more useful one.
5. Making it work the problem
Which tasks get better with steps
Think step by step is not a general upgrade. It helps when a task has dependent intermediate results, because the intermediate text is where the work gets done. Conversions, scheduling under constraints, checking a contract against nine requirements. It adds words and no accuracy to recall, translation, tone work and easy classification. So name the intermediate you want rather than asking for steps in general. List the constraints, then check each option against each one. Quote the sentence you are relying on, then interpret it. Show the figures you used and where each came from. And hold this steady: shown reasoning is not a log of how the answer was made. It is material to check.
Ask for the method, not the number
A model generates digits the way it generates words. There is no arithmetic unit, so long multiplication, percentages of awkward numbers and columns of forty figures all drift, quietly. Ask for the method, not the number. Write the Python and run it, or give me the spreadsheet formula and explain what each part refers to. This figure shows what that buys and what it does not. Arithmetic error falls to almost nothing. Extraction error does not move at all, because code computes a perfect total of whatever figures it was given. So print the parsed rows and the row count before the total. Check the inputs, the operation and the count, and let the interpreter be right about the sum.
6. From lucky to reliable
Four reasons an answer is bad
When an answer is bad, name the cause before you fix it. There are four. It did not have what it needed, and the symptom is an answer true of a category rather than of your case. It misread what you wanted, and you got a good answer to a different question. The output is in an unusable form, where the content is right and the shape is wrong. Or the task is beyond the tool. Work through them in that order, because the first is the commonest and the cheapest to fix. And learn the tell for the fourth: better prompting produces a better-looking wrong answer. If your third attempt is more polished and equally wrong, stop rewriting and change the approach.
One change, ten items, three runs
For a prompt you will reuse, change one thing at a time against the same fixed items, several runs each, and then keep or discard explicitly. The discard step is the one everybody skips, and it is why inherited prompts grow to twelve elements nobody dares remove. Keep five to ten items forever. Two ordinary ones, three or four hard ones taken from real failures, and one whose correct answer is a refusal. That last matters because the ability to correctly not answer disappears silently, and its failure produces a fuller-looking result rather than a broken one. Run them after any change to the prompt, after a model update, and monthly if the prompt runs unattended.
7. Checking the answer
Fluency is not evidence
A model does not sound unsure when it is unsure. Fluent, calm prose is its resting register, and it uses that register for a verified fact and for something it produced whole. Worse, fabrication can be more specific than the truth, because a citation is a highly patterned string, and one assembled from the most typical parts fits that pattern better than the messy real thing. So treat precision as a flag rather than a comfort. Three separate checks, in this order. Does the source exist. Does it say what is claimed. And does what it says support the inference. The first takes thirty seconds and catches the famous failure. The second and third are the ones that get into published work.
Sort by the cost of being wrong
Never verify by asking whether it is sure. That is a leading question aimed at a system trained towards agreement, and it will talk a model out of a correct answer as readily as a wrong one. Ask instead for the strongest argument that the answer is wrong, or offer two candidates without saying which you prefer. And remember the failure that leaves no mark. A summary of four payment terms that covers three reads exactly like one that covers four, so enumerate and count before you analyse. Then sort by consequence rather than by confidence. Check nothing when nothing is at stake. Spot-check what is recoverable. Verify independently anything expensive or irreversible.
8. The work you actually have
A sixty-page document, properly
Put it together on a real job. A sixty-page tender. The instinct is to ask for a summary, which hands you somebody else's selection with no way to tell what was dropped. Instead, map it: list every section heading in order, with a count. Locate the three sections your question actually lives in. Extract with quoted sentences and clause numbers, keeping any condition inside the quoted sentence. Verify two of those quotes by hand against the paper. And only then summarise, over a short structured input rather than sixty pages. It is about eight minutes slower, and it is the difference between an account you can defend and one you are merely repeating.
Three files
This course leaves you with three plain text files, and they are worth more than any template you will ever be sent. A file of prompts that worked, each with its date, the model it was tested on, a line saying when to use it, and a note explaining the odd-looking constraint that is doing the work. A file of examples from your own archive, drawn from the cases where you hesitated. And ten test items with the answers you would accept, one of which should produce a refusal. Nobody else can build those for you, because they encode what your work actually requires. Keep the corrections, and the files assemble themselves out of ordinary work.
8 modules. 72 lessons.
What a prompt actually is
9 lessons · 1 h 12
You will be able toExplain what happens to a prompt between the send button and the answer (tokenisation, a single re-sent string, sampling, instruction tuning, and the product wrapped around the model) and use that mechanism to predict which prompt changes will help and which are folklore.
- 1.1Why the same question gets a better answer
- 1.2What the model actually receives
- 1.3Why the same prompt gives a different answer
- 1.4Why it obeys you at all
- 1.5A role is not a task
- 1.6The six things a working prompt contains
- 1.7Magic words, and what the studies actually found
- 1.8How much detail is too much
- 1.9Why the same prompt behaves differently in different apps
An illustrative case, built from documented patternsSix hundred handouts and a page of magic words
The Department of Computer Applications at a government polytechnic in Coimbatore runs a forty-hour employability module for final-year students. Placement season starts in November. For two years the module’s most popular handout has been four pages titled “50 Power Prompts”, collected by a lecturer, Mr Balan, from social media posts and a video series. It opens with “You are a world-class career coach with 20 years of experience”, includes “take a deep breath and work through this step by step”, and ends with a note that offering the model a two hundred dollar tip improves results.
Six hundred copies had been quoted for by the campus press. The head of department, Dr Selvi, had approved the spend. Printing was booked for Friday.
On the Tuesday a student called Aarthi came to Mr Balan with a problem he was not expecting. She had used prompt 14 (the world-class career coach one) to write a covering letter for a testing role at a firm in Chennai. The letter was fluent and said nothing. She had then written four lines of her own naming the advert’s three requirements and the one project she had actually done, pasted her CV underneath, and asked again. The second letter was better, and she wanted to know why the handout had not told her to do that.
Mr Balan did the thing the handout did not. He took ten past adverts and ten real CVs from students who agreed to it. He ran the handout’s prompt over all ten, three times each, and scored every letter out of four on a checklist: does it name a requirement from the advert, does it cite something from the CV, does it avoid inventing experience, is it under three hundred words. Then he ran a plain version with no persona, no breathing, no tip, with the advert and the CV pasted in full.
The handout version scored 21, 19 and 22 out of 40. The plain version scored 31, 33 and 30.
Neither total was the interesting part. The interesting part was that three runs of the same unchanged prompt differed by three marks on their own. That meant any single before-and-after demonstration (the kind that fills the posts the handout was assembled from) could show whatever the person running it was hoping to see, and could show it honestly, without anybody lying.
He found a second thing he had not gone looking for. Two students had drafted in Tamil and asked for a translation, and both had run into the tool’s message limit on a document that in English would have fitted easily. The same passage in Tamil was costing roughly three times as many tokens. The students working in their first language had a smaller working space than the students working in their second, and nothing in the interface said so.
So there was a decision, and both sides of it cost something real.
Reprinting meant rewriting the handout in three weeks, which the campus press could not absorb. The next slot was late November, by which point the module would be half over and six hundred students would have started placements with no material at all. Part of the approved spend had already gone on plates.
Not reprinting meant handing six hundred students a document that Mr Balan could now demonstrate was worse than a page of plain advice, in a module whose entire purpose was to get them hired.
Dr Selvi’s objection was not that he was wrong. It was that “we measured it and the magic words did nothing” is a hard sentence to say about a document the department has taught from for two years, and that the handout was popular precisely because it looked like secret knowledge. A page that says paste the advert, paste your CV, name the hard part and say what you will not invent looks like something the students already knew.
How it played out
They cancelled the four-page handout and printed a single A4 sheet, which the press could fit on the Friday slot because it was one plate rather than four. The sheet had six headings (the task, the material, the examples, the constraints, the shape, the escape hatch) and, on the back, one worked covering letter built slot by slot from a real advert and a real CV.
The magic-word page was not thrown away. Mr Balan kept it as the module’s second exercise: students run three of its prompts and the plain version over the same three adverts, three times each, and score them on the four-point checklist themselves. Roughly a third of each cohort now reports that a phrase they were sure had helped moves the score by less than the gap between two runs of the identical prompt.
The Tamil token finding went into the module as a separate ten-minute demonstration, because it changes what students do rather than what they believe: draft long documents in whichever language you are working in, but expect a Tamil or Malayalam paste to fill the window two to three times faster than the English equivalent, and split it.
The honest cost was borne by the first cohort. The new sheet went out without the two extra pages of worked examples Mr Balan wanted, because there was no time to write them, and the November batch had to be taught those from the board. Dr Selvi’s other prediction was also correct: the sheet is less popular. Students who used to ask for more prompts now ask for more examples, which is more work for the department and better for them.
Worth arguing about
Mr Balan’s plain prompt scored higher on all three runs. Why was the three-mark spread between runs of the same prompt more important than the gap between the two versions?
One answer
Because it sets the size of the effect he can detect at all. Variation between runs comes from the sampler, not from the model changing its mind, so a difference smaller than the run-to-run spread is invisible without careful measurement. That is exactly the size of most of the effects reported for magic phrases, and it means a single before-and-after demonstration proves nothing either way. It also tells him what to do next: to claim a small improvement he would need many more items, not more confidence.
The handout’s persona line was not merely useless. What was it costing?
One answer
The place where the useful information should have gone. Every sentence of role-play and motivation occupies context and dilutes the instructions that matter, and in this case it stood in for the advert and the CV: the two things the model could not possibly get anywhere else. A prompt that opens with three sentences of costume and then asks a vague question is worse than the same prompt with those sentences replaced by the material.
Aarthi’s four extra lines were not a technique she had been taught. What were they doing, in terms of the six slots?
One answer
She filled the two slots the handout left empty. Pasting the CV and the advert supplied the context; naming the three requirements and the one project she had actually done set a finished state rather than a topic. The persona had filled none of the six. Her letter improved because the question stopped being answerable generically, not because she found a better phrasing.
Test yourself6 questions on this module
A wrong assumption you introduced in turn three of a chat keeps colouring answers at turn thirty, even after you corrected it twice. What is the mechanism?
A prompt produced correctly formatted output the first time you ran it. You are about to run it over two hundred customer messages. What should you do first?
You give eleven constraints in one prompt. The answer satisfies eight, silently drops three, and reads as though it satisfied all eleven. Why does nothing announce the omission?
A prompt opens “You are an expert lawyer with 20 years of experience. Review my contract.” Changing twenty to thirty years does nothing. What is the honest account of what the role is doing?
Someone shows you one before-and-after pair proving that adding “take a deep breath and work through this step by step” improved an answer. Why is that not evidence?
A colleague’s prompt works for her and not for you. Before you rewrite the words, what should you check?
The material you give it
9 lessons · 1 h 11
You will be able toAssemble the smallest set of material a task genuinely needs, mark and position it so the model uses it, and diagnose an answer that failed for want of context rather than for want of a better instruction.
- 2.1Context is most of the job
- 2.2Paste the source, not your account of it
- 2.3Marking where your material starts and stops
- 2.4Where the instruction goes, and why it matters
- 2.5The background you should stop retyping
- 2.6Memory, and the notes it took about you
- 2.7What actually happens when you attach a file
- 2.8Choosing what not to include
- 2.9Negative instructions, and why they half-work
An illustrative case, built from documented patternsThe clause that was never delivered
The legal-aid desk runs on Saturday mornings out of two rooms behind a law college in Pune. Six student volunteers see about thirty people a day, most of them tenants with a notice to quit, a withheld deposit, or a landlord who has stopped repairing something. A visiting advocate, Ms Kulkarni, supervises and signs off anything that goes out on paper.
The volunteers had started using a chat tool between visitors, and the answers were poor in a way that took Ms Kulkarni a month to name. A volunteer would type something like: the landlord is being unreasonable about the deposit and the agreement seems to say he can keep it, what are her rights. Back would come a competent paragraph about deposits in general, which the volunteer would then repeat to a woman who had brought her agreement with her, in a folder, and put on the table.
Every important word in that prompt was the volunteer’s own reading. Unreasonable. Seems to say. The agreement was two feet away and had not been shown to anybody.
The obvious fix was to paste the agreement. That was also the thing Ms Kulkarni could not simply authorise. These are real people’s names, addresses, employers and bank details, handed over in confidence at a desk that exists because they cannot afford a lawyer. Pasting them into a commercial chat product means the text is stored on somebody else’s systems, may be retained, and is outside anything the desk can promise a visitor.
Both sides of that had a cost that was easy to state and hard to weigh. Describing the document produced advice about a category rather than a case, and the desk had already, twice, told somebody the wrong thing about a clause nobody had read out. Pasting the document exposed a person who had trusted a room of students with their tenancy.
They settled on a protocol before they settled on a tool: names, addresses, phone numbers, employers and account numbers replaced with bracketed placeholders, the agreement pasted as text, and nothing pasted at all for anything touching a criminal matter or a child. Ms Kulkarni tested it on her own tenancy first and found that the structure of the document survived redaction completely, because the parts that carry the meaning are the clauses, not the names.
The protocol worked and immediately produced a different failure.
A volunteer uploaded a photographed agreement (eleven pages, taken on a phone, slightly skewed) and asked whether it said anything about arbitration. The answer was that it did not, and that the tenant was therefore free to approach the Rent Authority directly. Ms Kulkarni, reading the paper copy over the volunteer’s shoulder, found an arbitration clause on page nine.
Nothing had gone wrong with the reasoning. The product had split the upload into chunks, indexed them, and put in front of the model only the passages it judged relevant to the question. Page nine had not been retrieved. The answer was a confident, well-formed statement about a document the model had mostly not seen, and there was nothing in the interface to say so.
That is when the desk stopped treating an attachment as a document.
The second protocol was three lines long and had to be run before any substantive question: how many pages did you receive, what is the first line on page one, and what is the last line of the document. Then, for anything about a clause: list every section heading in order with its number, and give the total count. Only after that did anybody ask what the agreement actually said, and the answer was required to quote the whole sentence including any words like unless, except, provided that or save where, because Ms Kulkarni had by then collected four examples of a summary that reversed a clause by dropping its qualifier.
The cost of all this is nine or ten minutes per file, on a Saturday when thirty people are waiting and the queue is visible through the door.
How it played out
The desk kept the protocol and lost about four visitors a Saturday to the extra time, which the volunteers minded more than Ms Kulkarni did.
The heading-count step earned its place in the first month. Three uploads out of roughly forty came back with a section list that stopped early or was obviously short, and in each case the file was a phone photograph with two pages skewed enough that the text layer was partial. Those were re-photographed rather than reasoned about. Before the protocol, the same three files would have produced three fluent answers about the two thirds of the agreement that arrived.
The arbitration case was reopened. The tenant had already been told she could go straight to the Rent Authority, and the correction cost the desk an apology and its supervising advocate an evening. Nothing worse happened, which Ms Kulkarni describes as luck rather than as a result.
The redaction protocol turned out to be cheaper than anyone expected. Volunteers assumed removing names would take ten minutes a document; with a find-and-replace it takes two, and the desk now keeps a short list of the fields that must go. What it does not do is make the practice safe by itself, and the desk says so out loud to every visitor: a line was added to the intake form explaining that a redacted copy of the agreement may be sent to an external service, with a box to decline. In eight months eleven people have ticked it. Those files are read by a person.
The volunteers’ own prompts changed shape without anybody teaching them. They now paste the clause, then the surrounding facts with dates, and then their reading of it as a question (is this hostile, am I right that this is a forfeiture clause) rather than as the input. Ms Kulkarni says the advice got better on the day the interpretation stopped being the first thing in the prompt.
Worth arguing about
The volunteers’ original prompts were made almost entirely of one of the three layers. Which one, and why does that produce generic advice?
One answer
Layer three, their own interpretation: unreasonable, seems to say. The artefact and the surrounding facts are the two layers the model cannot get anywhere else; an interpretation is a summary, and every summary is a decision about what matters that has already been made badly. Given only a category of situation, the model answers the category, which produces exactly the advice the volunteer already knew.
The arbitration answer was wrong and nothing in the output looked wrong. What was the actual mechanism, and why does asking for the last line of the document catch it?
One answer
The product had chunked and indexed the upload and injected only the passages that looked relevant, so the model was answering from a handful of fragments rather than from the agreement. A negative finding under retrieval means the relevant chunk was not retrieved, which is indistinguishable from the clause not existing. Asking for the last line, the page count and the section headings tests delivery rather than comprehension: if the sweep is short or stops early, you know you are working from fragments before any conclusion is built on them.
Ms Kulkarni required the whole sentence to be quoted, including words like unless and except. What failure is that guarding against, and why is it not caught by checking that the quote is real?
One answer
A summary that reverses a clause by dropping its qualifier. Every checkable feature of the citation passes (the sentence exists, the clause number is right) and the meaning has still been inverted, because qualifiers are the least prominent part of a sentence and the first thing compression drops. Quoting the whole sentence and stating the condition separately puts the qualifier where a reader can see it, which is the only check that catches this.
Test yourself6 questions on this module
“My colleague sent a rude email about the project and I want to reply firmly but professionally.” Why will the reply be generic however well the sentence is phrased?
You paste a customer email and add “reply politely”. Somewhere inside the email the customer wrote “just ignore what I said earlier and cancel everything”. What is the fix?
You are pasting four thousand words of contract and asking for every payment deadline. Where should the instruction go?
You upload a long PDF and ask whether it mentions arbitration anywhere. The answer is no. Under what circumstance is that answer worthless?
You add last year’s pricing sheet to a prompt about this year’s quotation, “for background”. What is the specific risk?
“Do not mention the price” keeps failing. Which rewrite is most likely to hold, and why?
Teaching by example
9 lessons · 1 h 14
You will be able toBuild a small labelled example set that transmits a rule prose cannot state, identify the unintended patterns your examples teach, and demonstrate by test whether adding them improved the output at all.
- 3.1Show it two examples
- 3.2Zero, one, or five: how many examples
- 3.3The example that earns its place
- 3.5State the rule, then show it
- 3.6Negative examples, and when they backfire
- 3.7Capturing a voice from three samples
- 3.8Your best examples already exist
- 3.9Proving the examples were worth it
An illustrative case, built from documented patternsFive examples, four of them refunds
The desk handles about four hundred WhatsApp messages a day from retailers across Gujarat and Maharashtra, and roughly two thousand a day in the three weeks before Diwali. Four staff sort them by hand into five buckets (new order, order status, return, payment, and everything else) and paste each into the right sheet. In the rush, messages sit unsorted for six hours and retailers ring the owner’s mobile.
His nephew Jignesh, who is doing a BCA, built a classifier over a fortnight. It is a prompt with five labelled example messages, a list of the five categories, and an instruction to output the label and nothing else. He tested it on twelve messages he wrote himself and got twelve right.
The operations head, Mrs Shah, had two objections and only one of them was about the model.
The first was that four of the five examples were returns. She had not read a paper about class balance; she noticed it the way anyone would, by reading the prompt and finding that it looked like a prompt about returns. Jignesh’s answer was that returns were the hard case, which was true and was not a reason for the proportions.
The second was register. All five examples were in clean English. The desk’s actual messages are in Gujarati script, in Hinglish, in transliterated Gujarati, and often in three of those inside one message. Mrs Shah’s exact words were that the examples looked like messages from people who do not buy sarees.
What she wanted was two days: pull one hundred and twenty real messages from the last festival period, have two staff label them independently, and build the example set from the ones they disagreed about. Two days out of a four-day window before the rush begins.
The owner’s position was that the desk was already drowning last year and that a classifier which is right most of the time beats four people who are six hours behind. Two days spent labelling is two days the tool is not running, and the rush does not move.
They compromised in the way small firms do: one day, not two, and sixty messages instead of a hundred and twenty.
The labelling itself produced the finding that changed the prompt. Two staff labelled the same sixty. They disagreed on nine. Not one of the nine was about language. They were about policy: a retailer who says the pieces arrived and two are damaged and asks what to do is a return to one of them and an order status query to the other, and nobody at the firm had ever decided which. A message asking for the balance on an account and also placing an order is one thing to one staff member and two to the other.
Those nine were the example set. Each one got its label and a five-word reason in brackets (classify by what they are asking for, not by what went wrong) and the set was rounded out with two ordinary messages, one in Hinglish and one in Gujarati script, placed last.
Jignesh wanted to keep his original five as well, on the grounds that more examples must be better. Mrs Shah made him test it. The thirty-six remaining labelled messages became a held-out set: version A with his five, version B with the nine annotated ones plus two ordinary, three runs each.
A scored 24, 22 and 25 out of 36. B scored 31, 32 and 31. The combined set, all sixteen examples, scored 30, 28 and 31, which is to say it was no better than B and cost twice the space on every one of two thousand daily calls.
How it played out
They went live with version B on the second day, one day later than the owner wanted and one day earlier than Mrs Shah did.
The class-balance effect was visible before the test and obvious after it. Under version A, thirty-one of thirty-six held-out messages came back as returns across the three runs, including two that were plainly new orders. Under B, which carried roughly honest proportions and a stated line saying that in reality about one message in eight is a return, the over-production stopped.
The register problem fixed itself with one example. Once a Hinglish message with a Hinglish label sat in the set, mixed-language messages stopped being pushed into the formal-English category the desk uses for everything else. Nobody had written an instruction about language at any point.
The nine disagreements had a second life that nobody planned. Seven of them were policy gaps, and the firm settled all seven in a forty-minute meeting: a damaged-goods message is a return, an account query with an order attached is split into two rows, and so on. Two staff had been handling those differently for a year and neither had known. Mrs Shah’s view is that this was worth more than the classifier.
The rush itself went as follows. About one message in nine was mislabelled, which sounds bad and was not, because a mislabelled message lands in the wrong sheet and is noticed within an hour rather than sitting unsorted for six. The four staff still read everything; they stopped typing.
The held-out thirty-six are now a file. When the model behind the tool was updated in February and the desk noticed nothing, the file said 30, 31, 29: a drop of two, inside the noise. When somebody added a sixth category in March without telling anyone, the file said 22.
Worth arguing about
Jignesh’s twelve self-written test messages all passed. Why was that not evidence, and what was different about the sixty real ones?
One answer
He wrote the tests, so they were the cases he had already thought of, which are the cases his examples already covered. Real messages carry the mess: mixed scripts, two requests in one message, a complaint that is really a status query. The twelve measured whether the prompt handled his imagination; the sixty measured whether it handled the desk. The nine disagreements in particular could not have been invented, because they existed only where two experienced people genuinely differed.
The combined sixteen-example set scored the same as the nine-plus-two set. Why is that a reason to remove examples rather than a reason to keep them?
One answer
Because examples are not free. Sixteen examples cost roughly twice the tokens of eleven on every one of two thousand calls a day, they narrow the output towards whatever the whole set has in common, and they shift the class proportions back towards returns. A change that does not measurably help comes out. Redundancy in an example set is not harmless padding: two examples that teach the same thing pull the output in that direction twice.
Seven of the nine disagreements turned out not to be prompting problems at all. What were they, and what does that say about where good examples come from?
One answer
They were policy gaps: the firm had never decided how to treat a damaged-goods message or a combined account-and-order message, so two staff had been deciding differently. An awkward case is awkward because the rule does not exist yet, and no prompt can supply a decision nobody has made. The right response is to make the decision, write it in one line, and attach an example to it, which is why labelling real items where you hesitate surfaces things about the business as often as about the model.
Test yourself6 questions on this module
Four of your five classification examples are labelled refund. What happens, and what is the cheapest correction?
Three of a set’s four examples are variations on “where is my parcel?”, all labelled delivery. What is wrong with the set?
Two nearly identical messages get different labels in your example set. Why add a short reason in brackets after each?
You want output in a specific layout and a rule about what belongs in it. What is the efficient combination?
You paste a malformed JSON example labelled “never do this”. What is the likely result?
Version A without examples scores 7, 6 and 8 out of ten. Version B with five examples scores 7, 8 and 7. What should you conclude?
The shape of the answer
9 lessons · 1 h 13
You will be able toSpecify an output that drops straight into its destination, choose a container that matches the decision being made, and identify which formatting constraints improve an answer and which strip out the reasoning behind it.
- 4.1Ask for the shape you can actually use
- 4.2Length, and what a word limit actually costs
- 4.3Choosing the container
- 4.4Output a spreadsheet or a script can read
- 4.5Hand it the skeleton
- 4.6Writing for the person who will read it
- 4.7The tells, and how to strip them
- 4.8Working across languages
- 4.9Building the failure into the format
An illustrative case, built from documented patternsTwelve policies, one column, three hundred workers
The broker, Mr Deshpande, places group health cover for small manufacturers. A hosiery unit in Nagpur with three hundred workers had asked him to recommend a policy by the end of the month. Twelve insurers had sent quotations, each between eleven and forty pages, most as scanned PDFs, all in a different order.
His assistant Rutuja had a system. She asked for JSON (one object per policy, with a premium, an excess, a maternity flag and a risk score from one to ten) and pasted the result into a sheet that produced a ranked list. It took eleven minutes for all twelve and the output opened cleanly every time.
Mr Deshpande did not trust the risk scores, and could not say why beyond the fact that policy 7 had a 4 and policy 9 had a 6 and he could not see anything in either document that would make that true.
He was right for a reason worth naming. A bare number has almost no text behind it. The scores were being produced with the working removed, so there was nowhere for the assessment to happen. They looked arbitrary because they were.
His own preference was prose. Read each policy, write a paragraph, decide. He had done it that way for eighteen years. Twelve policies at forty minutes each is eight hours he did not have, and the last time he did it under time pressure he had compared an inclusive premium with an exclusive one and had to write to a client to correct it.
The argument had a cost on both sides that neither of them was being unreasonable about. Rutuja’s format was fast, dropped into the sheet, and could not be checked. His format could be checked and would not be finished.
What they built instead had four things in it, and only one of them was about JSON.
First, room for the reasoning before the tidy part: for each policy, one sentence naming the specific exclusion that would matter most to a hosiery workforce, then the structured block. The sentences were readable in three minutes for all twelve and were the part Mr Deshpande actually used.
Second, a source column. Every extracted value had to carry the exact sentence it came from, and any value without a quotable sentence was NOT_STATED rather than a number.
Third, a confidence field with three mechanically defined values: stated, meaning it is written in the document; derived, meaning it was calculated from stated figures, with the calculation shown; and uncertain, meaning interpretation was required, with a reason.
Fourth, a permitted refusal. If a document could not be read at all, the row was to say CANNOT READ and nothing else.
The first run over twelve policies produced eight clean rows, one CANNOT READ, and three rows carrying at least one NOT_STATED. That was the useful result. The CANNOT READ was a scanned quotation photographed at an angle, which nobody would have discovered from a completed table. Of the three NOT_STATED rows, two were genuinely silent documents (neither insurer stated a waiting period for pre-existing conditions anywhere in forty pages, which is itself information a broker can use) and one was a case where the figure sat inside an image of a table and the text extraction had not reached it.
Rutuja’s eleven minutes became about fifty. Mr Deshpande’s eight hours became about ninety minutes, most of which was checking four rows rather than reading four hundred pages.
How it played out
The recommendation went out on time. It was not the policy the risk scores had ranked first.
The thing that decided it was a row that had passed every structural check. Policy 3 had a premium field with a real quoted sentence beside it, a confidence of stated, and a figure that was thirty per cent below the field. The quote was accurate. The sentence was from the section describing the individual plan, not the group floater, and the two figures sit four pages apart in that insurer’s standard document. Valid output, correct source, wrong number.
Mr Deshpande found it in the ninety minutes, by the crudest check available: the premium was out of proportion with the other eleven, and an order-of-magnitude estimate is the first thing an experienced broker does. He describes the source column as the reason he could settle it in forty seconds instead of re-reading the document, and is careful to say it is not the reason he spotted it.
They kept all four devices and added a fifth after this: any figure more than twenty per cent away from the median of the twelve gets flagged in its own column, whatever its confidence value.
The two genuinely silent policies were the finding that made the client’s decision. Neither insurer would state a pre-existing-condition waiting period in writing, and Mr Deshpande went back and asked both. One supplied it in an email: twenty-four months, which took them out of contention for a workforce with a lot of long-service employees. The other did not reply. He now treats a NOT_STATED in that column as an answer rather than a gap, and says so to clients: a supplier who will not state something has told you something, and a blank cell does not carry it.
Rutuja kept the JSON. It comes after the sentences now, and it contains the same fields plus the quote and the confidence, which made the sheet wider and the arguments shorter.
Worth arguing about
Why did asking for a bare risk score from one to ten produce numbers that looked arbitrary?
One answer
Because the text a model produces is where the work happens, and a bare number has almost no text behind it. Asking for the conclusion with the reasoning stripped out leaves nowhere for the assessment to occur, so the score is generated rather than reached. The fix is not to abandon the structure but to make room before it: one sentence of specific reasoning per policy, then the structured block at the end.
Policy 3’s premium row passed every device they had built (real quote, correct clause, confidence of stated) and was still wrong. What does that tell you about what those devices buy?
One answer
Visibility, not correctness. A quoted sentence can be quoted accurately and read wrongly, and a row marked stated can point at the wrong stated figure: here, the individual premium rather than the group floater. What the devices did was separate the rows needing attention from the rows asserting something with a source, turning an unperformable check of four hundred pages into a ninety-minute one. The error was caught by an order-of-magnitude comparison, which is a different check with a different failure mode.
Two policies came back NOT_STATED for the waiting period. Why is that more useful than a plausible figure would have been?
One answer
Because a gap you can see is a gap you can go and fill, and a plausible figure is not distinguishable from a real one. Without an explicit empty value the missing figure would have been filled with a typical one and would have sat in the sheet looking exactly like the ten that were sourced. As it was, the absence itself carried information: one insurer then disclosed a twenty-four-month wait that ruled it out, and the other’s refusal to state it was a fact about the insurer.
Test yourself6 questions on this module
You ask for JSON containing only an id and a risk score from one to ten for each of twenty contracts. The scores look arbitrary. Why?
Your extracted CSV opens in a spreadsheet with columns shifted right on about a fifth of the rows. What is the most likely cause, and the one-line prevention?
You have four fixed questions about a supplier and you receive a fluent three-paragraph answer. Which distortion is the danger here?
“Compare these four insurance policies in exactly forty words.” What does the limit actually cost you?
You are extracting six fields from forty policy documents and you cannot check forty rows carefully. Which format decision helps most?
In a weekly-update skeleton, why write “[one line, or “none”]” rather than “[risk]” inside a slot?
Making it work the problem
9 lessons · 1 h 15
You will be able toJudge from a task’s structure whether shown reasoning will improve it, split a task that fails in one pass into steps that each succeed and can each be checked, and state precisely what a chain of shown reasoning is not evidence of.
- 5.1Make it show its work
- 5.2Which tasks get better with steps, and which do not
- 5.3Arithmetic it should not do in its head
- 5.4Models that think before answering
- 5.5Splitting a task that keeps failing
- 5.6Ask for the plan before the work
- 5.7Making it check its answer against the rules
- 5.8Let it ask you the questions
- 5.9Asking more than once, on purpose
An illustrative case, built from documented patternsEleven wrong totals in a sample of forty
Internal assessment marks at the college are a weighted total of four components: two sessional tests, an assignment, and attendance. Four departments send four spreadsheets in four shapes. The totals go onto a notice board and into the university portal, and a correction after publication is not a clerical matter: it is a complaint to the principal and, twice in the past decade, a small demonstration outside the block.
The examinations clerk, Mr Rao, had two days and 1,140 students. In previous years this took a week with three people. This year two of the three were on election duty.
He pasted a department’s sheet into a chat window and asked for the weighted totals. It produced them, in a neat column, in under a minute. He pasted the second department and did the same.
A junior lecturer from Civil, Mrs Anitha, saw the screen and objected. Her objection was not that the numbers were wrong; she had no idea whether they were wrong. It was that nobody could tell. A column of 1,140 numbers produced in prose has no working attached to it, and checking it means recomputing it, which is the entire job again.
What she wanted was Python: ask for a script that reads the sheets, applies the weights, and writes a file. Mr Rao’s objection to that was concrete. He had never run a script. The exam section had no one who had. Learning to install Python and run a file, in a room where the internet drops for an hour most afternoons, is not a two-minute task when the deadline is Friday.
So they measured before arguing further. Mrs Anitha took forty students at random from the first department and computed the totals by hand on paper, which took her thirty-five minutes.
Eleven of the forty prose totals were wrong. Not wildly (the errors were between one and four marks), and every one of them was in the range where a mark matters, because the internal total decides eligibility for the semester exam at 40 per cent.
That settled the direction and not the method. Mr Rao installed Python on the Wednesday with the script’s own setup instructions, which took forty minutes including a proxy problem, and ran the first version.
It failed in a way neither of them expected. The script ran cleanly, printed a row count of 1,140, and produced totals that were all slightly too high. Reading the code, which was commented line by line, because he had asked for that, Mrs Anitha found that the column headed Sessional-1 appeared twice in the Civil sheet, once as a raw mark out of 30 and once as a scaled mark out of 15, and the script had picked the first match both times. The arithmetic was perfect. The inputs were wrong.
They fixed it by asking for the parsed rows to be printed before the totals: the first two rows and the column names the script had actually matched. That single line of output made the next three problems visible in seconds rather than in a sample of forty.
The last problem was not arithmetic at all. Mr Rao asked for the plan before the second department was processed, an outline of the steps and the assumptions that would change the result if wrong, and the third assumption on the list was that a blank attendance cell means zero. At this college a blank means the student was on approved medical leave and the component is excluded from the weighting, which raises the total rather than lowering it. Sixty-one students had a blank.
How it played out
They published on the Friday. The published totals were computed by the script and spot-checked by hand on twenty students drawn from the middle and the end of each department’s file.
The eleven wrong totals in Mrs Anitha’s sample of forty are the number the section now quotes internally, because it is the one that changed people’s minds. Mr Rao’s estimate is that publishing the prose column would have put roughly three hundred wrong totals on the notice board, of which perhaps forty would have crossed the eligibility line in one direction or the other.
The duplicate-column failure is the one Mrs Anitha talks about, because it was the version of the problem she had not anticipated. Her argument for code had been that models cannot do arithmetic reliably, which is true and turned out to be only half the risk. Code execution removed arithmetic error completely and left extraction error untouched, and extraction error was harder to see because the totals were internally consistent and plausible. Printing the parsed rows and the matched column names is now the first thing in every script the section asks for.
The blank attendance cells were caught by the assumptions list and would not have been caught by anything else in the process. There was no way to see them in the output: sixty-one students would have received a slightly lower total, all of them internally consistent, all of them traceable to a correctly executed script.
The script itself was kept, with the four weights in named variables at the top, so that this year’s job is an afternoon. The section has since asked for two more: one that reconciles the portal upload against the published file and reports any row that differs, and one that counts how many students sit within one mark of the eligibility line, which nobody had ever been able to answer before.
Mr Rao still cannot write Python. He can read the four things that matter (the input numbers, the operation, the row count, and whether the result is roughly the size it should be) and he checked all four before the file went up.
Worth arguing about
The script produced a perfect total of the wrong numbers. Why does asking for code not remove that class of error, and what did?
One answer
Because extraction and calculation are separate steps with separate failure modes. Code execution removes arithmetic error entirely; it does nothing about which figures were fed in. Here the sheet had two columns headed Sessional-1 and the script matched the first one twice. What caught it was printing the parsed rows and the matched column names before the totals: checking the inputs rather than the answer, which is the check that a bare number never permits.
Sixty-one students had a blank attendance cell. Why would no amount of checking the output have found that?
One answer
Because the wrong treatment produced a correct-looking result: a slightly lower total, internally consistent, arithmetically sound, traceable to a script that ran cleanly. It was an assumption, not an error, and assumptions do not leave a mark in the output. It surfaced only because they asked for the plan and the assumptions that would change the result if wrong, before anything was computed, which is the cheapest point on the curve, since the cost of correcting an assumption rises with how much has been built on it.
Mrs Anitha spent thirty-five minutes computing forty totals by hand before arguing further. What did those thirty-five minutes buy that a stronger argument would not have?
One answer
A number on a fixed set of items, which is the only thing that could settle a disagreement between two people who both had a real cost on their side. Eleven of forty is a rate; “models are bad at arithmetic” is a belief. It also gave the section a held-out set they could rerun after every change to the script, which is how the duplicate-column and blank-attendance problems were confirmed fixed rather than assumed fixed.
Test yourself6 questions on this module
Which property of a task predicts that asking for shown steps will improve the answer?
A model produces a correct answer with an arithmetic error inside its shown working. What follows?
You ask for Python instead of a total, and it runs cleanly. Which error class does that remove, and which does it leave untouched?
You split a failing task into extract, group, judge and write. Where does the cost of splitting fall?
Before a three-thousand-word report, what is the most valuable thing to ask for besides the outline?
You run the same extraction three times and get the same figure each time. What have you established?
From lucky to reliable
9 lessons · 1 h 11
You will be able toDiagnose which of four causes produced a bad answer, improve a prompt by changing one thing at a time against a fixed set of test items, and keep a version a colleague could run and get the same quality from.
- 6.1Edit the prompt, do not spin the wheel
- 6.2Four reasons an answer is bad
- 6.3Change one thing at a time
- 6.4The five items you keep forever
- 6.5The file that makes this compound
- 6.6Why a prompt stops working
- 6.7Why the prompt from the internet does not work
- 6.8Getting the model to improve your prompt
- 6.9When to stop prompting and do it yourself
An illustrative case, built from documented patternsIt worked in March
The practice does bookkeeping and returns for about ninety small businesses, most of them traders and two small manufacturers. Since the previous year they have used one prompt to pull five fields out of purchase invoices (invoice number, date, supplier, taxable value, tax) and paste them into a sheet. It saved the junior, Hiren, roughly two hours a day, and the partner, Mr Vora, had stopped thinking about it.
In the second week of the season Hiren said the extractions had got worse. He could not put a number on it. He said it felt like one in six was wrong now, where before it had been one in twenty, and that it was mostly the dates.
Mr Vora’s instinct was to rewrite the prompt. It is fourteen lines long, four of which nobody can now justify: a line telling the model to be thorough and accurate, a line repeating the date format that already appears above it, a line about not using markdown that somebody added during a formatting problem in November, and a sentence beginning “You are an experienced Indian chartered accountant”. An afternoon of rewriting felt like the obvious response, and in filing season an afternoon is expensive but not impossible.
Hiren wanted to do something duller first: put three recent invoices next to three from January and look at them.
The cost either way was real. If the prompt was the problem, an afternoon spent comparing invoices was an afternoon lost from a queue that does not stop. If the prompt was not the problem, an afternoon of rewriting would produce a prompt that was wrong twice: adjusted to compensate for something they had not identified, and therefore harder to fix when they did.
They looked at the invoices. It took eleven minutes.
Two of the practice’s larger clients buy from the same distributor, and that distributor had changed its invoice template in the second week of February. The invoice date had moved out of the text block and into the header, where it now sits inside a small logo panel: an image. The text extraction reaches everything else on the page and does not reach the date, because the date is no longer text.
The prompt had not degraded. The input had changed shape, and the prompt was doing exactly what it had always done to a document that was missing a field.
That was the point at which the practice discovered it had no way of knowing when this had started. There was no record of what the prompt scored, on what, or when. “It used to work” was the entirety of the diagnosis available.
They built ten items that afternoon after all, but not the afternoon Mr Vora had planned. Two ordinary invoices from clients whose format has never changed. Four hard ones, taken from failures Hiren remembered: the supplier whose invoice number contains a slash, the one that prints the date in words, the two-page invoice where the total is on page two, the credit note that is not an invoice at all. Three invoices from the new distributor template. And one deliberately incomplete document, a scan with the tax line cut off at the edge, where the correct answer is NOT_STATED in one field.
That last item is the one Mr Vora argued about, on the reasonable grounds that they do not need the tool to fail well, they need it to work. Hiren’s answer was that if the tool ever stops writing NOT_STATED and starts writing a plausible tax figure instead, nothing in the output will look different.
How it played out
The immediate fix was not a prompt at all. Invoices from the new template get their date read by a person, because the field is an image and no instruction reaches it. That takes four seconds per invoice for about eleven invoices a week.
The ten items were run against the existing fourteen-line prompt three times: 8, 9, 8 out of 10, with the three new-template items failing on the date exactly as expected and everything else holding. So the prompt was fine, which is what the eleven minutes with the invoices had already suggested and what an afternoon of rewriting would have destroyed the evidence for.
They then did the thing that only becomes possible once you have ten items. They removed the four unjustifiable lines, one at a time, running the ten items three times after each removal. The thoroughness line: no change. The repeated date format: no change. The no-markdown line: no change, and it turned out to have been added to fix a problem in a different prompt. The chartered accountant persona: no change. The prompt went from fourteen lines to ten and from about 180 words to 95, and the score did not move.
One removal did move it. A line saying “if the supplier name is abbreviated, expand it to the full registered name”, which Hiren had added in December and Mr Vora had thought was decoration, dropped the score to 6, 7, 6. It was doing real work on three of the ten. It went back in, and now has a note beside it saying why.
The change log is four lines a change, kept in the same text file as the prompt. It has since answered two questions nobody could have answered before: which model the prompt was last tested against, and whether the drop somebody noticed in June was real. It was not (8, 9, 8 again) and the twenty minutes it took to establish that were the cheapest twenty minutes of the season.
The practice also tried a five-hundred-word invoice-extraction template that a friend had sent from a professional group. Against the same ten items, three runs: 7, 8, 7. Their own ten-line version scored 8, 9, 8. They kept theirs.
Worth arguing about
Hiren wanted to compare three recent invoices with three old ones before touching the prompt. Why is that the right first move when a stable prompt seems to degrade?
One answer
Because four of the five common causes of a prompt getting worse are not the prompt: the model changed, the product changed, the inputs changed shape, or a hard-coded fact went stale. Input drift is the most common in practice and the easiest to miss, precisely because attention goes to the prompt. Rewriting to compensate for an unidentified upstream change produces a prompt that is wrong twice and harder to repair once the real cause is found.
Removing four lines changed nothing and removing a fifth dropped the score by two. What does that pattern say about inherited prompts, and why can you only find it with fixed test items?
One answer
That most reused prompts are part decoration and part load-bearing, and nothing about reading them tells you which is which. Without fixed items you are comparing today’s impression against yesterday’s memory, and sampling means a single run of each version tells you nothing. One change, the same items, three runs, keep or discard: the discard step is the one everyone skips, which is why prompts accumulate lines nobody dares remove.
Mr Vora objected to the deliberately incomplete tenth item. What is the argument for keeping it?
One answer
Because the ability to correctly not answer is a behaviour that regresses like any other, and its failure is invisible. If the prompt ever stops writing NOT_STATED for a missing tax figure and starts writing a plausible one, the output looks more complete rather than more broken. This happens in a specific way (add successful extraction examples and the model learns that extraction always succeeds) and one item with a deliberately incomplete document is the only thing that catches it.
Test yourself6 questions on this module
You have corrected the same drift twice in one conversation and it keeps returning. What is the better move than a third, firmer correction?
Your third attempt at a task is more polished than the first and wrong in exactly the same way. What does that indicate?
Which of these counts as one change when you are tuning a reused prompt?
Why should a regression set include one item whose correct answer is a refusal or NOT_STATED?
A prompt unchanged since March starts producing worse output. Which cause is both the most common in practice and the easiest to miss?
A five-hundred-word template from the internet is worth stripping. What is usually the part worth keeping?
Checking the answer
9 lessons · 1 h 15
You will be able toMatch verification to the cost of being wrong rather than to how confident an answer sounds, and apply the right check for a citation, a search result, a claim about a document, a number and an omission.
- 7.1How to tell when it is guessing
- 7.2The citation that does not say that
- 7.3When it can search, and what that fixes
- 7.4Checking a claim about a document you have
- 7.5Checking a number in under a minute
- 7.6Disagreeing without getting agreement
- 7.7Asking a second model
- 7.8The hardest check: what was left out
- 7.9How much checking is enough
An illustrative case, built from documented patternsSixty-one references and nine days
The dissertation is a Master’s in public health, on adherence to tuberculosis treatment among migrant construction workers. The student, Farhana, wrote it over five months. The literature review runs to about nine thousand words and carries sixty-one references, and she used a chat tool throughout: to find literature, to summarise papers she had downloaded, and to tighten her own prose.
Her supervisor, Dr Menon, reads chapter two properly nine days before the internal deadline, which is later than either of them would like and is what the term allows. He tries to follow up three citations because they are the ones supporting the strongest claim in the chapter.
The first does not exist. The authors are real people who have published in the field and have never published together. The journal is real, the volume is real, and there is no such article.
The second exists and does not say what it is cited for. It is a study of adherence among a settled urban cohort in a different state, cited in support of a claim about migrant workers, at a point in the chapter where that distinction is the whole argument.
The third exists, says roughly what it is cited for, and is a study of forty-one patients at a single centre, cited as evidence about a national programme.
Dr Menon’s position was that all sixty-one now had to be verified, and that the chapter could not go forward otherwise. Farhana’s position was that she had nine days, that verifying sixty-one references properly, finding each one, opening it, and checking that it says what she claims, is five or six hours at best and considerably more for the ones behind paywalls, and that those hours have to come out of the results chapter, which is not yet written.
There was also a third possibility in the room, which the department had raised in a circular the month before: run the chapter through a detection tool. Dr Menon was against it, on the grounds that those tools flag work by people writing in a second language at a rate that makes them useless as evidence, and that the question in front of them was not whether a model had been involved but whether the references were real.
Farhana’s first instinct made things worse before it made them better. She pasted the first citation back and asked whether it was correct. She was told, warmly, that it appeared to be accurate. She then asked whether it was sure, and received an apology and a different citation, which also did not exist. She had learned nothing from either exchange, twice.
What worked was duller. She sorted the sixty-one by what happens if this one is wrong. Eleven of them carried a claim the argument actually rests on. Thirty-one were background: the standard citations everybody in the field uses, which she had read. Nineteen were in the middle: things she had skimmed and cited for a single number.
The eleven were checked properly: title searched in quotation marks, DOI resolved, abstract opened, claim located in the text, population and sample size compared with what her sentence said. That took just under two hours.
The nineteen got the thirty-second version: does it exist, does the DOI resolve, does the abstract contain the claim.
The thirty-one were spot-checked at five.
How it played out
Of the sixty-one, four did not exist. Three of the four were in the nineteen: the ones cited for a single number, which is where she had been least careful and where a plausible source was most useful to her.
Seven more existed and did not support the claim they were attached to. All seven were in the eleven load-bearing citations or the nineteen. Not one was in the thirty-one she had actually read, which Dr Menon took as the clearest evidence in the whole exercise about where the risk lives.
Five of the seven were population mismatches of the same kind as the second citation: a real finding about a different group, cited across the gap without the gap being mentioned. Two were more subtle and are the ones Farhana found hardest: the source said the thing, with a qualifier in the same sentence, and her paraphrase had dropped the qualifier.
The eleven took two hours, the nineteen took forty minutes, and the five spot-checks took ten. Three and a bit hours in total, rather than the six she had feared, because sorting by consequence meant the expensive check was applied to eleven items rather than sixty-one.
She rewrote four paragraphs, removed two claims she could not support, and softened three others. The chapter got shorter and the argument got narrower, which Dr Menon considers an improvement and Farhana, at the time, did not.
The omission check was the one nobody had planned. Asked to list every study of adherence among internal migrant workers in India since 2015 with its sample size, and then asked separately what it had found and not included, the tool named two studies that were not in her review at all. One of them was the closest study to hers that exists. It had never appeared in five months of searching because her queries were in the vocabulary of her framing, and so were the answers.
For the results chapter she changed one habit and only one. Every factual claim had to carry a quoted sentence and a page number at the moment it was written, not at the end. She says this made writing slower by about a fifth and removed the verification problem entirely, because there was nothing left to verify afterwards.
Worth arguing about
Farhana asked whether the citation was correct, and then asked whether it was sure. Why did neither question tell her anything?
One answer
Both are leading questions aimed at a system trained towards agreement. Asking whether an answer is correct invites confirmation; asking whether it is sure signals that the answer is under suspicion and invites reversal, and the reversal is the trained behaviour rather than a reconsideration. The same exchange can talk a model out of a correct answer just as easily. What settles a citation is the evidence (search the exact title, resolve the DOI, open the abstract) or a clean-context re-ask with no history of her doubt.
Three of the four fabricated references were among the nineteen she had skimmed, not the eleven the argument rests on. Why is that where fabrication concentrates?
One answer
Because that is where she needed a specific figure and had not read a source that gave it. Invention clusters where the pattern is strong and the material is thin: a citation is a highly patterned string, and one assembled from typical parts fits the pattern better than many real ones. Precision is not evidence: a fabricated reference with a volume and a page range looks more authoritative than an honest “no source for this figure”.
The literature review was missing the closest study to her own, and no amount of re-reading the chapter would have shown it. What made it visible?
One answer
Forcing the absence to occupy space. An omission leaves no mark in an answer, so it has to be surfaced by a separate move: enumerate and count before analysing, then ask explicitly what was found and not included. Her searching had never surfaced it because her queries used the vocabulary of her own framing and so did every answer. That is also the honest limit: this catches what you thought to enumerate, and a person who knows the field is still the only check for what should have been there and is not.
Test yourself6 questions on this module
An answer cites “Section 14(3)(b) of the 2021 Act” and gives a 21-day deadline. Why is that precision not reassuring?
You confirm that a cited paper exists and that the citation details are correct. Which failure does that not touch?
You suspect an answer is wrong and ask “are you sure?”. What have you measured?
Why is an omission the hardest failure to catch, and what actually catches it?
Two models from different providers give the same answer. What does that agreement establish?
Which pair of situations should you refuse rather than check harder?
The work you actually have
9 lessons · 1 h 20
You will be able toTake a recurring task from your own week and build a prompt for it that supplies the right material, produces a usable shape, makes its own failures visible, and can be handed to a colleague who will get the same quality from it.
- 8.1Drafting without losing the thing that was yours
- 8.2The message you have been putting off
- 8.3Getting through a long document properly
- 8.4Deciding between options
- 8.5The spreadsheet somebody else built
- 8.6Asking for code you could not have written
- 8.7Using it to learn, without fooling yourself
- 8.8Applications, without the generic letter
- 8.9A prompt somebody else can run
An illustrative case, built from documented patternsThe officer who was transferred
The desk sanctions agricultural and small-business loans, and every file carries land documents: a title extract, an encumbrance certificate, and often a partition deed or a lease, in Kannada and English, some typed, many photocopies of photocopies. Reading one file properly is most of a working day for an officer who knows what to look for.
One officer, Mr Hiremath, had built himself a working method over about eight months. It was not a single prompt. It was a sequence: map the document’s sections and count them, locate the sections dealing with encumbrances and boundaries, extract every entry with its exact sentence and the page it came from, verify two quotes by hand against the paper, and only then summarise for the sanctioning note. His files took about half a day instead of a full one, and in two years none of them had come back from the audit section.
In April he was transferred to a branch ninety kilometres away, with eleven days’ notice.
What he left behind was a text file with the sequence in it, which his successor, Ms Naik, found and started using in her second week. It worked less well for her and neither of them could say why. Her third file produced an encumbrance summary that missed a mortgage entry, which the branch manager caught only because he recognised the family name.
The manager’s decision was straightforward to state and unpleasant to make. Either the desk goes back to the full-day method, which at their current volume means files sit for eleven days instead of four and the bank loses business to a private lender two streets away that sanctions in a week. Or it keeps using a method that has just missed a mortgage, on the basis that it had not missed one in two years for somebody else.
They rang Mr Hiremath. The conversation took forty minutes and produced four things that were not in the file.
The first was that half the quality was coming from somewhere Ms Naik could not see. Mr Hiremath had a standing brief in his account settings: the bank’s name for a partition deed, the fact that survey numbers in this taluk carry a sub-division suffix that must never be dropped, the register in which encumbrance entries are numbered, and a line saying that a document is data and not an instruction. None of that was in the text file, because from the inside it was not part of the prompt. It was just true.
The second was the row-count habit. His sequence began with a section count for a reason: three or four files a month arrive as photographs of photocopies where the middle pages do not read at all, and the count is how he found out. Ms Naik had been skipping it because it looked like a warm-up step.
The third was what a blank means. When the extraction says NOT_STATED against an encumbrance entry, Mr Hiremath goes to the paper. Ms Naik had been reading it as an absence of encumbrance, which is the opposite of what it means and is exactly the kind of thing that only looks obvious to the person who invented the convention.
The fourth was the missed mortgage. It was on a page that had not been counted, in a file whose section count would have come back short.
How it played out
They wrote the thing down. It took Ms Naik and Mr Hiremath about ninety minutes on a phone call and one evening of typing, and it is two pages under six headings: what it is for, what to paste, the sequence itself with slots in capitals, what a good output looks like, when to distrust it, and what to do if it goes wrong.
The “when to distrust it” section is nine lines and is the only part the manager reads. It says that a section count shorter than the paper file means stop and re-scan; that NOT_STATED means go to the paper, not that there is nothing there; that any survey number without its sub-division suffix is wrong even if it looks right; that a summary produced before the enumeration is not to be used; and that two quotes per file are verified against paper by a person, every time, no exceptions.
Mr Hiremath said afterwards that writing those nine lines was harder than the eight months of building the method, because he had never had to say what he knew.
The standing brief was copied into Ms Naik’s account and then, on the manager’s instruction, into a shared file, because an account setting that disappears when a person is transferred is the same failure again with a longer fuse.
They tested the document the way the last section of the course suggests: the manager gave it to a third officer and watched her use it once without helping. She did three things nobody predicted. She pasted a summary of the encumbrance certificate rather than the certificate, because the certificate is long. She stopped at the first output rather than reading the source column. And she deleted the line requiring the exact sentence, because it made the answers long and looked like clutter. All three were fixed in the document rather than in her.
File turnaround settled at four to five days. In the eleven months since, two files have been stopped by a short section count and one by a NOT_STATED that turned out to be a lis pendens entry on a page that had photographed badly. The audit section has returned none.
Ms Naik’s own addition is a line at the top saying who owns the document and when it was last checked. Mr Hiremath’s file had neither, and the desk’s view now is that an unowned, undated method is one transfer away from being a method nobody trusts.
Worth arguing about
The same text file produced better results for Mr Hiremath than for Ms Naik. Name the four things that did not travel with it.
One answer
His context: the kinds of document he always pasted and how; his standing brief, which carried the taluk’s survey-number convention and the bank’s vocabulary and lived invisibly in his account settings; his judgement about the output, in particular that NOT_STATED means go to the paper; and his product setup. The standing brief is the commonest of these and the hardest to spot, because from the inside it is not part of the prompt, it is simply true.
Ms Naik had been skipping the section count because it looked like a warm-up. What is it actually for?
One answer
It is the check against omission, and it is the step that caught the missed mortgage. An absence leaves no mark in an answer: a summary of four encumbrance entries that covers three reads exactly like one that covers four. Counting the sections before any analysis turns a silence into a number that can disagree with the paper file, and in this desk it also detects the three or four files a month whose middle pages did not photograph readably.
Mr Hiremath found the nine-line “when to distrust it” section harder to write than the eight months of building the method. Why is that section the test of whether he understood it?
One answer
Because it is the part he was carrying in his head and calling skill. A prompt transfers only with its context, its expected output and the conditions under which it fails, and writing those forces every implicit assumption into the open. Anyone who cannot write the section does not yet know when to distrust their own method, which is worth discovering while it is still their work rather than somebody else’s, and eleven days before a transfer rather than after one.
Test yourself6 questions on this module
Faced with a sixty-page tender document, why is asking for a summary the wrong first move?
You need a messy spreadsheet cleaned. Why ask for a formula or a script rather than the cleaned data?
You have a script that renames four hundred files and you cannot read code. What is the safest first run?
A covering letter reads as generic. According to the module, what is the actual missing ingredient?
Why add “do not give me the answer when I am struggling, give me a hint” to a study prompt?
A prompt that works well for you works badly for a colleague. Which invisible difference is the commonest cause?
What this course is
A practical course for people who use AI chat tools every week and quietly suspect they are getting less than the tools can give. Eight modules and seventy-two lessons on what actually changes an answer: context, tasks, examples, format, reasoning, and honest iteration. Every lesson carries real before-and-after prompts you can copy tonight. No secret words, no incantations, no promises the tools cannot keep. By the end you will be able to brief a model the way you would brief a capable colleague, and to tell when it is guessing.
Who wrote it
Founder and series editor: Dr Mustafa Mun. Written by AI models to a written standard. Exam keys checked blind by a second model: 3,665 of 3,666 agreed. Academic review invited.
More in Start here
- AI, Safety and What Goes WrongThe failure modes of AI, stated plainly, with the numbers.
- AI, Actually ExplainedFor someone who was never told what this thing is.
- Machine Learning, FoundationsThe classical ground under modern AI, for someone who can read code.
- How a Language Model Actually WorksThe machinery under the chat box, explained without matrices.
