Commit Graph

141 Commits

Author SHA1 Message Date
1686ad756e Fix disconnected/siloed nodes in KQVI chart
Fixed problem nodes without outputs:
- P_PROBLEM_BOILING_POOL --> A_COOL_POOL
- P_PROBLEM_DARK_L2 --> A_LIGHT_TINDERBOX
- P_PROBLEM_STYX --> A_COLLECT_STYX_WATER
- P_PROBLEM_JOLLO_ROOM --> A_GIVE_LAMP_REPLICA

Connected action chains:
- A_GIVE_LAMP_REPLICA --> O_JOLLO_HELPS
- O_RECEIVE_JOLLO_TRUST -.-> P_PROBLEM_JOLLO_ROOM (optional prerequisite)
- A_SHOW_LETTER --> P_PROBLEM_VIZIER
- A_CASSIMA_FIGHTS --> P_PROBLEM_VIZIER

Fixed O_SPELL_READY connection:
- A_COLLECT_COMPONENTS --> O_SPELL_READY
- O_SPELL_READY --> A_CAST_CHARM_SPELL

Remaining 6 orphans are optional/narrative items or redundant definitions.
2026-03-19 21:28:43 -07:00
d6c784c8b2 KQVI chart: Move START/END outside subgraphs, add larger subgraph titles
Changes applied:
- 3e: START and END nodes now outside all subgraph groupings
- 3d: area_final renamed to area_1_final with <style> tag for larger font
- Fixed missing internal connections in maze_l2 and rod_styx subgraphs
2026-03-19 21:23:08 -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
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
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
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
4d7b22f3ff QA analysis of KQVI puzzle dependencies + fixes
- Created QA report identifying 5+ invalid dependencies:
  1. Village Phase: S3-S6 shown as sequential but are parallel paths
  2. Five Gnomes: Pearl not gated by gnome solutions
  3. Phase 6/7 ordering: Shield from Minotaur Maze required BEFORE archer
  4. Minotaur internal: S23/S24 and S20/S21 are parallel, not sequential

- Fixed main chart:
  - Village: Show parallel paths converging (S3,S4,S5,S6 → P4)
  - Five Gnomes: Pearl (S12) now independent, gnomes gate north path
  - Phase 6/7: Restructured to show Must do Minotaur Maze FIRST to get Shield
  - Added Phase 6b for return visit with Shield
  - Renumbered all subsequent phases
  - Updated Key Dependency Chains text
2026-03-19 18:32:15 -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
743aaf088e Create cross-reference index mapping games to puzzle types
- Table 1: Games → Puzzle Types (28 games catalogued)
- Table 2: Puzzle Type → Games with examples (organized by taxonomy)
- Category summary showing representative games per category
2026-03-19 15:37:46 -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
e598a785b4 Fix symbol-code-translation.md: use proper headers, add Index section
- Convert inline bold headers to proper ## headers for Core Mechanic and When to Use
- Add Index table to match template
- Add Symbol Code Translation and other types to skill best practices
2026-03-19 14:00:46 -07:00
eafcca6636 Refactor: symbol-code-translation.md 2026-03-19 12:09:19 -07:00
f08ec1d06a Refactor: observation-replay.md 2026-03-19 12:08:08 -07:00
7ee7101c77 Refactor: metaphor-literal.md 2026-03-19 12:08:00 -07:00
9679c4f480 Refactor: surreal-logic-bridge.md 2026-03-19 12:07:11 -07:00
4de8f9b7ba Refactor: escalating-combat-progression.md 2026-03-19 12:07:10 -07:00
7688449cf0 Refactor: robot-programming.md 2026-03-19 12:07:01 -07:00
8ed0d134d4 Refactor: multi-faction-diplomacy.md 2026-03-19 12:06:53 -07:00
d0357a7c51 Refactor: distraction-environmental-manipulation.md 2026-03-19 12:06:03 -07:00
ede2b9bad3 Refactor: class-specific-ritual.md 2026-03-19 12:05:57 -07:00
3643db8a08 Refactor: comedy-based-persuasion.md 2026-03-19 12:05:56 -07:00
6a086ddc5c Refactor: timed-consequence.md 2026-03-19 12:05:40 -07:00
bce59604ec Refactor: truth-revelation.md 2026-03-19 12:04:27 -07:00
8eadc6324f Refactor: multi-character-coordination.md 2026-03-19 12:03:06 -07:00
fe5981962f Refactor: cross-realm-logistics.md 2026-03-19 12:02:57 -07:00
b27168ed80 Refactor: cross-temporal-causality.md 2026-03-19 12:02:51 -07:00
c9198296f5 Refactor: memo-chain.md 2026-03-19 11:56:37 -07:00
14e432c3b5 Refactor: environmental-storytelling.md 2026-03-19 11:55:55 -07:00
863ce2e1fe Refactor: information-brokerage.md 2026-03-19 11:55:21 -07:00
135a3fd9d7 Refactor: sequential-construction.md 2026-03-19 11:54:38 -07:00
44d7936513 Fix broken link: meta-construction → sequential-construction 2026-03-19 11:53:20 -07:00
d317fceb80 Refactor: multi-faceted-plan.md - condense from 1000+ lines to 89 lines with 3 examples 2026-03-19 11:20:03 -07:00
656fe9d049 Refactor: sensory-exploitation.md - condense from 860+ lines to 88 lines with 3 examples 2026-03-19 11:20:02 -07:00
2ca1a13351 Refactor: pattern-learning.md - condense from 825 lines to 75 lines with 3 examples 2026-03-19 11:20:01 -07:00
e9a23c8eb7 Complete: Final deletion of repair-chain-construction.md (SQ3 Escape Pod already merged into sequential-construction.md) 2026-03-18 23:06:54 -07:00
7de9c36d67 Complete: Final deletion of corporate-infiltration.md (SQ3 ScummSoft stealth example already in distraction-environmental-manipulation.md) 2026-03-18 23:06:50 -07:00
45ed1699dd Complete: Final deletion of meta-puzzle-construction.md (stub file after rename to sequential-construction) 2026-03-18 23:06:43 -07:00
e17c025076 Complete: SUMMARY.md hierarchical structure with overview entries as list items for mdbook compatibility 2026-03-18 23:02:56 -07:00
06fa4cf533 Complete: Restructured SUMMARY.md with hierarchical puzzle taxonomy under 6 parent categories 2026-03-18 23:02:20 -07:00
13c68af62f Complete: Updated cross-references in docs files and analysis checklists 2026-03-18 22:59:14 -07:00
74ddc46bb9 Complete: Updated cross-references in puzzle type files 2026-03-18 22:59:07 -07:00
eed5e8cf47 Complete: Bulk updated cross-references in all inspiration pages 2026-03-18 22:58:57 -07:00
a24fa983c9 Complete: Updated cross-references in spacequest-iii-the-pirates-of-pestulon.md 2026-03-18 22:58:38 -07:00
ae47737130 Complete: Updated SUMMARY.md references - removed deleted types, renamed distraction-physics 2026-03-18 22:58:02 -07:00
0552e49b14 Complete: Updated README.md cross-references for removed types 2026-03-18 22:57:40 -07:00
bccd834242 Complete: Renamed distraction-physics.md to distraction-environmental-manipulation.md per hierarchy proposal 2026-03-18 22:56:49 -07:00