learn-ml-strategy-with-phoebe / Leader session 6 of 6
Learn ML Strategy with Phoebe · Leader session 6 of 6

Get your teammates to read this

Five sessions of decisions are worth nothing while they live in the head of the person who attended them. The engineer who joins in March, the sponsor whose project came fifth, the account manager promising a date to a conservation group: none of them were in the room, and none of them will read a forty-page document. Tonight the deliverable is one page, with five sections and a date on it, that a colleague can read in four minutes and argue with in five. Then the part that keeps the page useful for the next few years: where every one of these habits reappears when the model in question is a language model, and the one place the arithmetic stops carrying over.

🟠 Advanced Data and product leaders 45 min
0-3 · Welcome 3-20 · The memo, and language models 20-40 · Build-along: write yours 40-45 · Q&A
Part 0

What the five sessions produced

Session 1 said progress is a loop with a speed, and priced five projects: 1.62 points of dev error per week for the dull one, 0.21 for the favourite. Session 2 reduced the team to one number with satisficing bars around it. Session 3 filled the spreadsheet that ranks projects by what they could fix. Session 4 split the error into unavoidable bias, avoidable bias and variance, so the diagnosis picks the project. Session 5 attributed errors to one stage of a pipeline instead of to whichever box spoke last. Tonight all five fit on a page, and the page is the thing the rest of the organisation actually receives.

Live = presented in the 45 minutes Self-study = the full depth, after class 🔍 Every diagram zooms

★ What you walk out with tonight. A one-page memo for one model, in five sections, written rather than planned. The evidence line that makes it hold in a room full of sponsors: 6.2 percent dev error by week 6 in the sheet's order against 11.2 in the order the team wanted, both landing at 3.6 at week 18. The three levels where the same discipline reappears in language-model products, with the one thing that does not transfer stated plainly. And a promise you can make to a board without regretting it.

LiveA strategy in one head is a bottleneck with a salary3 min▶

Everything in the previous five sessions is a decision rule, and a decision rule only works if the people making decisions know it. If the ranking rule lives with one leader, then every ranking has to pass through that leader, which is a queue. If the dev set rule lives with one engineer, a new joiner will build a convenient dev set in their first month and nobody will catch it for a quarter.

The failure is not that people disagree. It is that they never had the same information to disagree about. A sponsor who has seen the sheet and still wants their project funded is having a useful argument. A sponsor who has never seen it is having a different conversation entirely, and no amount of authority makes that conversation productive.

Real world

Lanternfish's account manager promised a customer that species accuracy would be above 95 percent by the end of the quarter. She had asked, and had been told the team was working on accuracy, which was true. Nobody had shown her a sheet saying the honest number was 88 percent and the quarter's plan moved it to roughly 94. The promise was not dishonest. It was made in the absence of one page.

Self-studyWho receives the page, and what each of them needs from it4 min▶
  • The engineer who joins next month. Needs the dev set sentence and the metric, because those two decide whether their first experiment is measured against the right thing.
  • The sponsor whose project came fifth. Needs the sorted sheet and the start week beside their row, so that a no reads as a queue position rather than a verdict on them.
  • Whoever sells the product. Needs the current number and the expected trajectory, phrased so it cannot be repeated to a customer as a guarantee.
  • The person who funds the team. Needs the diagnosis and the one funded project, because that is the pairing that says the money followed the evidence.
  • You, in three months. Needs the date, because the only way to notice that a page has gone stale is to see when it was written.
Part 1 · covers chapter 58

Building a superhero team - get your teammates to read this

9 min live

The final chapter of Machine Learning Yearning is called "Building a superhero team - Get your teammates to read this", and the design of the whole book is the argument. Each chapter is one or two pages, because a chapter that length can be handed to a specific colleague who needs exactly that idea, and it will come back read. A shared vocabulary is built by pages people finish, not by documents people intend to read.

One page, five sections, and the evidence under them Lanternfish species model 1 · The dev set 1,000 frames, 120 wrong, 12 percent 2 · The metric accuracy, with two bars to clear 3 · The sorted sheet five projects, points per week 4 · The diagnosis three numbers, one verdict 5 · Funded, and not funded one project, and four with dates Evidence 6.2 pct by week 6 in this order 11.2 pct by week 6 in the other both reach 3.6 pct at week 18 dated, and rewritten when a number moves 1,000 frames sampled from live camera traffic, night and day in the proportions the cameras actually produce. Accuracy is the one number the team optimises. Runtime under 100ms per frame is a bar, not a thing to maximise. Five projects with ceiling, weeks and points per week, sorted. 1.62 at the top of the sheet, 0.21 at the bottom. Train 3, dev 12, human-level 2. Unavoidable 2, avoidable bias 1, variance 9. The verdict is: work on variance. Re-label the dev set, one week, funded now. The other four carry a start week each, and none of them is cancelled. The two orders reach the same place. What the order buys is eight weeks the field does not spend above 11 percent. A sponsor can argue with any of this, which is the point: it is one page, so the argument is about the numbers. Five sections and a date. Anything that does not fit belongs in a document nobody will finish.
🔍 Click to zoom - the memo's skeleton, with what each section carries and the evidence that holds it up.
LiveWhy the chapters are one or two pages long3 min▶

The book is 58 chapters and each one is short enough to read standing up. That is a deliberate design, and the reason it gives is practical: a colleague who needs one specific idea can be handed exactly the pages carrying it, rather than a book with a recommendation to start at the beginning. A one-page idea gets read. A fifty-page argument gets acknowledged.

The consequence for a leader is that the unit of communication is not the document, it is the page somebody can be handed. If the team needs to agree on how the dev set is sized, the artefact is the paragraph about sizing, not a data strategy. If a sponsor needs to understand why their project is fifth, the artefact is the sorted sheet with their row in it, not an invitation to a review.

  • Short means specific. A page can only hold one decision, which forces the decision to be named.
  • Short means datable. A page is cheap enough to rewrite when a number moves, and a long document never gets rewritten, only appended to.
  • Short means arguable. Somebody who read the whole thing can push back on the whole thing, and the pushback lands on the numbers rather than on the fact that they did not read it.
LiveThe five sections of the memo4 min▶

One model, one page, five sections, in this order. The order matters because each section is only meaningful once the one above it is fixed.

  • The dev set sentence. What the model is measured on, in one sentence, including where the examples came from and how many there are. Lanternfish: 1,000 frames sampled from live camera traffic, night and day in the proportions the cameras produce, of which 120 are currently wrong.
  • The single metric, with its satisficing bars. One number the team optimises, and the constraints that only have to be cleared rather than maximised. Accuracy is the number; runtime under 100 milliseconds per frame is a bar. Session 2 chose these; the memo records them so nobody re-litigates them mid-sprint.
  • The sorted spreadsheet, with points per week. Every candidate project with its ceiling, its cost in weeks, and the division of the two, sorted by the third column. Five rows is usually the whole quarter.
  • The three-number bias and variance diagnosis. Training error, dev error, human-level error, and the verdict they produce. Lanternfish: 3, 12 and 2, which is 2 points unavoidable, 1 point of avoidable bias and 9 points of variance, so the work goes to variance.
  • The one project funded this sprint, and the four that are not. The funded one with its cost. The other four listed with their points per week and the week each would start under the current order.

Nothing else goes on the page. Not the architecture, not the infrastructure plan, not the hiring case. Each of those is a different page for a different reader, and putting them here is what turns a memo back into a document.

LiveThe evidence that makes the page hold in the room3 min▶

A memo listing four unfunded projects is walking into a room with four disappointed sponsors in it. What survives that room is not the ranking. It is the evidence that the ranking costs somebody something real, and that the somebody is the customer rather than the sponsor.

  • In the sheet's order (re-label, motion filter, denoise, occlusion, specialist) the Blackbox error goes 11.2 at the start, 10.2 after week 1, 9.0 by week 3, 6.2 percent by week 6, 5.6 at week 10, and 3.6 at week 18.
  • In the order the team argued for, with the specialist model first, the Blackbox error is still 11.2 percent at week 6, 9.2 at week 8, 8.6 at 12, 5.8 at 15, 4.6 at 17, and 3.6 at week 18.
  • Both orders finish in the same place. That is what makes the argument winnable. Nobody's project is being called worthless, and nobody has to be told their judgement was poor. The difference is eight weeks that the field spends above 11 percent error, for the same destination.

Put those three lines in the memo verbatim. They are the only part of the page that answers the question a sponsor is actually asking, which is not "is my project good" but "why not mine first".

Self-studyHanding somebody exactly the section they need3 min▶

Once the page exists, most conversations become a pointer to one of its sections rather than a meeting. A new engineer gets sections one and two before writing any code. A sponsor gets section five with their row highlighted. A customer-facing colleague gets the current number and the trajectory, and explicitly not the sheet, because a queue of internal projects is not a thing to share with a customer.

The reason this works is that the sections were written to stand alone. If section five cannot be understood without reading section three, it is too compressed, and the fix is a clause rather than a longer memo. Read each section on its own before sending it and ask whether a person who saw only that section would take a correct action.

Part 2 · covers where this lands in language-model products

Where this lands when the model is a language model

8 min live

Every habit on the page was built for a classifier with a labelled dev set and an accuracy number. Most teams now also ship something with a language model inside it, where there is no accuracy column and no labelled dev set waiting. The discipline survives the move almost intact, in a form Hamel Husain describes as three levels. One thing does not survive, and it is worth naming so that nobody quietly keeps using an arithmetic that no longer has its inputs.

Three levels, and the act that sits under all of them no train error here: the bias-variance split needs a new yardstick Level 1 Unit tests and assertions cheap, run on every change Level 2 Human and model eval somebody reads the outputs and a model helps at scale Level 3 A/B testing the real users decide, slowest and most costly Looking at the errors: the same act holding up every level Hand-off: golden sets, judges, regression suites the AI evals course owns the tooling and the eval culture Hand-off: metric definitions and thresholds the model-evaluation course owns how a thing is scored The levels change. Reading the errors yourself does not.
🔍 Click to zoom - three levels rising in cost, one shared act underneath, and where the neighbouring courses take over.
LiveHusain's three levels3 min▶

Hamel Husain's account of evaluating a language-model product, in "Your AI Product Needs Evals", sorts the work into three levels that rise in cost and in trustworthiness.

  • Level 1: unit tests and assertions. Cheap checks that run on every change. Did the output parse, did it include the required field, did it avoid the phrase it must never use. These are the fast half of the loop, and they are the ones teams skip because they feel too simple to matter.
  • Level 2: human and model eval. A person reads outputs, and once the criteria are stable a model helps apply them at scale. This is where most of the learning happens, and where the previous five sessions' habits reappear almost unchanged.
  • Level 3: A/B testing. Real users, real traffic, the slowest and most expensive signal, and the only one that settles whether the change was worth anything commercially.

The shape is familiar: a cheap fast loop, a considered middle loop, and an expensive final reading. What changes between a classifier and a language model is the instrument at each level, not the structure of the ladder.

LiveThe same discipline wearing new clothes3 min▶

Underneath all three levels is one act, and Husain is direct about it: "You must remove all friction from the process of looking at data". Every session in this track has been a variation on that sentence. Look at 100 mistakes. Split the dev set so half of it stays honest. Walk one error through the boxes by hand. The instrument changes and the act does not.

His stopping rule is the same shape as the error-analysis spreadsheet's: "keep reading logs until you feel like you aren't learning anything new". That is the language-model version of stopping the tally when the categories stop changing. It is a judgement, not a threshold, and it is a judgement that only the person doing the reading can make.

  • The error sheet becomes a log sheet. Same columns, same principle: a row per failure, a category per column, a share at the bottom, and one row can tick several columns.
  • The ceiling still prices a project. If 20 percent of bad outputs come from retrieval returning the wrong document, that share is the most a retrieval project could fix.
  • Error analysis by parts still applies, and applies harder, because a language-model product is almost always a pipeline: retrieve, then prompt, then parse. Hand one stage a perfect input and see whether the failure survives.
  • The one funded project and the four not still fits on a page. The memo does not change shape at all.
LiveWhat never to promise2 min▶

The last section of the memo is where somebody senior asks for a number and a date. What can honestly be promised is not a target error rate. Nobody knows in advance which idea will work on a real dataset, which is the premise the whole track is built on, and a promised accuracy figure is a guess wearing a commitment's clothes.

What can be promised, and kept:

  • A dev set drawn from the traffic the product will be judged on, with a stated size, by a stated date.
  • A single metric with its satisficing bars written down, so that "better" means one thing across the team.
  • A sorted sheet of candidate projects with ceilings and costs, rebuilt each time the errors are re-counted.
  • A sprint cadence that says how often the loop closes and the numbers are re-read.

Those four are entirely within the team's control, which is what makes them promises rather than forecasts. A leader who commits to them and reports them on time buys far more credibility than one who commits to 95 percent and arrives at 94.

Self-studyWhat does not transfer3 min▶

One tool from session 4 breaks on the move and it should be retired rather than approximated. The bias and variance decomposition needs a training error to compare against: avoidable bias is training error minus the optimal error rate, and variance is dev error minus training error. With a language model called through an API and prompted rather than trained, there is no training error belonging to your team. Two of the three numbers are missing.

  • What you keep is the idea that the total error splits into parts with different remedies, and that the split decides which project to fund.
  • What you need instead of training error is a different yardstick for the floor: how well the strongest available configuration does on the same examples, or how well a careful person does with the same context.
  • What to avoid is quoting an avoidable-bias number computed from a number you do not have. A diagnosis with an invented input is worse than no diagnosis, because it is persuasive.

Say this out loud when the memo covers a language-model product. The section is shorter and it says which yardstick was used instead. An honest gap on the page is much cheaper than a confident number that nobody can reproduce.

Self-studyWhere the neighbouring courses take over3 min▶
  • Golden sets, judges and regression suites belong to the AI evals course. It owns how a language-model eval is actually built and run, how a model-as-judge is validated, and how an eval culture is kept alive once the novelty wears off.
  • Metric definitions belong to the model-evaluation course. What precision is, where a threshold goes, whether a score is calibrated, what a cost matrix does to a decision boundary. Every session so far has taken a metric as given and never once defined one.
  • A/B testing itself belongs to the experimentation course. Husain's third level is named here as the top of the ladder and is not taught.

The reason to draw these lines explicitly is the same reason the memo is one page. A track that tried to own all three would be a track nobody finishes, and the decisions it exists to teach would be buried in the middle of it.

Build-along

Write yours

★ 20 min · everyone writes

One model, one page, written now rather than planned for later. Bring whatever numbers you have; the gaps are part of the output, because a blank in section one is a finding about your instrument. If you have nothing to hand, write Lanternfish's, which is below in full.

Write the five section headings first, then fill them. The dev set, the metric, the sheet, the diagnosis, funded and not funded. Filling them in order stops the page turning into an essay, because each section is answerable in two or three lines and you can see the next heading waiting.

Put the sorted sheet you actually have on it, not the one you wish you had. If the shares are guesses, write that they are guesses. A memo with an honest rough sheet gets corrected by the team; a memo with a polished sheet nobody can reproduce gets quietly ignored, which is worse and slower.

Write the one project funded and the four not, with their points per week beside them. Give each unfunded row a start week. A no with a date is a queue position; a no without one is a verdict, and sponsors argue with verdicts for months.

Read it aloud to somebody who funds the work and note every word they did not understand. Not the words you think are jargon. The ones they stopped at. Ceiling, variance, Blackbox and satisficing are the usual four, and each one needs a five-word gloss on the page rather than a footnote.

Date it and set the day it gets rewritten. A month is a reasonable default, or the day the sheet is re-counted, whichever is sooner. Write that date on the page itself so any reader can see whether the page they are holding is still true.

★ The one-page memo, as it goes to the team LANTERNFISH SPECIES CLASSIFIER - WHAT WE ARE WORKING ON AND WHY Written 9 September. Rewritten when the sheet is re-counted, and no later than 9 October. 1. THE DEV SET 1,000 frames sampled from live camera traffic, night and day in the proportions the cameras actually produce. 120 of them are currently wrong: 12 percent dev error. The old 400 web photos are retired. They said 94 percent; the field said 78. 2. THE METRIC Accuracy on that dev set is the single number we optimise. Runtime under 100ms per frame is a bar to clear, not a thing to maximise. If a change improves accuracy and breaks the bar, it does not ship. 3. THE SORTED SHEET (from 64 errors read by hand, points of dev error per week) Re-label the dev set wrong labels, 14 pct of errors 1 week 1.62 Infrared denoising pass night blur, 33 pct 3 weeks 0.84 Motion-trigger filter empty frames, 16 pct 2 weeks 0.80 Occlusion augmentation half out of frame, 19 pct 4 weeks 0.30 Deer-vs-elk specialist model deer called elk, 19 pct 8 weeks 0.21 4. THE DIAGNOSIS Training error 3 percent. Dev error 12. Human-level 2. Unavoidable 2, avoidable bias 1, variance 9. The work goes to variance. 5. FUNDED THIS SPRINT, AND NOT Funded: re-label the dev set. One week, starts Monday. Not funded yet, in order, none cancelled: motion-trigger filter, starts week 2 . infrared denoising, week 4 occlusion augmentation, week 7 . deer-vs-elk specialist model, week 11 EVIDENCE. In this order the dev error goes 11.2, then 6.2 percent by week 6, then 3.6 at week 18. In the order we argued for, with the specialist model first, it is still 11.2 percent at week 6, 9.2 at week 8, and also 3.6 at week 18. Same destination. The order buys eight weeks the field does not spend above 11 percent.

If it will not fit on one page, the model is the wrong unit. Two models on one page is two memos. Split them, date them separately, and let each one be handed to the people who care about that model, which is almost never the same set of people.

Homework

After the last session

40 min
  1. Write the memo for one model you fund, all five sections, on one page, this week. Leave the gaps visible rather than filling them with estimates.
  2. Send it to the person who most recently promised a number to a customer, and ask whether the page would have changed what they said.
  3. Take section five to the sponsor whose project sits last, with the start week beside their row, and note whether the conversation is about the ranking or about the estimate. It is usually the estimate, and the order survives it.
  4. For any language-model product your team ships, write down which of Husain's three levels you currently have. Most teams have level 3 and nothing else, which is the most expensive possible way to learn.
  5. Put the rewrite date in a calendar, with the memo attached to the invitation. A page nobody rewrote is a page that has been quietly wrong for a quarter.
Check yourself

Three questions

Both orders of work reach 3.6 percent dev error at week 18. Why do those three evidence lines belong in the memo rather than just the ranking?

6.2 percent by week 6 against still 11.2, both landing at 3.6 at week 18. The ranking is arguable; the eight weeks the field spends at double-digit error are not, and nobody has to be told their judgement was poor.

Your team ships a product with a language model in it, prompted through an API rather than trained. Which tool from this track stops working, and why?

Avoidable bias is training error minus the optimal error rate, and variance is dev error minus training error. Replace the floor with a different yardstick and say which one you used. A diagnosis computed from an invented input is worse than none, because it is persuasive.

A board asks what you will commit to for the quarter on a model that is currently 12 percent wrong. What is the honest commitment?

Nobody knows in advance which idea will work on a real dataset, so a promised error rate is a guess wearing a commitment's clothes. The four things that are entirely within the team's control can be promised and kept, and reporting them on time buys more credibility than arriving at 94 after committing to 95.

Sources covered

What tonight maps to

✓ Machine Learning Yearning, chapter 58 Building a superhero team - Get your teammates to read this: the one-or-two-page chapter as a design for shared vocabulary, turned into the leader's one-page memo in five sections.
✓ The whole leader track, condensed onto one page Dev set, single metric with satisficing bars, sorted sheet with points per week, three-number diagnosis, one project funded against four with start weeks.
✓ The bench evidence, quoted in the memo 6.2 percent by week 6 in the sheet's order, still 11.2 in the order the team argued for, both reaching 3.6 percent at week 18.
✓ Hamel Husain, Your AI Product Needs Evals The three levels named as where this discipline lands in language-model products, with the friction and the stopping-rule quotes, and the bias-variance tool retired honestly.
◐ Golden sets, judges and regression suites Named as the shape of level 2 at scale. The AI evals course owns the tooling and the eval culture.
◐ Metric definitions, thresholds, calibration The model-evaluation course. Every session so far has taken a metric as given and never defined one.
· A/B testing as a practice Not covered by design. Named only as Husain's third level; the experimentation course owns design, power and analysis.

Session 6 cheat sheet

A strategy in one head is a queueEvery ranking has to pass through the person holding the rule.
One page, five sectionsDev set, metric with bars, sorted sheet, diagnosis, funded against not funded.
Short means arguableA page gets finished, so the pushback lands on the numbers.
The evidence lines carry the room6.2 percent by week 6 against 11.2, both 3.6 at week 18.
A no with a date is a queue positionFour unfunded rows, each with a start week, none cancelled.
Three levels for language modelsUnit tests and assertions, human and model eval, A/B testing. Rising cost.
Looking at the errors is still the jobRemove the friction from it, and keep reading until nothing new arrives.
Promise the four you controlA dev set, a metric, a sheet and a cadence. Never a target error rate.