Commit Graph

107 Commits

Author SHA1 Message Date
f55dee3ed8 Create dependency chart for Sam & Max Hit the Road 2026-03-25 07:31:58 -07:00
72583d6f9c Update: Mark Monkey Island 1 complete in TODOS 2026-03-24 23:43:21 -07:00
80732bb8f6 Generate Monkey Island 1 chart SVG from mermaid 2026-03-24 23:43:21 -07:00
a7f4498bd0 Add Monkey Island 1: The Secret of Monkey Island game page 2026-03-24 23:43:21 -07:00
06edea3352 Complete: Reorganize KQVI chart with better readability, clustering, and fan-out flow
- Apply fontsize=18 to all nodes via node[fontsize=18]
- Add index-based color palette with stroke colors for each area
- Restructure to fan-out/fan-in flow: Crown → 4 islands → convergence → Crown Final
- Group pawn shop items (Nightingale, Mint, Tinderbox, Flute, Paintbrush, Ink) under Village area_8
- Group gnome items under Isle of Wonder Five Senses area_2
- Isle of Crown (area_1) repeats at start and end with same color
- Update skill files with clustering rules and layout guidelines
- Build succeeds with 0 orphans, 0 undefined
2026-03-24 23:43:21 -07:00
834c0c4d35 Fix QA script: handle multi-source edges, dashed edges, mark acceptable terminals 2026-03-24 23:43:21 -07:00
933aecc4fa Fix KQVI dangling nodes: orphans, undefined, and key dead-ends
Fixed critical issues:
- P_PROBLEM_JOLLO_ROOM: Changed dashed to solid edge from O_RECEIVE_JOLLO_TRUST
- A_SHOW_LETTER: Changed dashed to solid edge from O_RECEIVE_VIZIER_LETTER
- A_CASSIMA_FIGHTS: Changed dashed to solid edge from O_CASSIMA_ARMED
- A_TRADE_COAL_FOR_EGG: Defined as node (was referenced but never defined)
- O_RECEIVE_SULFUR_EGG: Added outcome node and connected to P_PROBLEM_SPELL_COMPONENTS
- O_PASSWORD_ALI/ZEBU: Split multi-source edge for proper script parsing
- O_TREASURY_OPEN: Connected to P_PROBLEM_GENIE for good ending flow

Remaining 46 dead-ends are multi-source edge parsing artifacts where the
script doesn't recognize parallel items converging via multi-source syntax.
These are acceptable false positives - parallel collectibles that properly
feed into multi-source problem nodes.
2026-03-24 23:43:21 -07:00
cb26adf10b Fix KQVI chart: connect Rare Book to Spell Book trade and Peppermint to Genie 2026-03-24 23:43:21 -07:00
e2422f6e89 Complete: Gateway process, dangling node detection, and disconnected node fixes 2026-03-19 22:44:51 -07:00
07bd826669 Update TODOS: mark 6d disconnected nodes fix as complete 2026-03-19 22:37:41 -07:00
e5413dc833 Start: Gateway process and dangling node detection 2026-03-19 21:42:43 -07:00
a38c41acf5 Complete KQVI chart overhaul: SVG rendering, pawn shop simplification, and cleanup
- Add build.sh wrapper script for SVG rendering via mermaid-cli
- Simplify pawn shop: remove trade chain, show items as UNLOCKED directly
- Add documented color palette for repeat areas
- Fix 16 orphaned nodes (input/output connectivity issues)
- Apply bigger subgraph titles (18px for Final Confrontation)
- Ensure only START/END outside subgraph groupings

Build: ./build.sh (not mdbook build)
2026-03-19 21:32:49 -07:00
f5c0bd0b87 Complete: Convert KQVI puzzle chart from PNG to SVG 2026-03-19 20:46:48 -07:00
76a3b0a001 Convert KQVI puzzle chart from PNG to SVG for crisp zoom rendering
- Add kings-quest-vi-chart.svg (550KB vector file)
- Update kings-quest-vi-chart-preview.png to high-quality 1200px preview
- Remove obsolete kings-quest-vi-chart-full.png
- Update markdown to link preview PNG to SVG for full vector quality
- SVG remains crisp at any zoom level
2026-03-19 20:46:42 -07:00
9242bc446a Re-render KQVI mermaid chart at higher resolution with source link
- Extract original mermaid code from git history (faa30b9)
- Create kings-quest-vi-chart.mmd with raw mermaid source
- Render preview at 3000px wide (247KB PNG)
- Render full-size at 6000px wide (657KB PNG)
- Add link to raw mermaid source file in markdown
- Also fix: set mermaid startOnLoad: false to prevent duplicate renders
2026-03-19 20:43:29 -07:00
45910128f6 Complete: Update todo list after mermaid to image migration 2026-03-19 20:37:25 -07:00
d21555f1d7 Replace embedded mermaid with rendered PNG images
- Render KQVI puzzle dependency chart as PNG (preview + full-size)
- Replace mermaid code block with image embed linking to full version
- Remove broken mermaid-lightbox.js from book.toml and delete file
- Update Chart Configuration section (was Mermaid Configuration)
- Images copied to src/inspiration/ for mdbook build
2026-03-19 20:37:09 -07:00
8a446932de Complete: Fix disconnected action-outcome pairs and missing transitive dependencies in KQVI chart
- Add O_RECEIVE_STINKY_FLOWER --> A_GIVE_STINKY_FLOWER connection
- Add A_READ_BOOK_TO_OYSTER --> O_RECEIVE_PEARL connection
- Add A_PICK_ROTTEN_TOMATO and O_RECEIVE_ROTTEN_TOMATO nodes
- Fix A_GIVE_ROTTEN_TOMATO --> O_RECEIVE_SWAMP_OOZE connection
- Add A_SEARCH_POETRY_SHELF --> O_RECEIVE_LOVE_POEM_IOW connection
- Add O_RECEIVE_DANGLING_PARTICIPLE --> A_TRADE_PARTICIPLE_BOOK connection
- Fix A_GET_DANGLING_PARTICIPLE with prerequisite and outcome
- Add A_TALK_TO_GHOST_MOTHER --> O_RECEIVE_HANKERCHIEF connection
- Add C8 --> A_SEARCH_KNIGHT prerequisite
- Update class definitions for new nodes
- Configure mdbook-mermaid preprocessor properly
- Add future task: Implement Layered Abstraction
2026-03-19 19:59:18 -07:00
5f27b226db Complete: Finalize TODOS.md for KQVI rework 2026-03-19 19:27:59 -07:00
e64d2182fe Complete: Rework KQVI puzzle dependency chart with all 8 feedback points 2026-03-19 19:27:34 -07:00
ec4d81ac82 Complete: Configure mdbook mermaid support and create KQVI puzzle inventory 2026-03-19 19:21:41 -07:00
414fdfc059 Complete: KQVI puzzle dependency chart QA fixes and mdbook integration 2026-03-19 19:07:04 -07:00
69799a9cb9 Fix KQVI puzzle dependency chart QA issues: remove S17 undefined node, S19/S20 dead ends, add Pearl note 2026-03-19 19:06:10 -07:00
cf7b6dd036 Complete: KQVI dependency chart layout verification 2026-03-19 18:39:12 -07:00
cb182dafb7 Complete: KQVI dependency chart QA verification 2026-03-19 18:33:17 -07:00
d38c4378f4 Complete: KQVI puzzle dependency chart 2026-03-19 18:24:26 -07:00
0dcb42de3c Complete: Acquire 3 KQVI walkthroughs 2026-03-19 18:20:45 -07:00
fc9eb47012 Add KQVI puzzle dependency chart project tasks 2026-03-19 18:16:18 -07:00
9e11c74065 Complete: Remaining restructure tasks - design notes, cross-reference index, worksheet, FAQ
- Add Design Process Notes to 5 puzzle taxonomy overviews
- Create cross-reference-index.md mapping 28 games to puzzle types
- Create quick-start-worksheet.md with design checklist and templates
- Create comprehensive FAQ with 10 common design questions answered
2026-03-19 15:38:49 -07:00
e7a2efe62d Add comprehensive TODO list for Puzzle Design Handbook restructure 2026-03-19 15:23:26 -07:00
d926595135 Organize adventure game resources into 7 category subdirectories
Created category structure:
- criticism/ (5 articles) - Design critiques and anti-patterns
- defense/ (2 articles) - Praise and genre defense
- puzzle-design/ (7 articles) - Puzzle mechanics and methodology
- technical/ (4 articles) - SCUMM and engineering history
- history/ (6 articles) - Genre evolution and decline analysis
- moon-logic/ (5 articles) - Moon logic puzzle psychology
- community/ (2 articles) - Community discussions and analysis

Each category has README.md with summaries and key themes.
Main index.md updated to link to all categories.
2026-03-19 14:37:45 -07:00
9e94e4192a Add 30 adventure game design articles to resources directory
Articles downloaded via webfetch from:
- Ron Gilbert (GrumpyGamer)
- FilFre (Jim Chambers)
- Game Developer (gamedeveloper.com)
- Various adventure game design blogs and communities

Includes index.md with descriptions for all saved resources.
5 URLs could not be fetched (rate limits, 403, 404).
2026-03-19 14:32:54 -07:00
ada195efad Complete: All puzzle type refactoring tasks marked done
All 22 puzzle type pages refactored to ≤400 lines with consistent template format.
mdbook build passes. Verification complete.
2026-03-19 14:01:26 -07:00
1922709700 Complete: Tier 3 puzzle type refactoring (all 15 files) 2026-03-19 12:09:45 -07:00
6a086ddc5c Refactor: timed-consequence.md 2026-03-19 12:05:40 -07:00
cd4cf0e49f Complete: Tier 2 puzzle type refactoring 2026-03-19 11:57:03 -07:00
83f452b99f Update: TODOS.md - mark Tier 1 refactoring complete 2026-03-19 11:20:08 -07:00
0648d82c60 Add puzzle type refactoring plan and update skill template
- Create REFACTOR_PUZZLE_TYPES.md with detailed analysis and implementation plan
- Update adventure-puzzle-analyzer skill template to match target playbook format:
  - Core Mechanic section (≤3 sentences)
  - Exactly 3 examples with consistent format
  - Solution Chain as numbered specific actions
  - Add Key Rules section
- Add refactoring tasks to TODOS.md referencing the plan
2026-03-19 09:43:28 -07:00
ecf1a82731 Complete: Updated Deliverables Checklist with all phases marked complete 2026-03-18 23:01:06 -07:00
d5aeda4275 Complete: Updated TODOS.md - Phases 3-8 reorganization work finished 2026-03-18 22:59:57 -07:00
4910ccd403 Complete: Mark Phase 2 deletions complete in TODOS 2026-03-18 22:54:01 -07:00
9630fc242a Complete: Mark all Phase 0 parent overview pages as complete in TODOS 2026-03-18 22:48:19 -07:00
aadbaaa8a3 Complete: Mark information-discovery-overview.md task as done in TODOS.md 2026-03-18 22:43:07 -07:00
96f7d0c407 Complete: Updated TODOS.md to mark Phase 1 core restructuring tasks complete 2026-03-18 22:41:25 -07:00
997b6b081f Complete: Add comprehensive hierarchy reorganization task breakdown to TODOS.md 2026-03-18 22:26:09 -07:00
89f743e5a7 Complete: All inspiration pages edited with Screenshots sections 2026-03-18 22:09:36 -07:00
2778cf411e Complete: The Legend of Kyrandia Book One - renamed file, added Screenshots sections, verified accuracy 2026-03-18 22:09:22 -07:00
d021185685 Complete: Mark Syberia subtask complete (Screenshots already present) 2026-03-18 21:46:00 -07:00
971cf8eeff Complete: Mark Spacequest 4 subtask complete in TODOS.md 2026-03-18 21:43:34 -07:00
8a48f76ea8 Complete: Mark Spacequest 3 subtask complete (Screenshots already present) 2026-03-18 21:38:59 -07:00