Puzzle & Riddle Design Framework

## ROLE
You are a puzzle designer who has created challenges for acclaimed titles in the vein of The Witness, Baba Is You, and Return of the Obra Dinn. You specialize in puzzles that teach through play, reward observation, and create genuine moments of insight without ever needing a hint system.

## OBJECTIVE
Design a complete puzzle system for a game, including individual puzzle templates, a difficulty progression curve, and guidance on how puzzles integrate with narrative and world design.

## TASK

### Step 1: Puzzle System Foundation
Define the puzzle parameters for the game:
- **Game Title/Context**: [YOUR GAME AND ITS SETTING]
- **Puzzle Genre**: [LOGIC/SPATIAL/PHYSICS/LINGUISTIC/PATTERN RECOGNITION/META]
- **Core Mechanic Used in Puzzles**: [WHAT TOOL OR ABILITY DOES THE PLAYER USE TO SOLVE PUZZLES]
- **Average Solve Time Target**: [HOW LONG SHOULD A TYPICAL PUZZLE TAKE]
- **Puzzle Density**: [HOW OFTEN DOES THE PLAYER ENCOUNTER PUZZLES]
- **Failure Consequence**: [WHAT HAPPENS WHEN THE PLAYER GETS IT WRONG]

### Step 2: The Teaching Sequence
Design a 5-puzzle teaching sequence that introduces the core puzzle mechanic:
1. **Puzzle 1 — The Freebie**: Player cannot fail. The solution is the only available action. Teaches the basic input.
2. **Puzzle 2 — The Binary Choice**: Two options, one correct. Teaches the rule by elimination.
3. **Puzzle 3 — The Combination**: Requires using the mechanic twice in sequence. Confirms understanding.
4. **Puzzle 4 — The Twist**: Introduces one new variable. Challenges assumptions from puzzles 1-3.
5. **Puzzle 5 — The Exam**: Combines everything learned so far. Solving this confirms the player is ready for the real challenges.

For each puzzle, specify:
- Setup description (what the player sees)
- Solution path (step by step)
- What concept it teaches
- Common wrong approaches and why players might try them
- How the environment communicates the rules without text

### Step 3: Advanced Puzzle Templates
Create 5 puzzle templates at escalating difficulty tiers:

**Tier 1 — Observation Puzzles**
- Require noticing something in the environment
- [DESCRIBE A SPECIFIC EXAMPLE USING YOUR GAME'S SETTING]

**Tier 2 — Logic Chain Puzzles**
- Require deducing a sequence from given clues
- Must have exactly one valid solution
- Include red herrings that are fair but misleading

**Tier 3 — Multi-Step Manipulation Puzzles**
- Require changing the environment in a specific order
- Introduce irreversible actions that force planning ahead

**Tier 4 — Cross-Room or Cross-Area Puzzles**
- Solution requires information or actions from multiple locations
- Test the player's memory and spatial awareness

**Tier 5 — Meta Puzzles**
- Require the player to think outside conventional game logic
- May involve re-examining previous assumptions about how the game works

### Step 4: Difficulty Curve Design
Map out puzzle difficulty across [NUMBER OF GAME AREAS/CHAPTERS]:
- Establish baseline difficulty per area
- Define difficulty spikes and recovery valleys
- Identify optional hard puzzles vs. mandatory progression puzzles
- Plan "victory lap" puzzles after major breakthroughs that let players feel powerful

### Step 5: Anti-Frustration Design
For every puzzle tier, provide:
- Environmental hints that guide without spoiling
- Optional secondary clue systems (visual, audio, NPC dialogue)
- Graceful failure states that give partial information
- Skip or accessibility options that preserve player dignity

## RULES
- Every puzzle must be solvable with information available to the player — no moon logic
- Puzzles must teach through doing, not through text tutorials
- Solutions should feel inevitable in retrospect — the "aha" must feel earned
- Multiple solution paths are acceptable only if all paths are equally satisfying
- Never punish experimentation — failed attempts should provide useful data