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.

src/resources/community/README.md

@@ -0,0 +1,26 @@
+# Community
+
+Community discussions, analysis series, and collaborative resources from the adventure game design community.
+
+## Articles
+
+| File | Title | Source | Summary |
+|------|-------|--------|---------|
+| `puzzle-design-adventure-games-stackexchange.md` | Puzzle Design in Adventure Games | Stack Exchange | Developer Q&A on puzzle design techniques, classification systems, and whether to design story or puzzles first. |
+| `unpoint-unclick-adventure-game-analysis.md` | Unpoint/Unclick | Christopher Sacchi | Ongoing analysis series deconstructing point-and-click adventure games using puzzle dependency charts (as described by Ron Gilbert). |
+
+## Key Themes
+
+- **Puzzle dependency analysis** - Systematic breakdown of puzzle relationships in existing games
+- **Community knowledge sharing** - How developers learn from each other through analysis
+- **Practical methodology** - Hands-on techniques for learning and improving adventure game design
+- **Game analysis** - Deconstruction methodology for understanding what makes adventure games work
+
+## Related Resources
+
+- **Ron Gilbert on Puzzle Dependency Charts**: See `lucasarts-puzzle-dependency-charts.md` in the Puzzle Design section for the foundational technique used in analysis.
+- **Game Developer Stack Exchange**: [puzzling.stackexchange.com](https://puzzling.stackexchange.com) for general puzzle design discussion.
+
+## Usage
+
+These articles represent the community's own efforts to systematize adventure game design knowledge, showing how practitioners analyze and learn from existing games.

src/resources/criticism/README.md

@@ -0,0 +1,25 @@
+# Criticism & Self-Improvement
+
+Articles critiquing adventure games and providing design guidance for making better games.
+
+## Articles
+
+| File | Title | Source | Summary |
+|------|-------|--------|---------|
+| `10-things-hate-adventure-games.md` | 10 Things I Hate About Adventure Games | Hande's Blog (Hannu Mäkinen) | A developer's personal critique listing common adventure game design frustrations that frustrate both players and designers. |
+| `14-deadly-sins-graphic-adventure-design-filfre.md` | The 14 Deadly Sins of Graphic-Adventure Design | FilFre (Jimmy Maher) | Historical catalog of common adventure game design failures, using Space Quest and Uninvited as primary examples of what not to do. |
+| `seven-deadly-sins-adventure-games.md` | Seven Deadly Sins of Adventure Games | Game Developer (Adrian Chmielarz) | Modern analysis of how core adventure game mechanics contributed to genre death, examining issues from cinematic wannabes to undisciplined writing. |
+| `why-adventure-games-suck-ron-gilbert.md` | Why Adventure Games Suck | Grumpy Gamer (Ron Gilbert) | Ron Gilbert's original 1989 manifesto on adventure game design failures—the most influential critique ever written on the subject. |
+| `flaws-undead-genre-point-click-adventures.md` | Flaws of an Undead Genre | Game Developer | Modern Twitter-sourced critique examining why point-and-click adventures remain difficult to market and what players still dislike about the genre. |
+
+## Key Themes
+
+- **Dead ends and unwinnable states** - Games that lock players out without warning
+- **Moon logic puzzles** - Solutions that require impossible-to-guess combinations
+- **Pixel hunting** - Hidden items that reward exhaustive clicking rather than logic
+- **Poor feedback** - Lack of clear goals and progression signals
+- **Missing playtesting** - Designs that work for creators but not players
+
+## Usage
+
+These articles form the foundation of anti-patterns that the Puzzle Design Handbook documents. Each "sin" represents a failure mode designers should avoid.

src/resources/defense/README.md

@@ -0,0 +1,22 @@
+# Defense & Praise
+
+Articles defending adventure games and articulating what makes the genre worthwhile.
+
+## Articles
+
+| File | Title | Source | Summary |
+|------|-------|--------|---------|
+| `why-adventure-games-rock-tickstales.md` | Why Adventure Games Rock | Tick's Tales (Bryce Covert) | A developer's research series examining what makes adventure games work—using King's Quest V as a case study for exploration-based progression. |
+| `what-makes-great-point-click-adventure.md` | What Makes a Great Point-and-Click Adventure | Moon Logical Blog | Personal criteria for great adventure games covering story, characters, puzzles, logic, interface, writing, art, voice acting, and sound design. |
+
+## Key Themes
+
+- **Exploration as reward** - Progress through discovery, not just puzzle-solving
+- **Story-mechanic integration** - Puzzles that feel organic to the narrative
+- **Logical consistency** - Internal rules that players can learn and rely upon
+- **Character-driven design** - Memorable characters that enhance the experience
+- **Atmospheric art direction** - Visual styles that establish mood and immersion
+
+## Usage
+
+These articles provide affirmative design principles that contrast with the Criticism section. They represent what designers should pursue, not just what to avoid.

src/resources/history/README.md

@@ -0,0 +1,26 @@
+# History & Analysis
+
+Articles examining the adventure game genre's evolution, decline, and the factors that shaped its history.
+
+## Articles
+
+| File | Title | Source | Summary |
+|------|-------|--------|---------|
+| `fall-point-click-adventure-game.md` | The Fall of the Point-and-Click Adventure Game | Game Developer | Analysis of how internet walkthroughs fundamentally changed point-and-click viability and the challenge of designing puzzles that don't require external assistance. |
+| `who-really-killed-adventure-games.md` | Who Really Killed Adventure Games? | Slatt Studio | Argument that hardware progress enabled other genres to offer "exploration experiences" that adventure games couldn't replicate without fundamental mechanic changes. |
+| `death-of-adventure-games-part-1.md` | Death and Rebirth of Adventure Games Part 1 | Genesis Temple | First in a series examining the FMV era, 3D revolution, and how LucasArts and Sierra's decline led to genre collapse. |
+| `death-rebirth-adventure-games-part-3.md` | Death and Rebirth Part 3 | Genesis Temple | Analysis of the Kickstarter era and Double Fine's 2012 campaign as a turning point for reviving classic 2D adventure gaming. |
+| `without-readability-decline-adventure-games.md` | Without Readability | Game Developer | Argument that adventure games' combinatorial action space (768 possible actions) created poor "readability" where players couldn't understand game dynamics. |
+| `thimbleweed-park-ron-gilbert-rockpapershotgun.md` | Thimbleweed Park Preview | Rock Paper Shotgun | Ron Gilbert interview on making adventure games that don't suck, discussing his return to the genre with Thimbleweed Park. |
+
+## Key Themes
+
+- **Genre death causes** - FMV era, 3D revolution, market forces
+- **Exploration experience** - What made adventure games unique and irreplaceable
+- **Hardware constraints** - How technical limitations shaped genre possibilities
+- **Kickstarter revival** - Community-driven resurrection of classic adventure gaming
+- **Design lessons learned** - How modern developers apply historical knowledge
+
+## Usage
+
+These articles provide historical context for understanding why certain design patterns became dominant and how the genre's低谷 shaped modern adventure game design philosophy.

src/resources/index.md

@@ -2,40 +2,35 @@
 
 A collection of reference articles on adventure game puzzle design, collected for the Puzzle Design Handbook project.
 
-## Articles Index
+## Category Index
 
-| # | Title | Source | Description |
-|---|-------|--------|-------------|
-| 1 | Why Adventure Games Suck | GrumpyGamer (Ron Gilbert) | Ron Gilbert's original manifesto on why adventure games fail |
-| 2 | Why Adventure Games Rock | TicksTales | Counterpoint article defending adventure games |
-| 3 | Thimbleweed Park Preview | Rock Paper Shotgun | Ron Gilbert interview on making adventure games that don't suck |
-| 4 | 14 Deadly Sins of Graphic Adventure Design | FilFre (Jim Chambers) | Catalog of common adventure game design failures |
-| 5 | Monkey Island Analysis | FilFre (Jim Chambers) | How Ron Gilbert made an adventure game that didn't suck |
-| 6 | Flaws of an Undead Genre | Game Developer | What's wrong with point-and-click adventures |
-| 7 | Seven Deadly Sins of Adventure Games | Game Developer | Seven design sins specific to adventure games |
-| 8 | Without Readability | Game Developer | Analysis of adventure games' decline related to UI |
-| 9 | The Fall of the Point-and-Click Adventure Game | Game Developer | Historical analysis of the genre's fall |
-| 10 | Monkey Island 2 Puzzle Design | Game Developer | Analyzing puzzle dependencies and balancing |
-| 11 | LucasArts Puzzle Dependency Charts | Game Developer | The technique LucasArts used for classic adventure puzzles |
-| 12 | SCUMM Design Documents | Game Developer | SCUMM co-creator digs up game design treasure |
-| 13 | The SCUMM Diary | Game Developer | Stories behind one of the greatest game engines |
-| 14 | Puzzle Game Design Principles | Game Developer | Puzzle game design principles and levels template |
-| 15 | Adventure Puzzle Design | Stanislav Costiuc | Design patterns for adventure game puzzles |
-| 16 | Renpy Point & Click Tutorial: Puzzle Design | West of Entropy | Renpy tutorial covering puzzle design basics |
-| 17 | Unpoint/Unclick | Christopher Sacchi | Adventure game design analysis |
-| 18 | Puzzle Design in Adventure Games | Stack Exchange | Community Q&A on adventure game puzzle design |
-| 19 | Adventure Game Puzzles: Unlocking Secrets | Adventure Classic Gaming | Analysis of puzzle mechanics and secrets |
-| 20 | Who Really Killed Adventure Games? | Slatt Studio | Investigation into the genre's decline |
-| 21 | Death of Adventure Games Part 1 | Genesis Temple | First part of adventure games death analysis |
-| 22 | Death and Rebirth of Adventure Games Part 3 | Genesis Temple | Third part examining false hopes and promises |
-| 23 | Moon Logic and Divergent Thinking | Simply Put Psych | Psychological perspective on moon logic puzzles |
-| 24 | What Makes a Great Point-and-Click Adventure | Moon Logical Blog | Analysis of what makes great adventure games |
-| 25 | PC Gamer on Moon Logic | PC Gamer | Article on why we tolerate moon logic puzzles |
-| 26 | Moon Logic Puzzle | TV Tropes | TV Tropes catalog of moon logic puzzle examples |
-| 27 | Moon Logic Adventure Games | TV Tropes | TV Tropes specifically on adventure game moon logic |
-| 28 | Moon Logic Reddit Discussion | Reddit r/gamedesign | Community discussion on what constitutes moon logic |
-| 29 | 10 Things I Hate About Adventure Games | The Hande | Developer perspective on adventure game frustrations |
-| 30 | SCUMM Interview (IGN) | IGN | Classic Ron Gilbert SCUMM interview |
+| Category | Description | Count |
+|----------|-------------|-------|
+| [Criticism & Self-Improvement](./criticism/) | Articles critiquing adventure games and providing design guidance | 5 |
+| [Defense & Praise](./defense/) | Articles defending adventure games and articulating what makes the genre work | 2 |
+| [Puzzle Design](./puzzle-design/) | Technical articles on puzzle mechanics, design patterns, and construction | 7 |
+| [Technical & Engineering](./technical/) | SCUMM, LucasArts development practices, and engineering history | 4 |
+| [History & Analysis](./history/) | Historical analyses of the adventure game genre's evolution and decline | 6 |
+| [Moon Logic](./moon-logic/) | The specific phenomenon of moon logic puzzles and player psychology | 5 |
+| [Community](./community/) | Community discussions and collaborative analysis resources | 2 |
+
+## Quick Reference by Topic
+
+**Foundational Design Rules:**
+- [Why Adventure Games Suck](./criticism/why-adventure-games-suck-ron-gilbert.md) — Ron Gilbert's original 1989 manifesto
+- [14 Deadly Sins](./criticism/14-deadly-sins-graphic-adventure-design-filfre.md) — Catalog of common failures
+
+**Puzzle Design Methodology:**
+- [LucasArts Puzzle Dependency Charts](./puzzle-design/lucasarts-puzzle-dependency-charts.md) — Core technique for mapping puzzle relationships
+- [Monkey Island 2 Analysis](./puzzle-design/monkey-island-2-puzzle-design.md) — Practical application of dependency charts
+
+**Moon Logic Understanding:**
+- [Moon Logic Overview](./moon-logic/moon-logic-puzzle-tvtropes.md) — Definition and examples
+- [Psychological Perspective](./moon-logic/moon-logic-divergent-thinking.md) — Why players attempt unusual solutions
+
+**Historical Context:**
+- [Death & Rebirth Series](./history/death-of-adventure-games-part-1.md) — Three-part genre history
+- [Who Really Killed Adventure Games](./history/who-really-killed-adventure-games.md) — Alternative perspective on genre decline
 
 ## Failed Downloads
 
@@ -50,3 +45,15 @@ The following articles could not be downloaded due to access restrictions:
 ## Usage
 
 These articles provide supplementary reference material for the Puzzle Design Handbook. They are referenced in the Inspiration section where relevant puzzle analyses connect to specific design patterns documented in the Playbook.
+
+## Organization
+
+Articles are organized into seven categories reflecting different aspects of adventure game design:
+
+1. **Criticism** documents what NOT to do—anti-patterns and failure modes
+2. **Defense** articulates what makes adventure games worth playing
+3. **Puzzle Design** provides technical methodology for constructing puzzles
+4. **Technical** covers the engineering infrastructure of classic adventure games
+5. **History** provides context for how the genre evolved and why it declined
+6. **Moon Logic** specifically examines one of the genre's most notorious characteristics
+7. **Community** shows how practitioners analyze and share design knowledge

src/resources/moon-logic/README.md

@@ -0,0 +1,25 @@
+# Moon Logic
+
+Articles examining the specific phenomenon of "moon logic" puzzles—solutions that seem logical only in the game's unrealistic world rather than real-world reasoning.
+
+## Articles
+
+| File | Title | Source | Summary |
+|------|-------|--------|---------|
+| `moon-logic-adventure-games-tvtropes.md` | Moon Logic Puzzle: Adventure Games | TV Tropes | Catalog of infamous moon logic puzzle examples specifically in adventure games, with annotated problem cases. |
+| `moon-logic-divergent-thinking.md` | Moon Logic and Divergent Thinking | Simply Put Psych | Psychological perspective analyzing whether moon logic puzzles require "divergent thinking" or represent design failures. |
+| `moon-logic-puzzle-tvtropes.md` | Moon Logic Puzzle | TV Tropes | General TV Tropes entry defining moon logic as puzzles whose solutions make sense only within the game's alternate logic. |
+| `moon-logic-reddit-discussion.md` | Moon Logic Reddit Discussion | Reddit r/gamedesign | Community discussion on where the threshold for "real" moon logic lies and whether beyond-basic puzzles inevitably become moon logic. |
+| `pcgamer-moon-logic-classic-adventure.md` | PC Gamer on Moon Logic | PC Gamer | Article examining why players tolerated moon logic puzzles in classic adventures and whether modern design has lost something. |
+
+## Key Themes
+
+- **Definition problem** - What actually constitutes moon logic vs. legitimate challenge?
+- **Psychological appeal** - Why some players enjoy moon logic despite frustration
+- **Design failure vs. feature** - Whether moon logic represents poor design or genre character
+- **Historical tolerance** - How context (no internet, different expectations) affected acceptance
+- **Modern alternatives** - How modern adventure games avoid or embrace moon logic
+
+## Usage
+
+These articles help define and contextualize one of adventure gaming's most notorious characteristics, providing nuance for the Puzzle Design Handbook's treatment of puzzle difficulty and logical consistency.

src/resources/puzzle-design/README.md

@@ -0,0 +1,27 @@
+# Puzzle Design
+
+Articles specifically focused on adventure game puzzle mechanics, design patterns, and construction techniques.
+
+## Articles
+
+| File | Title | Source | Summary |
+|------|-------|--------|---------|
+| `adventure-game-puzzles-unlocking-secrets.md` | Adventure Game Puzzles: Unlocking Secrets | Adventure Classic Gaming | Classification of puzzle types (interaction, mini-game, riddle, inventory, pattern, implicit information) with analysis of how they relate to gameplay. |
+| `adventure-puzzle-design-stanislav-costiuc.md` | Adventure Puzzle Design | Stanislav Costiuc | Design patterns for creating logical puzzles without non-sensical solutions, covering internal logic, the inception principle, and puzzle-story integration. |
+| `lucasarts-puzzle-dependency-charts.md` | LucasArts Puzzle Dependency Charts | Game Developer (Noah Falstein) | The technique Ron Gilbert developed for breaking adventure games into flowcharts of objectives and solutions—making puzzles "bushy" and avoiding linearity. |
+| `monkey-island-2-puzzle-design.md` | Monkey Island 2 Puzzle Design | Marcus | Detailed analysis of Monkey Island 2's puzzle dependencies showing how four parallel puzzle chains balance item count, characters, and room visits. |
+| `puzzle-design-adventure-games-stackexchange.md` | Puzzle Design in Adventure Games | Stack Exchange | Community Q&A gathering techniques including puzzle classifications, TRIZ creative problem-solving, and designing situations rather than puzzles. |
+| `puzzle-game-design-principles-template.md` | Puzzle Game Design Principles | Game Developer | General puzzle design principles covering clear objectives, logical consistency, progressive difficulty, fair feedback, and multiple solution paths. |
+| `renpy-point-click-tutorial-puzzle-design.md` | Renpy Point & Click Tutorial: Puzzle Design | West of Entropy | Practical tutorial examining fairness, possibility space, creativity, and comprehensibility in puzzle design with historical context. |
+
+## Key Themes
+
+- **Puzzle dependency charts** - Visual tools for mapping puzzle relationships and parallelism
+- **Fairness through clarity** - Making sure players understand goals and can reason toward solutions
+- **Puzzle classification** - Understanding different puzzle types and when to use each
+- **Balancing difficulty** - Parallel puzzle chains that provide choice without frustration
+- **Internal logic** - Establishing consistent rules players can rely upon
+
+## Usage
+
+These articles provide the core technical knowledge for the Puzzle Design Handbook's Playbook section, documenting specific puzzle patterns and design methodologies.

src/resources/technical/README.md

@@ -0,0 +1,24 @@
+# Technical & Engineering
+
+Articles about the technical infrastructure that enabled classic adventure games, particularly SCUMM and LucasArts development practices.
+
+## Articles
+
+| File | Title | Source | Summary |
+|------|-------|--------|---------|
+| `scumm-design-documents-game-developer.md` | SCUMM Design Documents | Game Developer | SCUMM co-creator Aric Wilmunder's treasure trove of historical design documents from LucasArts classics including Monkey Island and Day of the Tentacle. |
+| `scumm-diary-game-developer.md` | The SCUMM Diary | Game Developer | Stories behind SCUMM's development including multi-tasking architecture, tokenized command system, and how it enabled rapid game prototyping. |
+| `scumm-interview-ron-gilbert-ign.md` | SCUMM Interview | IGN | Classic interview with Ron Gilbert on how SCUMM was created and the technical decisions that shaped adventure game development. |
+| `monkey-island-ron-gilbert-filfre.md` | Monkey Island (How Ron Gilbert Made an Adventure Game That Didn't Suck) | FilFre (Jimmy Maher) | Historical analysis of The Secret of Monkey Island's development, including Gilbert's "Why Adventure Games Suck" manifesto and its implementation. |
+
+## Key Themes
+
+- **SCUMM architecture** - The "Script Creation Utility for Maniac Mansion" and its revolutionary design
+- **Tokenized commands** - Efficient encoding of player actions into compact data
+- **Multi-tasking scripts** - Concurrent script execution enabling complex world behaviors
+- **Rapid prototyping** - How SCUMM allowed quick iteration on game ideas
+- **Cross-platform portability** - Interpreted language advantages for multi-machine support
+
+## Usage
+
+These articles provide historical context for how classic adventure games were technically constructed, relevant to understanding why certain design patterns emerged and how modern developers might apply similar techniques.

todos/TODOS.md

@@ -1,18 +1,48 @@
-# TODO List for Adventure Game Design Articles Download
+# TODO List for Adventure Game Design Articles Organization
 
-## Task: Download and save 35 adventure game design articles
+## Task: Organize resources into logical category structure
 
-- [x] Batch 1: Articles 1-12 (GrumpyGamer, TicksTales, RockPaperShotgun, VentureBeat, FilFre articles) - 11/12 saved
-- [x] Batch 2: Articles 13-23 (GameDeveloper articles, StanislavCostiuc, JoseRafaelPerez, WestOfEntropy, ChristopherSacchi, StackExchange, AdventureClassicGaming, SlattStudio, GenesisTemple) - 10/11 saved
-- [x] Batch 3: Articles 24-35 (GenesisTemple continued, BrainBaking, SimplyPutPsych, MoonLogicalBlog, PCGamer, TVTropes, Reddit, TheHande, Vogons, IGN, Medium) - 8/12 saved
-- [x] Retry failed articles - 1/6 additional saved
-- [x] Create index.md file listing all resources with brief descriptions
+- [x] Read all articles to understand content
+- [x] Analyze and categorize articles into logical groups
+- [x] Create category subdirectories with README files
+- [x] Write 1-2 sentence summaries for each article
+- [x] Move files to appropriate subdirectories
+- [x] Create reorganized index.md with category structure
+- [x] Commit changes
 
-## Final Results: 30 articles saved, 5 failed (rate limits/403/404)
+## Article Categories Created
 
-## Failed URLs (blocked):
-- VentureBeat (rate limited)
-- joserafaelperez.com (404)
-- brainbaking.com (connection closed)
-- vogons.org (403)
-- Medium (403)
+### 1. Criticism & Self-Improvement (5 articles)
+Articles critiquing adventure games and suggesting design improvements
+
+### 2. Defense & Praise (2 articles)  
+Articles defending and praising adventure games
+
+### 3. Puzzle Design (7 articles)
+Articles specifically about puzzle mechanics and design
+
+### 4. Technical/Engineering (4 articles)
+SCUMM, LucasArts techniques, engineering aspects
+
+### 5. History & Analysis (6 articles)
+Historical analyses of the adventure game genre
+
+### 6. Moon Logic (5 articles)
+Specific topic - moon logic puzzles and psychology
+
+### 7. Community (2 articles)
+Community discussions, Reddit, StackExchange
+
+## Summary
+
+Organized 31 articles into 7 category subdirectories:
+- criticism/ (5 articles)
+- defense/ (2 articles)
+- puzzle-design/ (7 articles)
+- technical/ (4 articles)
+- history/ (6 articles)
+- moon-logic/ (5 articles)
+- community/ (2 articles)
+
+Each category has a README.md with summaries and key themes.
+Main index.md updated to link to all categories.