The puzzle design pyramid: mechanic, theme, emotion

The last dispatch was about the worksheet — categories, drafts, the iteration scars. This one is about what sits inside a single row of the worksheet, vertically. Every puzzle we ship has three layers. We started calling it the pyramid about a year in because we kept losing arguments by talking past each other; one of us would be objecting to the mechanic, another to the theme, and the third would mean the emotion when she said this doesn't work. Now we have words for the layers. The arguments are shorter.

1. The three layers

The mechanic is the technical solvability of the puzzle. It is what a stranger would write down if you asked them to describe what the player is being asked to do, in the most boring possible way. Multiply two numbers. Spot the one page that is different. Substitute symbols for letters until a word appears. Pick the cell on the grid that satisfies two constraints at once. The mechanic answers the question can this be solved on a screen, in a session, by a person who has not been told the answer. It is the load-bearing column. If the mechanic is broken, nothing the other two layers do can save the puzzle.

The theme is what the puzzle is about in-world. Not the mechanic dressed up in cardboard scenery — what the puzzle is genuinely a piece of, in Vellestria. This is a chart correction the Council refused to sign in 2018. This is a catalog rule Master Branwen enforces. This is a constellation alignment that has been the same for forty thousand years and the observer's hand has shifted by a degree. The theme answers the question why is this puzzle in the world, and why would anyone in the world care about it. A puzzle without theme is a puzzle that could be lifted out of Vellestria, dropped into any other game, and lose nothing. We do not ship those.

The emotion is what Cora — and by extension the player — feels after the answer is accepted. Not the abstract feeling of I solved it. The specific feeling of I now know one thing about this person, this room, or this family that I did not know one screen ago. The emotion answers the question what was the puzzle a doorway into. The classic puzzle adventures of the 2000s knew the third layer existed before the genre had a name for it; their best puzzles were never really about the gears, they were about the small grief or affection that the solving revealed. We are working in that tradition, and we are working out the third layer one puzzle at a time.

Three layers, stacked. Mechanic at the base, theme in the middle, emotion at the top. The pyramid only stands if all three are doing work.

2. The worked example: Master Branwen's Quartered Scroll

This is a puzzle we shipped at the end of Chapter 6, in the Restricted Stacks of the Library Quarter, on the day Cora goes upstairs to see Branwen and comes back down with more than she went up with. The puzzle is small. Most players solve it in under two minutes. It is also the puzzle we point at when someone asks what we mean by the pyramid.

The mechanic

A long parchment scroll, twenty-four inches by eighteen. Two straight cuts, one parallel to each pair of edges. Each cut runs from edge to edge. The result has to be four congruent rectangular cards. What is the area of each card. The answer is one hundred eight square inches. The work is one multiplication after one observation: both cuts must bisect the scroll, or the cards are not congruent. The mechanic is arithmetic-grid with a spatial wrapper. A determined twelve-year-old solves it on the back of an envelope in ninety seconds. There is no trick. There is no false-positive answer. The mechanic is doing the minimum a mechanic has to do, which is not get in the way.

If we had stopped at the mechanic, this puzzle would have been a school-textbook geometry exercise sitting in a fantasy library for no reason. We have shipped puzzles like that. We are not proud of them.

The theme

The theme is the catalog. Master Branwen quarters her own scrolls before binding them — she has been Library Keeper for thirty years and her cataloguing system refuses to ingest a chart that is not quartered to her tolerances. The post-solve line, spoken by Branwen as Cora hands her the cut sheets, is "One hundred eight square inches per card. Both cuts through the midpoint — the only way four pieces come out congruent. I quarter charts the same way before binding. The catalog refuses to enter anything unequal." That line is the theme. The mechanic is multiplication. The theme is this is how a particular old woman has organised forty years of her professional life. The Library does not run on archive software. It runs on Branwen's discipline. The puzzle is a small piece of evidence of that discipline.

The theme is what turns the puzzle from a geometry exercise into a moment in a real room. The room has a desk. The desk has a scroll. The scroll has rules. The rules are Branwen's. The puzzle is the rules.

The emotion

The emotion is the harder one to write about, and it is the one that took us four drafts to get right.

The Restricted Stacks are where Cora's grandfather Theodor used to work, when he was alive. Branwen knew him for fifty years; we will not say more about that in the dispatch than the canon says in the chapter. The desk Cora cuts the scroll on is the desk Theodor used. When the player solves the puzzle and Branwen takes the four cards from Cora's hands, Branwen does not thank her. She says the catalog line. Then she stacks the cards squarely on the corner of the desk, the way she has stacked things on that corner of that desk for thirty years, and she says, almost to herself, "He stacked them the other way. Long edge to the wall." That is the whole emotion of the puzzle.

The player has now learned three things that were not in the puzzle before they solved it. They have learned that Branwen has a catalog rule, and that the rule predates Cora. They have learned that Theodor stacked his cards differently — that there were always two ways of doing this, in this room, between these two people. And they have learned that Branwen remembers which way he stacked them, after a year of him being dead. The puzzle is one hundred eight square inches. The doorway is fifty years long.

That is the pyramid working. Mechanic at the base, theme in the middle, emotion at the top. Take any one of them out and the puzzle loses something we cannot put back.

3. The three failure modes

We have, in three years of drafting, found three reliable ways to break a puzzle. Each one corresponds to a missing layer.

Skip the emotion, and the puzzle feels arbitrary. We had a Chapter 4 draft, before we cut it, that was a clean cipher: Eustache hands Cora a star map, four constellations, one of them named in the cipher of Lambert Verras. Decode the name. The mechanic was good. The theme was good — this was Eustache's domain, his telescope, his calibration. But the answer accepted, the scene moved on, and Cora gained nothing she did not have on the previous screen. The puzzle was a checkpoint. We cut it. The replacement is the puzzle that hides a fragment in the hollow base of the telescope itself; the same mechanic, the same theme, plus a doorway. That extra layer cost us three weeks of rewrites.

Skip the theme, and the puzzle feels disconnected. This is the most common failure mode, and the one we still catch ourselves making. A puzzle without theme is a puzzle where the in-world wrapping could be peeled off and replaced with anything. A grid of numbers labelled cargo manifest that could just as easily be labelled parking lot; a riddle attributed to a character who never speaks again; an observation puzzle on a canvas that has no reason to be on the wall of this particular shop. The mechanic still works. The world stops believing in itself.

Skip the mechanic, and the puzzle feels unsolvable. This one is less common because the build pipeline catches it — a puzzle without a working mechanic does not pass the playtest gate. But we have drafted, more than once, puzzles where the theme and the emotion were so loud that we papered over a mechanic that had two valid answers, or required a piece of knowledge the player did not yet have, or relied on a constraint that was true in the worksheet and not on the screen. Those puzzles always feel beautiful in the draft and broken in the build. The mechanic is the floor of the pyramid. If the floor is unsound, the rest collapses on the player's head.

Three failure modes. We catch most of them. The ones we miss become the audit notes we read on the live site and wince at, the morning after a ship.

The pyramid is not a theory. It is a habit. We have a column in the worksheet now, between category and world load, called all three?. The puzzle does not get a green tick in that column until somebody on the team can say, out loud, what the mechanic is, what the theme is, and what the player feels after the answer is accepted. Three answers, three layers, three sentences. If any of the three sentences come out fuzzy, the puzzle goes back to the draft folder. We do not always catch it before ship. But we catch more of it now than we did a year ago, and the puzzles that come out the other side stand straighter for it.

Cora's note: The desk in the Restricted Stacks has a small ink-burn at the long edge where someone, decades ago, set down a hot kettle without a trivet. I noticed it the second time Branwen sent me up there. She has not had it sanded. The burn is older than I am. I think she keeps it the way one keeps a coastline on a map — because the shape is the record, and the record is the point.