Skip to content

The Shift

The flash cards nobody wrote

Every lesson in SavorCrew flips into a deck of cards, and no one authored them. They are derived from the lesson at the moment you open it — which is a design decision with a specific consequence: the cards cannot go stale, because there is nothing separate to go stale.

· 6 min

Ask anyone who has run restaurant training what kills it, and they will not say the content. They will say the second copy.

You write the lesson. Then you write the quiz. Then somebody wants study cards, so you write those too. Then the menu changes, and now three things have to change — and in practice one of them doesn’t, so the cards quietly teach last season’s bacon for a year.

We did not want that failure mode, so the cards are not a second copy.

What actually happens

Open a lesson in SavorCrew and there is a toggle: read it, or study it. Flip to study and you get a deck — front of card, think, turn it over. The deck was built from the lesson body you are already looking at, at the moment you asked for it.

Nobody authored it. There is no cards table. Change one word in the lesson and the deck changes with it, because the deck is the lesson, read a different way.

:::key The one-sentence version There is no second copy, so there is nothing to keep in sync. :::

Why that is harder than it sounds

A lesson is prose with structure — headings, callout boxes, bullets, emphasis. A flash card is a question and an answer. Turning the first into the second without a human is where this usually goes wrong, and produces cards like “Front: Beginnings. Back: Beginnings.”

So the derivation has rules, and most of them are about refusing to make a card:

  • A heading on its own is not a card. It is a label
  • A line that refers to itself — “as described above”, “see the table below” — makes a card that is nonsense once it is out of context, so it is skipped
  • A lead-in fragment that only makes sense followed by a list is skipped
  • Anything too long to fit on the back of a card is skipped rather than truncated, because a card that trails off mid-sentence teaches the wrong half
  • Anything too short on the front is skipped, because “Fontina?” is not a question

What survives is the material that was already shaped like a fact: a term and its meaning, a dish and its components, a step and its standard.

The part we are honest about

The deck does not cover the whole lesson, and the app tells you so rather than implying a full sweep. Some prose genuinely is not flash-card material — a paragraph about why marks land before the food is an idea, not a fact to be drilled, and chopping it into cards would make it worse.

So the study mode is a supplement to reading the lesson, not a replacement for it, and it says as much. A tool that overstates its own coverage teaches people to trust it exactly as far as the first time it lets them down.

Where the quiz fits

The quiz is separate, and deliberately so. The cards are for revising; the quiz is the gate, marked on the server so the phone never holds the answer key. Stages unlock in order, retakes are unlimited, and every attempt is kept with its score and date.

One rule underneath all of it: the gate is on the content and never on the schedule, the clock or pay. Failing a quiz does not stop anybody being rostered or clocking in. A quiz that can cost somebody a shift stops being a learning tool the day people work that out, and starts being something they game.

What it took

Flash-card derivation, the rich lesson format it reads, and the block parser underneath are covered by 34 automated tests — 15 on the card rules alone, checking the refusals as much as the cards.

The refusals are the bulk of that suite. It is easy to test that a card got made; the tests that matter check that the nonsense ones did not.