Commit Graph

207 Commits

Author SHA1 Message Date
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
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
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
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
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
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
1922709700 Complete: Tier 3 puzzle type refactoring (all 15 files) 2026-03-19 12:09:45 -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
cd4cf0e49f Complete: Tier 2 puzzle type refactoring 2026-03-19 11:57:03 -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
83f452b99f Update: TODOS.md - mark Tier 1 refactoring complete 2026-03-19 11:20:08 -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
e232fa303a Add design best practices section to skill template
- Add 'How to Design Great Puzzles of This Type' section
- Per-type best practices table with universal principles
- Antithesis to the Quick Pitfalls section
2026-03-19 11:17:19 -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
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