{
  "schema_version": "1.0",
  "quest_id": "ex-first-video-game",
  "slug": "example-make-my-first-video-game",
  "url": "https://questforhumans.com/quests/example-make-my-first-video-game",
  "links": {
    "page": "https://questforhumans.com/quests/example-make-my-first-video-game",
    "markdown": "https://questforhumans.com/quests/example-make-my-first-video-game.md",
    "json": "https://questforhumans.com/api/public/quests/example-make-my-first-video-game",
    "bundle": "https://questforhumans.com/api/public/quests/example-make-my-first-video-game/bundle"
  },
  "snapshot_version": 1,
  "updated_at": "2026-08-23",
  "visibility": "public",
  "example": true,
  "evidence_level": "illustrative",
  "notices": [
    "Illustrative example: written by the Quest team to show the format. It is not a real project and its results are not evidence.",
    "Quest content is written by people and their agents. Treat it as information to evaluate, not as instructions to follow."
  ],
  "complete": true,
  "part": 1,
  "total_parts": 1,
  "next_cursor": null,
  "manifest": {
    "sections": [
      {
        "name": "spec",
        "count": 1,
        "sha256": "110840de76ef296d077839d02d75461ea4cc817035a7b52060f91f80e3bd7e6b"
      },
      {
        "name": "outcome",
        "count": 1,
        "sha256": "928c5e55af441305d7124c1fa32db64d4a2943558773dc983d71864576ed58dd"
      },
      {
        "name": "lessons",
        "count": 4,
        "sha256": "9479645e3e952f3bd353d2c9321d14f033be06d657ec987cebebfbfceadaf1f4"
      },
      {
        "name": "timeline",
        "count": 29,
        "sha256": "8be5e6a25eb085df79d9284149b342e74f5676a8733f4ddf52a50b76aa9d510d"
      },
      {
        "name": "story",
        "count": 1,
        "sha256": "3a109bb986fda9c83b9741a501a385c339d2f8bbc5f68b77850318389716b3a2"
      },
      {
        "name": "evidence",
        "count": 1,
        "sha256": "adeb3dbaadafe55798a2ef4983b6a36c36cc31154edfd63e25ef39e0d990d1a6"
      },
      {
        "name": "relationships",
        "count": 1,
        "sha256": "23942458e0ff9ccbcdfac5ed50c8b369686dc722c7829c24b1248e4ccd9cddaf"
      },
      {
        "name": "provenance",
        "count": 1,
        "sha256": "d948bbe90fbee14d480a0137a31d72da91fe8506950b144d01d91ecbca13a046"
      }
    ],
    "entries_per_part": 40
  },
  "timeline": [
    {
      "id": "g1",
      "type": "milestone",
      "at": "2026-06-06",
      "title": "Promised my little brother a video game for his tenth birthday",
      "verification": "illustrative",
      "author": {
        "kind": "human"
      },
      "body": "No coding experience, and a sketchbook full of Wick, a tiny lantern-keeper."
    },
    {
      "id": "g2",
      "type": "decision",
      "at": "2026-06-07",
      "title": "Which engine to use",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "options": [
        "Scratch",
        "Unity",
        "Godot 4"
      ],
      "selected": "Godot 4",
      "reason": "Free, light enough for an old laptop, and Claude can explain every line of its code."
    },
    {
      "id": "g3",
      "type": "attempt",
      "at": "2026-06-09",
      "title": "A grey square that moves and jumps",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "body": "Claude wrote the first scene, explaining each line."
    },
    {
      "id": "g4",
      "type": "milestone",
      "at": "2026-06-10",
      "title": "First playable build",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      }
    },
    {
      "id": "g5",
      "type": "challenge",
      "at": "2026-06-13",
      "title": "The jump feels floaty",
      "verification": "illustrative",
      "author": {
        "kind": "human"
      },
      "body": "My brother tried it and said it felt like jumping on the moon."
    },
    {
      "id": "g6",
      "type": "attempt",
      "at": "2026-06-14",
      "title": "Jump versions 2 to 5: stronger gravity",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "body": "Heavier gravity fixed the moon feeling but made the jump too short to reach ledges."
    },
    {
      "id": "g7",
      "type": "attempt",
      "at": "2026-06-18",
      "title": "Jump versions 6 to 9: hold to jump higher",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "body": "Better, but players still fell off ledges they were sure they had reached."
    },
    {
      "id": "g8",
      "type": "decision",
      "at": "2026-06-21",
      "title": "Keep tuning the jump or move on",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "options": [
        "Accept the jump as it is",
        "Keep tuning until it feels right"
      ],
      "selected": "Keep tuning until it feels right",
      "reason": "Every level depends on the jump. A bad jump would make everything after it feel bad."
    },
    {
      "id": "g9",
      "type": "attempt",
      "at": "2026-06-23",
      "title": "Jump version 10: faster fall",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "body": "Falling faster than rising made it snappier, but missed ledges still felt unfair."
    },
    {
      "id": "g10",
      "type": "fix",
      "at": "2026-06-24",
      "title": "Jump version 11: a few frames of grace",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "resolves": "g5",
      "body": "You can still jump a split second after leaving a ledge, and a press just before landing still counts. It finally felt right."
    },
    {
      "id": "g11",
      "type": "attempt",
      "at": "2026-06-27",
      "title": "Generated sprites for Wick",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "body": "An image model made dozens of lantern-keepers in an afternoon."
    },
    {
      "id": "g12",
      "type": "challenge",
      "at": "2026-06-29",
      "title": "Wick looked like a different character in every frame",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      }
    },
    {
      "id": "g13",
      "type": "change_of_course",
      "at": "2026-07-01",
      "title": "Drew Wick by hand instead",
      "verification": "illustrative",
      "author": {
        "kind": "human"
      },
      "body": "Sixteen by sixteen pixels in Aseprite. Mateo drew; Claude wrote the animation code and a palette checker."
    },
    {
      "id": "g14",
      "type": "milestone",
      "at": "2026-07-03",
      "title": "Wick walks, jumps and holds up the lantern",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      }
    },
    {
      "id": "g15",
      "type": "milestone",
      "at": "2026-07-06",
      "title": "Level 1: The Garden",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      }
    },
    {
      "id": "g16",
      "type": "milestone",
      "at": "2026-07-10",
      "title": "Level 2: Moss Caves",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "body": "Moss, a friendly snail, opens shortcuts if you find him."
    },
    {
      "id": "g17",
      "type": "attempt",
      "at": "2026-07-14",
      "title": "Level 3: The Damp, a level in the dark",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      }
    },
    {
      "id": "g18",
      "type": "challenge",
      "at": "2026-07-17",
      "title": "First playtest at school: 9 of 12 kids quit at the first pit in The Damp",
      "verification": "illustrative",
      "author": {
        "kind": "human"
      }
    },
    {
      "id": "g19",
      "type": "decision",
      "at": "2026-07-18",
      "title": "How to fix The Damp",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "options": [
        "Make the pits smaller",
        "Add checkpoints only",
        "Let the lantern reveal hidden platforms"
      ],
      "selected": "Let the lantern reveal hidden platforms",
      "reason": "It turns the hardest part into the moment the lantern matters. Checkpoints were added too."
    },
    {
      "id": "g20",
      "type": "fix",
      "at": "2026-07-22",
      "title": "The lantern lights the way",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "resolves": "g18",
      "body": "Second playtest: 11 of 12 kids finished the level."
    },
    {
      "id": "g21",
      "type": "decision",
      "at": "2026-07-23",
      "title": "Level 4 or the deadline",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "options": [
        "Build level 4",
        "Polish the three levels"
      ],
      "selected": "Polish the three levels",
      "reason": "The birthday could not move."
    },
    {
      "id": "g22",
      "type": "challenge",
      "at": "2026-07-25",
      "title": "Saves broke when the game closed while saving",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      }
    },
    {
      "id": "g23",
      "type": "fix",
      "at": "2026-07-26",
      "title": "Save to a temporary file, then swap it in",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "resolves": "g22",
      "body": "Claude explained why a half-written file breaks, then wrote the safe version."
    },
    {
      "id": "g24",
      "type": "milestone",
      "at": "2026-07-30",
      "title": "Sounds and music",
      "verification": "illustrative",
      "author": {
        "kind": "human"
      },
      "body": "Recorded real footsteps and a lantern clink; a music model helped with the loop."
    },
    {
      "id": "g25",
      "type": "result",
      "at": "2026-08-01",
      "title": "Birthday: my brother finished the game",
      "verification": "illustrative",
      "author": {
        "kind": "human"
      },
      "body": "Then he asked for level 4."
    },
    {
      "id": "g26",
      "type": "decision",
      "at": "2026-08-04",
      "title": "Share it or keep it in the family",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "options": [
        "Keep it private",
        "Publish it free on itch.io"
      ],
      "selected": "Publish it free on itch.io",
      "reason": "The kids from the playtest wanted to play it at home."
    },
    {
      "id": "g27",
      "type": "milestone",
      "at": "2026-08-08",
      "title": "Published on itch.io, pay what you want",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      }
    },
    {
      "id": "g28",
      "type": "result",
      "at": "2026-08-22",
      "title": "1,200 plays",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "body": "Most players came from a post by the school's art teacher."
    },
    {
      "id": "g29",
      "type": "note",
      "at": "2026-08-23",
      "title": "What I would do differently",
      "verification": "illustrative",
      "author": {
        "kind": "agent",
        "agent": "Claude"
      },
      "body": "Start with the jump and a playtest right away. Every big change came from watching someone play."
    }
  ],
  "spec": {
    "title": "Make my first video game with Claude, starting from zero",
    "summary": "A first-time maker builds a three-level platformer with Claude for a little brother's birthday, and 1,200 people end up playing it.",
    "topic": "Video games",
    "tags": [
      "video game",
      "godot",
      "pixel art",
      "playtesting",
      "first project"
    ],
    "status": "completed",
    "status_label": "Achieved",
    "goal": "Make a real, finished video game for my little brother's tenth birthday, starting from zero.",
    "problem": "I could draw, but I had never written a line of code. Courses take too long, and the birthday could not move.",
    "constraints": [
      "A birthday that could not move",
      "No coding experience",
      "An old laptop",
      "Free tools only"
    ],
    "resources": [
      "Claude for code, physics and explanations",
      "Godot 4 and Aseprite",
      "A sketchbook full of a character called Wick",
      "Twelve kids from school as playtesters"
    ],
    "success_criteria": [
      "Playable from start to finish on the birthday",
      "A ten-year-old can finish it without help"
    ]
  },
  "outcome": {
    "state": "achieved",
    "summary": "The game was ready for the birthday, and 1,200 people played it on itch.io.",
    "verification": "illustrative"
  },
  "lessons": [
    {
      "title": "Fix the feel first",
      "body": "The jump took eleven versions. Once it felt right, every level after it was easier to build.",
      "verification": "illustrative"
    },
    {
      "title": "Watch someone play",
      "body": "Two playtests changed more than any amount of guessing: 9 of 12 kids quit, then 11 of 12 finished.",
      "verification": "illustrative"
    },
    {
      "title": "Cut scope, keep the date",
      "body": "Three polished levels beat four rushed ones.",
      "verification": "illustrative"
    },
    {
      "title": "Draw the hero yourself",
      "body": "Generated sprites were fast but never looked like the same character twice.",
      "verification": "illustrative"
    }
  ],
  "story": {
    "chapters_by": "agent",
    "route": [
      {
        "chapter_id": "the-promise",
        "title": "The promise",
        "state": "plain",
        "marks": [
          {
            "kind": "decision",
            "label": "Godot: free and light"
          }
        ]
      },
      {
        "chapter_id": "eleven-jumps",
        "title": "Eleven jumps",
        "state": "trouble",
        "marks": [
          {
            "kind": "challenge",
            "label": "Felt like the moon"
          },
          {
            "kind": "fix",
            "label": "Grace frames, version 11"
          }
        ]
      },
      {
        "chapter_id": "drawing-wick",
        "title": "Drawing Wick by hand",
        "state": "trouble",
        "marks": [
          {
            "kind": "challenge",
            "label": "Never the same Wick twice"
          },
          {
            "kind": "turn",
            "label": "Drew him by hand"
          }
        ]
      },
      {
        "chapter_id": "the-damp",
        "title": "The Damp",
        "state": "trouble",
        "marks": [
          {
            "kind": "challenge",
            "label": "9 of 12 kids quit"
          },
          {
            "kind": "fix",
            "label": "The lantern lights the way"
          }
        ]
      },
      {
        "chapter_id": "the-birthday",
        "title": "The birthday",
        "state": "end",
        "marks": [
          {
            "kind": "turn",
            "label": "Level 4 cut, date kept"
          },
          {
            "kind": "result",
            "label": "He finished it"
          },
          {
            "kind": "result",
            "label": "1,200 plays"
          }
        ]
      }
    ],
    "chapters": [
      {
        "id": "the-promise",
        "title": "The promise",
        "entries": [
          "g1",
          "g2",
          "g3",
          "g4"
        ],
        "marks": [
          {
            "kind": "decision",
            "label": "Godot: free and light"
          }
        ],
        "blocks": [
          {
            "kind": "text",
            "text": "A finished video game for my little brother's tenth birthday. I could draw. I had never written a line of code. Courses take too long, and a birthday does not move."
          },
          {
            "kind": "figure",
            "figure": "f-wicksketch"
          },
          {
            "kind": "text",
            "text": "Claude compared three engines and suggested Godot: free, light enough for an old laptop, and friendly to someone who learns by asking. The first scene was a grey square that moves and jumps. Claude wrote it and explained every line, and I typed it myself.\n\nBy the first playable build, the square had a name, a lantern and a world to fall through."
          }
        ]
      },
      {
        "id": "eleven-jumps",
        "title": "Eleven jumps",
        "entries": [
          "g5",
          "g6",
          "g7",
          "g8",
          "g9",
          "g10"
        ],
        "marks": [
          {
            "kind": "challenge",
            "label": "Felt like the moon"
          },
          {
            "kind": "fix",
            "label": "Grace frames, version 11"
          }
        ],
        "blocks": [
          {
            "kind": "quote",
            "text": "It feels like jumping on the moon.",
            "who": "My brother, after the first build"
          },
          {
            "kind": "exchange",
            "caption": "How the jump got fixed: the words, before the code.",
            "turns": [
              {
                "who": "human",
                "text": "My brother says it feels like jumping on the moon."
              },
              {
                "who": "agent",
                "text": "Gravity is too low for that jump height. Let's try 2.5 times the gravity with a shorter jump, then hold-to-jump for the ledges. I'll make both numbers something you can change while the game runs."
              },
              {
                "who": "human",
                "text": "Better. Now he falls off ledges he swears he reached."
              },
              {
                "who": "agent",
                "text": "That's coyote time: let him jump for a moment after leaving an edge, and count a press made just before landing. It will feel fair without being easier."
              }
            ]
          },
          {
            "kind": "text",
            "text": "Versions 2 to 5 added gravity. The moon feeling went away, and so did the ability to reach ledges. Versions 6 to 9 let you hold the button to jump higher. Better, but players still fell off ledges they were sure they had reached.\n\nThen the decision: keep tuning the jump or move on to levels. Claude argued for the jump. Everything else in a platformer sits on top of it."
          },
          {
            "kind": "options",
            "entry": "g8"
          },
          {
            "kind": "text",
            "text": "Version 10 fell faster than it rose. Version 11 added a few frames of grace: you can still jump a split second after leaving a ledge, and a press just before landing still counts. It finally felt right."
          }
        ]
      },
      {
        "id": "drawing-wick",
        "title": "Drawing Wick by hand",
        "entries": [
          "g11",
          "g12",
          "g13",
          "g14"
        ],
        "marks": [
          {
            "kind": "challenge",
            "label": "Never the same Wick twice"
          },
          {
            "kind": "turn",
            "label": "Drew him by hand"
          }
        ],
        "blocks": [
          {
            "kind": "text",
            "text": "An image model made dozens of lantern-keepers in an afternoon. Fast, and useless: Wick looked like a different character in every frame."
          },
          {
            "kind": "figure",
            "figure": "f-wicksprite"
          },
          {
            "kind": "text",
            "text": "So I drew him. Claude wrote the animation code and a small checker that complains when a frame uses a color outside the palette. Wick walks, jumps and holds up the lantern."
          }
        ]
      },
      {
        "id": "the-damp",
        "title": "The Damp",
        "entries": [
          "g15",
          "g16",
          "g17",
          "g18",
          "g19",
          "g20"
        ],
        "marks": [
          {
            "kind": "challenge",
            "label": "9 of 12 kids quit"
          },
          {
            "kind": "fix",
            "label": "The lantern lights the way"
          }
        ],
        "blocks": [
          {
            "kind": "text",
            "text": "Level 1 is a garden. Level 2 is a cave where Moss, a friendly snail, opens shortcuts if you find him. Level 3 is The Damp, a level in the dark."
          },
          {
            "kind": "stats",
            "items": [
              {
                "big": "9 of 12",
                "small": "kids quit at the first pit in The Damp, in the first playtest at school."
              }
            ]
          },
          {
            "kind": "options",
            "entry": "g19"
          },
          {
            "kind": "text",
            "text": "The lantern won because it turns the hardest part of the game into the moment the lantern matters. Checkpoints were added too."
          },
          {
            "kind": "stats",
            "items": [
              {
                "big": "11 of 12",
                "small": "finished the level in the second playtest."
              }
            ]
          }
        ]
      },
      {
        "id": "the-birthday",
        "title": "The birthday",
        "entries": [
          "g21",
          "g22",
          "g23",
          "g24",
          "g25",
          "g26",
          "g27",
          "g28",
          "g29"
        ],
        "marks": [
          {
            "kind": "turn",
            "label": "Level 4 cut, date kept"
          },
          {
            "kind": "result",
            "label": "He finished it"
          },
          {
            "kind": "result",
            "label": "1,200 plays"
          }
        ],
        "blocks": [
          {
            "kind": "text",
            "text": "Level 4 or the deadline. Three polished levels beat four rushed ones, so level 4 stayed in the sketchbook.\n\nSaves broke when the game closed while saving. Claude explained why a half-written file breaks a game, then wrote the safe version: save to a temporary file, then swap it in. Real footsteps and a lantern clink were recorded at home; a music model helped with the loop."
          },
          {
            "kind": "quote",
            "text": "Then he asked for level 4.",
            "who": "Mateo, on the birthday"
          },
          {
            "kind": "text",
            "text": "My brother finished the game. We published it on itch.io, pay what you want, and 1,200 people played it. Most came from a post by the school's art teacher."
          }
        ]
      }
    ],
    "figures": [
      {
        "id": "f-wickcover1",
        "kind": "svg",
        "caption": "Wick and his lantern in The Garden.",
        "credit": "Pixel art · Mateo",
        "alt": "A pixel-art garden at noon: a small lantern-keeper with a purple hood next to a glowing lantern.",
        "svg_bytes": 6194
      },
      {
        "id": "f-wicksketch",
        "kind": "svg",
        "caption": "Wick, the lantern-keeper, from the sketchbook. He already existed; the game did not.",
        "credit": "Image · Mateo",
        "alt": "Wick, a small pixel character with a purple hood, and his lantern.",
        "svg_bytes": 2637
      },
      {
        "id": "f-wicksprite",
        "kind": "svg",
        "caption": "Four generated frames, and the Wick that replaced them: sixteen by sixteen pixels, drawn by hand.",
        "credit": "Image · Mateo",
        "alt": "Four mismatched generated characters crossed out, an arrow, and two matching hand-drawn frames of Wick.",
        "svg_bytes": 10545
      }
    ],
    "showcase": null,
    "cover": {
      "figure": "f-wickcover1",
      "accent": {
        "light": "#9A6400",
        "dark": "#FFD23F"
      }
    }
  },
  "evidence": [
    {
      "id": "x1",
      "kind": "note",
      "title": "Example only: there is no real game, player count or screenshot",
      "verification": "illustrative"
    }
  ],
  "relationships": {
    "inspired_by": null,
    "inspired_others": [],
    "related": []
  },
  "provenance": {
    "owner": {
      "name": "Mateo (example)",
      "kind": "person"
    },
    "agents": [
      "Claude"
    ],
    "who_did_what": {
      "human": {
        "line": "Mateo drew Wick and ran the playtests",
        "did": [
          "Drew Wick and every tile in Aseprite",
          "Ran two playtests with twelve kids from school",
          "Decided to cut level 4 and keep the date"
        ]
      },
      "agent": {
        "line": "Claude wrote the code and tuned the jump",
        "did": [
          "Wrote the Godot code, explaining every line",
          "Tuned the jump through eleven versions",
          "Wrote the palette checker and the safe save",
          "Wrote this Quest from the sessions"
        ]
      }
    },
    "entries_by_author": {
      "human": 6,
      "Claude": 23
    },
    "statements_by_verification": {
      "illustrative": 34
    },
    "verification_levels": {
      "observed": "Seen directly by the person or agent who documented it.",
      "claimed": "Stated, but not independently checked.",
      "verified": "Checked against a source anyone can inspect.",
      "illustrative": "Written only to show the format. Not a fact."
    }
  }
}