notid/puzzle-design-kb
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
72af788107eaf09c4ebe4b4a3093a815fed56dba
puzzle-design-kb/todos/TODOS.md

21 KiB
Raw Blame History

TODO List for Puzzle Sampling Chapter

  • Create Inspiration chapter introduction document (src/inspiration.md)

    • Write section explaining purpose: sampling of 30+ games with best puzzles analyzed
    • Document Problem/Why It Works/Solution/Steps format requirements

  • Beneath a Steel Sky: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/beneath-a-steel-sky/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Broken Sword 1: Shadow of the Templars: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/broken-sword-1/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Broken Sword II: The Smoking Mirror: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/broken-sword-ii/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Day of the Tentacle: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/day-of-the-tentacle/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Full Throttle: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/full-throttle/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Gabriel Knight 1: Sins of the Fathers: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/gabriel-knight-1/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Grim Fandango: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/grim-fandango/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Indiana Jones and the Fate of Atlantis: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/indiana-jones-fate-atlantis/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Indiana Jones and the Last Crusade: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/indiana-jones-last-crusade/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • King's Quest III: To Heir Is Human: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/kings_quest_3/ and kings-quest-iii/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • King's Quest VII: The Princeless Bride: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/kings-quest-vii/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • King's Quest VIII: Mask of Eternity: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/kings-quest-viii/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • The Legend of Kyrandia: Book One: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/kyrandia_1/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Loom: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/loom/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Maniac Mansion: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/maniac-mansion/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Quest for Glory 1: Shadows of Darkness: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/quest-for-glory-1/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Quest for Glory II: Trial by Fire: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/quest-for-glory-ii/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Quest for Glory III: Wages of War: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/quest-for-glory-iii/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Quest for Glory IV: Shadows of Darkness: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/quest-for-glory-iv/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Sam & Max Hit the Road: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/sam-max-hit-the-road/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Simon the Sorcerer: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/simon1/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Spacequest 1: The Sarien Encounter: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/spacequest-1/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Spacequest II: The Vohaul Assault: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/spacequest-ii/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Spacequest III: The Pirates of Pestulon: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/spacequest-iii/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Spacequest IV: The Rogerwars: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/spacequest-iv/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Syberia: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/syberia/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • The Dig: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/the-dig/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • The Longest Journey: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/the-longest-journey/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Zak McKracken and the Alien Mindbenders: analyze walkthrough and create game section

    • Examine walkthrough files in src/walkthroughs/zak-mckracken/
    • Identify the 3 best puzzles using analysis-checklist.md criteria
    • Write Problem/Why It Works/Solution/Steps for each puzzle
    • Link each puzzle to its pattern type from the Playbook

  • Edit inspiration pages - screenshot placeholders and accuracy check - IN PROGRESS

    • zak-mckracken-and-the-alien-mindbenders.md - completed
    • the-longest-journey.md - completed
    • the-dig.md - completed
    • syberia.md - add Screenshots sections after Steps, verify against walkthroughs
    • spacequest-iv-the-rogerwars.md - add Screenshots sections after Steps, verify against walkthroughs
    • spacequest-iii-the-pirates-of-pestulon.md - add Screenshots sections after Steps, verify against walkthroughs
    • spacequest-2-the-vohaul-assault.md - add Screenshots sections after Steps, verify against walkthroughs
    • spacequest-1-the-sarien-encounter.md - add Screenshots sections after Steps, verify against walkthroughs
    • simon-the-sorcerer.md - add Screenshots sections after Steps, verify against walkthroughs
    • sam-and-max-hit-the-road.md - add Screenshots sections after Steps, verify against walkthroughs
    • quest-for-glory-iv-shadows-of-darkness.md - add Screenshots sections after Steps, verify against walkthroughs
    • quest-for-glory-iii-wages-of-war.md - add Screenshots sections after Steps, verify against walkthroughs
    • quest-for-glory-ii-trial-by-fire.md - add Screenshots sections after Steps, verify against walkthroughs
    • quest-for-glory-1-shadows-of-darkness.md - add Screenshots sections after Steps, verify against walkthroughs
    • maniac-mansion.md - add Screenshots sections after Steps, verify against walkthroughs
    • 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
    • kings-quest-viii-mask-of-eternity.md - add Screenshots sections after Steps, verify against walkthroughs
    • kings-quest-vii-the-princeless-bride.md - add Screenshots sections after Steps, verify against walkthroughs
    • kings-quest-iii-to-heir-is-human.md - add Screenshots sections after Steps, verify against walkthroughs
    • indiana-jones-and-the-last-crusade.md - add Screenshots sections after Steps, verify against walkthroughs
    • indiana-jones-and-the-fate-of-atlantis.md - add Screenshots sections after Steps, verify against walkthroughs
    • grim-fandango.md - add Screenshots sections after Steps, verify against walkthroughs
    • gabriel-knight-1-sins-of-the-fathers.md - add Screenshots sections after Steps, verify against walkthroughs
    • full-throttle.md - add Screenshots sections after Steps, verify against walkthroughs
    • day-of-the-tentacle.md - add Screenshots sections after Steps, verify against walkthroughs
    • broken-sword-ii-the-smoking-mirror.md - add Screenshots sections after Steps, verify against walkthroughs
    • broken-sword-1-shadow-of-the-templars.md - add Screenshots sections after Steps, verify against walkthroughs
    • beneath-a-steel-sky.md - add Screenshots sections after Steps, verify against walkthroughs
    • 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)

  • Read meta-puzzle-construction.md content

    • Document current structure and examples for merge planning

  • Read repair-chain-construction.md content

    • Identify SQ3 escape pod example and any other unique content

  • 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

  • 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)
Reference in New Issue View Git Blame Copy Permalink