# TODO List for Puzzle Sampling Chapter - [x] Create Inspiration chapter introduction document (src/inspiration.md) - [x] Write section explaining purpose: sampling of 30+ games with best puzzles analyzed - [x] Document Problem/Why It Works/Solution/Steps format requirements - [x] Beneath a Steel Sky: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/beneath-a-steel-sky/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Broken Sword 1: Shadow of the Templars: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/broken-sword-1/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Broken Sword II: The Smoking Mirror: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/broken-sword-ii/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Day of the Tentacle: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/day-of-the-tentacle/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Full Throttle: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/full-throttle/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Gabriel Knight 1: Sins of the Fathers: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/gabriel-knight-1/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Grim Fandango: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/grim-fandango/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Indiana Jones and the Fate of Atlantis: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/indiana-jones-fate-atlantis/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Indiana Jones and the Last Crusade: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/indiana-jones-last-crusade/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] King's Quest III: To Heir Is Human: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/kings_quest_3/ and kings-quest-iii/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] King's Quest VII: The Princeless Bride: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/kings-quest-vii/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] King's Quest VIII: Mask of Eternity: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/kings-quest-viii/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] The Legend of Kyrandia: Book One: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/kyrandia_1/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Loom: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/loom/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Maniac Mansion: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/maniac-mansion/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Quest for Glory 1: Shadows of Darkness: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/quest-for-glory-1/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Quest for Glory II: Trial by Fire: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/quest-for-glory-ii/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Quest for Glory III: Wages of War: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/quest-for-glory-iii/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Quest for Glory IV: Shadows of Darkness: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/quest-for-glory-iv/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Sam & Max Hit the Road: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/sam-max-hit-the-road/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Simon the Sorcerer: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/simon1/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Spacequest 1: The Sarien Encounter: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/spacequest-1/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Spacequest II: The Vohaul Assault: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/spacequest-ii/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Spacequest III: The Pirates of Pestulon: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/spacequest-iii/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Spacequest IV: The Rogerwars: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/spacequest-iv/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Syberia: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/syberia/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] The Dig: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/the-dig/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] The Longest Journey: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/the-longest-journey/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Zak McKracken and the Alien Mindbenders: analyze walkthrough and create game section - [x] Examine walkthrough files in src/walkthroughs/zak-mckracken/ - [x] Identify the 3 best puzzles using analysis-checklist.md criteria - [x] Write Problem/Why It Works/Solution/Steps for each puzzle - [x] Link each puzzle to its pattern type from the Playbook - [x] Edit inspiration pages - screenshot placeholders and accuracy check - IN PROGRESS - [x] zak-mckracken-and-the-alien-mindbenders.md - completed - [x] the-longest-journey.md - completed - [x] the-dig.md - completed - [x] syberia.md - add Screenshots sections after Steps, verify against walkthroughs - [x] spacequest-iv-the-rogerwars.md - add Screenshots sections after Steps, verify against walkthroughs - [x] spacequest-iii-the-pirates-of-pestulon.md - add Screenshots sections after Steps, verify against walkthroughs - [x] spacequest-2-the-vohaul-assault.md - add Screenshots sections after Steps, verify against walkthroughs - [x] spacequest-1-the-sarien-encounter.md - add Screenshots sections after Steps, verify against walkthroughs - [x] simon-the-sorcerer.md - add Screenshots sections after Steps, verify against walkthroughs - [x] sam-and-max-hit-the-road.md - add Screenshots sections after Steps, verify against walkthroughs - [x] quest-for-glory-iv-shadows-of-darkness.md - add Screenshots sections after Steps, verify against walkthroughs - [x] quest-for-glory-iii-wages-of-war.md - add Screenshots sections after Steps, verify against walkthroughs - [x] quest-for-glory-ii-trial-by-fire.md - add Screenshots sections after Steps, verify against walkthroughs - [x] quest-for-glory-1-shadows-of-darkness.md - add Screenshots sections after Steps, verify against walkthroughs - [x] maniac-mansion.md - add Screenshots sections after Steps, verify against walkthroughs - [x] the-legend-of-kyrandia-book-one.md - add Screenshots sections after Steps, verify against walkthroughs, rename file from kyrandia-1-shadow-of-the-fox.md - [x] kings-quest-viii-mask-of-eternity.md - add Screenshots sections after Steps, verify against walkthroughs - [x] kings-quest-vii-the-princeless-bride.md - add Screenshots sections after Steps, verify against walkthroughs - [x] kings-quest-iii-to-heir-is-human.md - add Screenshots sections after Steps, verify against walkthroughs - [x] indiana-jones-and-the-last-crusade.md - add Screenshots sections after Steps, verify against walkthroughs - [x] indiana-jones-and-the-fate-of-atlantis.md - add Screenshots sections after Steps, verify against walkthroughs - [x] grim-fandango.md - add Screenshots sections after Steps, verify against walkthroughs - [x] gabriel-knight-1-sins-of-the-fathers.md - add Screenshots sections after Steps, verify against walkthroughs - [x] full-throttle.md - add Screenshots sections after Steps, verify against walkthroughs - [x] day-of-the-tentacle.md - add Screenshots sections after Steps, verify against walkthroughs - [x] broken-sword-ii-the-smoking-mirror.md - add Screenshots sections after Steps, verify against walkthroughs - [x] broken-sword-1-shadow-of-the-templars.md - add Screenshots sections after Steps, verify against walkthroughs - [x] beneath-a-steel-sky.md - add Screenshots sections after Steps, verify against walkthroughs - [x] loom.md - add Screenshots sections after Steps, verify against walkthroughs # Puzzle Type Hierarchy Reorganization ## Phase 0: Create Parent Category Overview Pages (6 files) - [x] Create information-discovery-parent.md - [x] Write overview explaining information-as-puzzle-solution domain - [x] Link to all 6 child types with brief descriptions - [x] Commit after creation - [x] Create cognitive-transfer-overview.md ✓ - [x] Create spatial-temporal-coordination-overview.md ✓ - [x] Create npc-interaction-overview.md ✓ - [x] Create systems-and-logic-overview.md ✓ - [x] Create non-standard-domains-overview.md ✓ ## Phase 1: Core Restructuring (Sequential Construction Merge) - [x] Read meta-puzzle-construction.md content - Document current structure and examples for merge planning - [x] Read repair-chain-construction.md content - Identify SQ3 escape pod example and any other unique content - [x] Create sequential-construction.md (rename + merge) - Start with meta-puzzle-construction.md content - Add "Repair/Restoration Chains" section with SQ3 escape pod - Update headers to reflect new parent categorization - Commit after creation - [x] Delete repair-chain-construction.md - Verify all content migrated first - Remove file and commit - [ ] Restructure multi-faceted-plan.md - Explicitly define "Parallel MFP" as primary variant (non-linear gathering) - Remove claim that Sequential Construction is a variation - Update Related Types table to reference Sequential Construction as sibling type - Keep parallel examples only (MI1 Voodoo Doll, SMHTR Bigfoot Totem) - Commit after restructuring ## PHASE 2 COMPLETE ✓ - Delete Redundant Types (Content Redistribution) - [x] Read corporate-infiltration.md content ✓ - [x] Redistribute corporate-infiltration.md content ✓ - Moved SQ3 ScummSoft Janitor Disguise to distraction-physics.md (stealth section) - Commit: cf7de16 - [x] Delete corporate-infiltration.md file ✓ - [x] Read predator-chase-escape.md content ✓ - [x] Redistribute predator-chase-escape.md content ✓ - Moved SQ3 Arnoid chase to distraction-physics.md (as Predator Rerouting variant) - Added relationship reference in timed-consequence.md - Note: G1 cop chase not present; only SQ3 example existed - Commits: 82c7573, 66100f4 - [x] Delete predator-chase-escape.md file ✓ ## Phase 3 COMPLETE ✓: Specific Type Reorganizations - [x] Promote and expand metaphor-literal.md (commit: 90ed5a0) - [x] Document Pattern Learning ↔ Symbol Code Translation relationship (commit: a40f863) - [x] Clarify Cross-Temporal Causality ↔ Cross-Realm Logistics relationship (commit: f24a6a6) ## Phase 4 COMPLETE ✓: Distractor Physics Rename - [x] Rename distraction-physics.md → distraction-environmental-manipulation.md (commit: bccd834) ## Phase 5 & 6 COMPLETE ✓: Cross-Reference Cleanup - [x] Bulk updated all puzzle type files and inspiration pages (commits: 74ddc46, eed5e8c, a24fa98) - [x] Updated README.md (commit: 0552e49) - [x] Updated SUMMARY.md (commit: ae47737) ## Phase 8 COMPLETE ✓: Validation & Build - [x] mdbook build passes with only pre-existing warnings (unclosed tags) - [x] Final grep confirms zero remaining references to deleted types ## Deliverables Checklist ✓ ALL COMPLETE - [x] 6 parent category overview pages created ✓ (info-discovery, cognitive-transfer, spatial-temporal, npc-interaction, systems-and-logic, non-standard-domains) - [x] sequential-construction.md exists (meta-puzzle + repair-chain merged) ✓ - [x] corporate-infiltration.md deleted, content redistributed ✓ → distraction-physics.md - [x] predator-chase-escape.md deleted, content redistributed ✓ → distraction-physics.md + timed-consequence.md - [x] repair-chain-construction.md deleted, content merged ✓ → sequential-construction.md - [x] distraction-environmental-manipulation.md renamed from distraction-physics.md ✓ - [x] All Related Types sections updated across all puzzle type files ✓ (commits: 74ddc46) - [x] All Inspiration pages checked and links fixed ✓ (commit: eed5e8c - bulk update of 27 files) - [x] SUMMARY.md restructured hierarchically under parent categories ✓ (needs final review) - [x] mdbook build passes with no broken links ✓ (only pre-existing HTML tag warnings remain) - [x] At least 25 commits created ✓ - Total hierarchy work commits: ~35+ See commit history above for full breakdown by phase. --- # Puzzle Type Page Refactoring See [REFACTOR_PUZZLE_TYPES.md](../REFACTOR_PUZZLE_TYPES.md) for detailed plan. ## Phase 1: Pilot - Refactor Tier 1 Pages (Most Verbose) - [ ] Refactor `pattern-learning.md` (target: ≤400 lines, 3 examples) - Keep: Core Mechanic, Solution Chain, 3 best examples - Move: Extended MI2/MI1/BAS/QFG4 analysis → respective game inspiration pages - Commit after each change - [ ] Refactor `sensory-exploitation.md` (target: ≤400 lines, 3 examples) - Keep: Core Mechanic, 3 examples (parrot, poodle, Medusa mirror) - Move: QFG3 honeybird/meerbat, Loom tower, etc. → inspiration pages - [ ] Refactor `multi-faceted-plan.md` (target: ≤400 lines, 3 examples) - Keep: Core Mechanic, parallel MFP examples only - Move: QFG2/QFG3/QFG4 multi-examples → inspiration pages ## Phase 2: Refactor Tier 2 Pages - [ ] Refactor `sequential-construction.md` — needs Core Mechanic, trim examples - [ ] Refactor `information-brokerage.md` — needs format cleanup - [ ] Refactor `environmental-storytelling.md` — needs format cleanup - [ ] Refactor `memo-chain.md` — needs format cleanup ## Phase 3: Review and Cleanup Tier 3 Pages - [ ] Review and cleanup remaining puzzle type pages (≤400 lines each) - [ ] Verify Related Types tables are consistent across all pages ## Phase 4: Validation - [ ] Run `npx remark-cli` on all changed files - [ ] Run `mdbook build` to verify no broken links - [ ] Final review of SUMMARY.md navigation structure