Files
puzzle-design-kb/todos/TODOS.md

385 lines
21 KiB
Markdown

# 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 <small> 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)
- [x] 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
- [x] 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
- [x] 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 1 Status
- [x] pattern-learning.md refactored (75 lines)
- [x] sensory-exploitation.md refactored (88 lines)
- [x] multi-faceted-plan.md refactored (89 lines)
## Phase 2: Refactor Tier 2 Pages
- [x] Refactor `sequential-construction.md` — needs Core Mechanic, trim examples
- [x] Refactor `information-brokerage.md` — needs format cleanup
- [x] Refactor `environmental-storytelling.md` — needs format cleanup
- [x] Refactor `memo-chain.md` — needs format cleanup
- [x] Verify all Related Types links after refactoring
- [x] Run mdbook build to check for broken links
## 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
## Tier 3 Refactoring Tasks (15 files - need format cleanup)
- [x] Refactor `truth-revelation.md` (124 lines → ensure ≤400, 3 examples, proper format)
- [x] Refactor `cross-temporal-causality.md` (456 lines → trim to 3 examples, proper format)
- [x] Refactor `cross-realm-logistics.md` (472 lines → trim to 3 examples, proper format)
- [x] Refactor `multi-character-coordination.md` (662 lines → trim to 3 examples, proper format)
- [x] Refactor `timed-consequence.md` (528 lines → trim to 3 examples, proper format)
- [x] Refactor `comedy-based-persuasion.md` (230 lines → ensure proper format)
- [x] Refactor `distraction-environmental-manipulation.md` (551 lines → trim to 3 examples)
- [x] Refactor `class-specific-ritual.md` (299 lines → trim to 3 examples, proper format)
- [x] Refactor `multi-faction-diplomacy.md` (233 lines → trim to 3 examples, proper format)
- [x] Refactor `robot-programming.md` (314 lines → trim to 3 examples, proper format)
- [x] Refactor `escalating-combat-progression.md` (302 lines → trim to 3 examples, proper format)
- [x] Refactor `surreal-logic-bridge.md` (247 lines → ensure proper format)
- [x] Refactor `metaphor-literal.md` (252 lines → ensure proper format)
- [x] Refactor `observation-replay.md` (620 lines → trim to 3 examples, proper format)
- [x] Refactor `symbol-code-translation.md` (800+ lines → trim to 3 examples, proper format)
## 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