charlesbalcony/vibe-code-games-companion

This repository is the companion project for a book called Vibe Code Video Games While You Poop, which teaches readers to direct AI coding agents through building a real, finished Godot game in short sessions. Rather than just explaining ideas, the repo gives you every checkpoint of the game as the book builds it, so you can compare your own AI-assisted progress against a known working version at each stage. The main feature is a folder of checkpoints, one for roughly each commit made while writing the book, and each one is a complete, runnable Godot project. You can download the repository as a zip, open any checkpoint folder, and either run it directly with a included launcher script or import it straight into the Godot editor. Every checkpoint's own readme explains what state the game is in at that point, what changed since the previous checkpoint, and the exact prompts that were used to get there, so readers can copy and paste them instead of retyping from the book. The checkpoints trace the game, called Flush Rush, from an empty project skeleton through movement, scoring, menus, a full art and sound pass, and a finished shipped version, including at least one checkpoint that is deliberately left broken so readers can practice finding the bug themselves. Beyond the checkpoints, the repo includes the actual generated game assets used in the book, such as AI-generated sprites, locally generated music and sound effects, and optional AI voice lines, along with the scripts used to generate each of them. It also provides a starter template with house rules for an AI coding agent, an example environment file, and launcher scripts meant to be copied into a new project, plus a collection of the book's reusable prompt patterns written out as fill-in templates. The code and project files in this repository are released under the MIT license, though the book's own text is not included here and is not covered by that license.