antipattern

Use when

A puzzle solution depends on knowledge the game did not provide.

What it is. A puzzle whose answer follows not from what the game showed but from what the author happened to be thinking. The player doesn’t deduce — they guess your intent, or open a wiki.

Why it hurts. A solvable puzzle you failed teaches you. A guess-the-designer puzzle you “solved” teaches you nothing — you learned that the game lies about what its rules are. Trust dies, and every later puzzle now feels like a coin-flip. See pattern-fairness-and-trust.

The smell

The solution requires a rule, verb, or fact the game never taught, showed, or implied at that moment. The path to the answer runs through the author’s head, not the board.

How it happens

CauseWhat it looks like
Untaught verbThe solve needs an interaction (push a specific tile, combine two objects) the game never demonstrated.
Off-screen stateThe clue lives in a manual, a loading screen, an earlier room, or a mechanic three levels back.
Moon-logicTwo objects combine only because the designer’s word-association says so — the adventure-game “cat-hair mustache” (Gabriel Knight 3), the whole point-and-click moon-logic lineage.
Invisible affordanceThe lever exists but reads as decoration — a pattern-readability failure masquerading as difficulty.
Pixel-huntThe answer is there but sub-threshold: one pixel, one frame, one unlabeled hotspot.
Author’s blind spotObvious to the person who built it; opaque to anyone arriving cold. Playtest-of-one.

The tell

Check YOUR design against these before handoff:

The fix

Telegraph the rule, then let the solution fall out of it. Every fact the answer needs must be legible on the board, in the last five seconds, or in a verb the player already owns.

Twist seams

Legit designs that flirt with this line — and stay honest by paying a specific toll (twist vector in parens):

Seen in / near it

Neighbors

Verify / guard

The board must be solvable by deduction from what’s on it — prove it the way genre-grid-puzzle demands. See design/FUN.md#1-·-grid-puzzle: a machine solver proves winnability, but you must confirm the winning line uses only taught rules. Reference examples/sokoban/ for the pure-logic split that keeps the rule set inspectable. A solver that wins via an untaught verb is a red flag, not a green check.

This module rendersthe repo's markdowndirectly — edit it there, it changes here.