Lesson 10.1
Demo craft: show the problem, the result and the limits
You will be able to plan and run a short demo that shows the client's problem, the result on their own data, and the honest limits, and ends in a decision.
Why this matters on a client engagement
The demo is often the moment a sponsor decides whether the work continues. A good demo turns weeks of discovery and building into a clear decision. A bad one, too long, too technical, or hiding the weak spots, can sink good work, or worse, win approval for something that later disappoints. FDEs demo often, so this is a skill worth practising.
Shape of a decision-focused demo
- The problemOne real case, in their words
- The resultSame case, run live on their data
- The evidenceEval set and pass rate by case type
- The limitsWhat it does not do; where people decide
- The askOne decision and a named owner
The short version
A demo is not a tour of features. It is a short story with four parts: the problem in the client's words, the result running on their real cases, the evidence that it works beyond the cases you show, and the limits you know about. It ends with a clear ask, usually a decision about the next step.
Plan it like a meeting with a purpose, not like a presentation. Before you build a single slide, write down the one decision you want at the end.
A demo script structure
A script keeps the demo short and stops you wandering into detail. A common structure:
- Open with the problem: one real case from the client's work, with the time or pain it causes today, in their words.
- Show the result: run that same case live, then two or three more that show normal, tricky and refused cases.
- Show the evidence: the eval set size, the pass rate by case type, and one failure you understand.
- State the limits: what it does not do, what it has not been tested on, and where a person stays in control.
- Make the ask: the decision you need, who owns it on the client side, and the next step.
Know your audience
Different people listen for different things. A sponsor wants to know whether it saves time, money or risk. The people who do the work want to know whether it makes their day easier or threatens their job. IT and security want to know where data goes. Find out who is coming before the meeting, and make sure each group hears its question answered in the first ten minutes.
Use the client's words. If they say 'exceptions', do not say 'edge cases'. If they say 'the AP queue', do not say 'the pipeline'.
Handling questions
Questions are good: they show people are imagining using it. Listen to the whole question, repeat it in one sentence to check you understood, then answer briefly. If you do not know, say so and write it down with a date for the answer. Never guess at numbers or promise features on the spot.
When someone asks 'can it also do X?', answer honestly about what exists today, then treat X as a backlog candidate. Ask what problem X would solve; often it reveals a better next step than the one you planned.
Honest limits and live risk
Show at least one case where the solution is wrong or refuses, and explain how the workflow catches it. This builds more trust than a perfect run, because everyone knows AI makes mistakes, and they want to see you know where.
Live demos fail. Rehearse twice, use a stable environment, keep cases ready in a file, and have a recorded run as a backup. If something breaks, switch to the recording calmly and say what happened. Never use real customer data on a shared screen unless the client has agreed.
After the demo, send a short written follow-up the same day: the decision asked for, what was shown, the limits you stated, the open questions with the date you will answer them, and the agreed next step with its owner. People who were not in the room will read that note, and it stops the story from growing in the retelling. If the audience heard 'it is 90 percent accurate' but the eval set had only 30 cases, the note is where you make that clear.
Worked example
Worked example: a 15-minute demo script
Here is a script for the invoice matching assistant. The numbers in it (three clerks, about 400 invoices a week, 60 eval cases) are example values; in a real demo you use the figures you measured in discovery and testing, and you name their source if asked.
Notice how little time goes to the result itself compared with the problem, the evidence and the limits. Notice also that it ends with a yes or no question and a request for an owner, not with 'any questions?'.
DEMO SCRIPT - Invoice matching assistant (15 minutes)
1. The problem (2 min)
"Today three clerks check about 400 invoices a week by hand.
Here is one from last Tuesday that took 20 minutes to resolve."
2. The result, on their data (6 min)
- Run the same invoice live. Show the decision and the reason.
- Show one clean case, one hold, one needs_review.
- Show the reviewer screen and the audit record.
3. The evidence (3 min)
- Eval set: 60 real cases from March and April.
- Pass rate by case type, and the 2 cases it got wrong.
4. The limits (2 min)
- Not tested on handwritten scans.
- Every payment still needs a person to approve it.
5. The ask (2 min)
- Decide: a 4-week pilot with two clerks, yes or no.
- Name an owner on your side.
Backup: recorded run of steps 2 and 3, saved locally.Start practicing
Write and rehearse a demo script
60 minGoal: Produce a 10-minute demo plan that ends in a decision.
- Pick something you have built, or the eval exercise from module 9.
- Write the one decision you want at the end in a single sentence.
- Fill in the five-part script: problem, result, evidence, limits, ask. Keep each part to a few lines.
- List the three hardest questions you expect and write a short honest answer to each.
- Rehearse out loud with a timer, then once more with a friend or by recording yourself.
- Record a backup run of the result part and save it locally.
Done when: You can give the demo in under 10 minutes, it shows at least one limit, and it ends with a clear ask.
Common mistakes
- Opening with architecture diagrams. Start with the client's problem; show the inside only if asked.
- Showing only perfect cases. Show one failure and how the workflow handles it.
- Using made-up or toy data when real (agreed, masked) data is available.
- Ending without an ask, so nothing is decided.
- Promising features or dates during questions. Write them down and reply later.
Check yourself
- What are the five parts of a decision-focused demo?
- Why show a case where the solution fails?
- How should you answer a question you do not know the answer to?
- What do you prepare in case the live demo breaks?