Inspiration Page Creation — Quick Reference Card

5-Step Autonomous Workflow

1. Read todos/TODOS.md → Find first unchecked game task
2. Read walkthroughs in src/walkthroughs/<game>/ → Extract puzzle data + quotes
3. Create src/inspiration/<game>.md → Use template.md structure
4. Verify pattern links work → ls src/puzzles/*.md
5. Update SUMMARY.md + TODOS.md → git commit

Puzzle Selection Criteria (Top 3 Only)

Priority Order:

Mechanical clarity — Pattern type identifiable, solution reproducible
"Aha moment" presence — Walkthrough mentions discovery/satisfaction
Pattern diversity — Don't pick 3 identical pattern types

Additional puzzles go in "Other Puzzles" table (6-10 entries)

Required Quotes (Minimum)

Section	Quote Requirement	Format
At a Glance	2+ player enjoyment quotes	Inline: `"quote" [Key]`
Each of 3 puzzles	1+ walkthrough author quote	Blockquote or inline with attribution
Other Puzzles (optional)	Memorable moments only	Inline where relevant

Screenshot Alt Text Format

Must describe what to capture, not generic "gameplay":

✅ ![Gravestone showing riddle and tree symbol that matches mountaintop tree](./loom-puzzle1.png)
❌ ![Game screenshot](./loom-puzzle1.png)

Pattern Type Link Verification

Common corrections:

metaphor-to-literal.md → metaphor-literal.md ❌→✅
Always use ../puzzles/ relative path from inspiration folder
Verify file exists: ls src/puzzles/ | grep <keyword>

Citation Format Rules

Keys: PascalCase, no spaces, 3 words max

[THayes] → Tom Hayes, GameFAQs Walkthrough (2008). URL
[GameCat] → Game Cat, The Spoiler Centre Solution. URL

Word Count Target

Total: ~1,000 words
Acceptable range: 800-1,200 words
If over 1,300 words → trim "What Makes It Rewarding" sections first

Pre-Commit Checklist (Copy-Paste)

[ ] File path: src/inspiration/<kebab-name>.md ✓
[ ] Exactly 3 featured puzzles with Problem/Rewarding/Solution/Steps ✓
[ ] One screenshot placeholder per puzzle with descriptive alt text ✓
[ ] Direct quote in each "What Makes It Rewarding" section ✓
[ ] Two+ quotes in At a Glance table ✓
[ ] Other Puzzles table has 6-10 entries ✓
[ ] References section has full URLs ✓
[ ] All pattern links verified against src/puzzles/*.md ✓
[ ] Citation keys consistent throughout ✓
[ ] Word count near 1,000 ✓
[ ] SUMMARY.md updated ✓
[ ] TODOS.md marked complete ✓

Commit Message Template

Complete: <Game Name> inspiration page with 3 featured puzzles and pattern type links

Files to stage:

src/inspiration/<game>.md
todos/TODOS.md
src/SUMMARY.md

mdbook Build Check

After creating page, verify no link errors:

mdbook build 2>&1 | grep -i "<game-name>"

No output = all links valid ✓

2.9 KiB Raw Blame History