# 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) - [ ] Create information-discovery-parent.md - Write overview explaining information-as-puzzle-solution domain - Link to all 6 child types with brief descriptions - Commit after creation - [ ] Create cognitive-transfer-parent.md - Write overview explaining learned-system-application domain - Link to Pattern Learning, Symbol Code, Metaphor Bridge, Sensory Exploitation, Observation Replay - Commit after creation - [ ] Create spatial-temporal-coordination-parent.md - Write overview explaining cross-context coordination puzzles - Link to Cross-Temporal Causality, Cross-Realm Logistics, Multi-Character Coordination, Timed Consequence - Commit after creation - [ ] Create npc-interaction-parent.md - Write overview explaining social/dialogue-based puzzle domain - Link to Comedy Persuasion, Distraction & Environmental Manipulation, Class-Specific Challenges, Multi-Faction Diplomacy - Commit after creation - [ ] Create systems-and-logic-parent.md - Write overview explaining formal system puzzles (programming, combat-as-puzzle) - Link to Robot Programming, Escalating Combat Progression - Commit after creation - [ ] Create non-standard-domains-parent.md - Write overview explaining non-realistic-causality domain - Link to Surreal Logic Bridge - Commit after creation ## 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: Delete Redundant Types (Content Redistribution) - [ ] Read corporate-infiltration.md content - Extract SQ3 ScummSoft example for redistribution - [ ] Redistribute corporate-infiltration.md content - Move SQ3 ScummSoft Janitor Disguise to distraction-physics.md (stealth section) - If credential gathering chain exists → move to sequential-construction.md - Commit after redistribution complete - [ ] Delete corporate-infiltration.md file - Verify content moved, then remove and commit - [ ] Read predator-chase-escape.md content - Extract G1 cop chase example details - Extract QFG3 leopardman fight details - [ ] Redistribute predator-chase-escape.md content - Move Gabriel Knight 1 cop chase to distraction-physics.md (as Predator Rerouting variant) - Add reference in timed-consequence.md for urgency framing - Evaluate QFG3 leopardman for escalating-combat-progression.md or discard if pure action - Commit after redistribution - [ ] Delete predator-chase-escape.md file - Verify content moved, then remove and commit ## Phase 3: Specific Type Reorganizations - [ ] Promote and expand metaphor-literal.md - Restructure with explicit subtype sections: - Visual Metaphor Transformation (MI2 painted tree → cherry tree) - Wordplay Literalization (SMHTR Bumpus vegetable identity proxy) - Symbolic Identity Substitution (general framework) - Update Related Types to connect with Pattern Learning and Comedy Persuasion - Move to Cognitive Transfer category in SUMMARY.md later - Commit after restructuring - [ ] Document Pattern Learning ↔ Symbol Code Translation relationship - In pattern-learning.md: Add "Extended Visual Variant" section describing Symbol Code - In symbol-code-translation.md: Clarify it "extends Pattern Learning" with visual mapping layer - Update Related Types sections in both files to reference each other - Commit after updates - [ ] Clarify Cross-Temporal Causality ↔ Cross-Realm Logistics relationship - In cross-temporal-causality.md: Add Cross-Realm as "Dimensional Variant" in Related Types - In cross-realm-logistics.md: Add CTC as "Temporal equivalent" in Related Types - Add note that both share same underlying mechanic (action across separated context) - Commit after updates ## Phase 4: Distractor Physics Expansion & Rename - [ ] Read distraction-physics.md current content - Document existing structure before adding new sections - [ ] Rename distraction-physics.md → distraction-environmental-manipulation.md - Add "Predator Rerouting" subsection from redistributed predator-chase content - Integrate SQ3 ScummSoft stealth section from corporate-infiltration - Update Related Types to connect with Timed Consequence - Commit after rename complete ## Phase 5: Cross-Reference Cleanup in Puzzle Type Files - [ ] Audit all puzzle type files for deleted file references - Search for "corporate-infiltration" links and update to appropriate replacements - Search for "predator-chase-escape" links and update to Timed Consequence or Combat - Search for "meta-puzzle-construction" links and update to "sequential-construction" - Search for "repair-chain-construction" links and update to "sequential-construction" - Commit after bulk updates - [ ] Update Related Types sections across all files - Ensure deleted types no longer appear in any Related Types tables - Fix all meta-puzzle → sequential construction references - Verify Multi-Faceted Plan ↔ Sequential Construction relationship is clear - Commit after updates ## Phase 6: Cross-Reference Cleanup in Inspiration Pages - [ ] Audit broken-sword-1.md for deleted/rename references - [ ] Audit maniac-mansion.md for deleted/rename references - [ ] Audit day-of-the-tentacle.md for deleted/rename references - [ ] Audit grim-fandango.md for deleted/rename references - Specifically check meta-puzzle → sequential-construction links - [ ] Audit gabriel-knight-1-sins-of-the-fathers.md - Update predator-chase references to Timed Consequence or Distraction - [ ] Audit spacequest-iii-the-pirates-of-pestulon.md - Update corporate-infiltration references appropriately - [ ] Audit remaining inspiration pages for broken links - [ ] Commit after each batch of 2-3 files updated ## Phase 7: SUMMARY.md Hierarchical Restructure - [ ] Read current SUMMARY.md structure - [ ] Add parent category groupings with descriptions - [ ] Move puzzle type links under appropriate parent categories - [ ] Remove deleted file entries (corporate-infiltration, predator-chase-escape, repair-chain) - [ ] Update link references (meta-puzzle → sequential-construction, distraction-physics → distraction-environmental-manipulation) - [ ] Commit after restructuring complete ## Phase 8: Validation & Build - [ ] Run `mdbook build` to verify no broken links - [ ] If build fails, analyze errors and fix broken links - [ ] Final grep search for any remaining references to: - corporate-infiltration - predator-chase-escape - repair-chain-construction - meta-puzzle-construction - [ ] Commit final fixes if needed ## Deliverables Checklist - [ ] 6 parent category overview pages created - [ ] sequential-construction.md exists (meta-puzzle + repair-chain merged) - [ ] corporate-infiltration.md deleted, content redistributed - [ ] predator-chase-escape.md deleted, content redistributed - [ ] repair-chain-construction.md deleted, content merged - [ ] distraction-environmental-manipulation.md renamed from distraction-physics.md - [ ] All Related Types sections updated across all puzzle type files - [ ] All Inspiration pages checked and links fixed - [ ] SUMMARY.md restructured hierarchically under parent categories - [ ] mdbook build passes with no broken links - [ ] At least 25 commits created (one per completed task)