Include playable disk image and sample screenshots

README.md

@@ -9,6 +9,12 @@ The application was generated with **ChatGPT Codex** using **GPT-6.1 Sol High**,
 following the project brief in [CHATGPT_PROMPT.md](CHATGPT_PROMPT.md). Development
 included builds and gameplay tests through VCC Plus’s public MCP interface.
 
+## Download
+
+Download the ready-to-run [CAPITAL.DSK](CAPITAL.DSK) included at the repository
+root. Mount a copy in VCC Plus with a **512 KB CoCo 3 / 6809 Disk BASIC** setup,
+then type **DOS**, or `LOADM"CAPITAL.BIN":EXEC`.
+
 ## Build and play
 
 1. In VCC Plus, choose **Develop → C Development → Open**, and select this folder.
@@ -69,8 +75,9 @@ The editable inputs are `data/states.tsv`, `data/map-seeds.json`,
 `assets/usa-source.svg`, `main.c`, `src/quiz.c`, `src/ui.c` and the root-level
 `quiz.h`, `ui.h` and `map_data.h` headers. Keeping project headers beside
 `main.c` also makes them available to VCC Plus's isolated build snapshots. Generated drawing
-and state C files are retained for toolchain-only builds. Build outputs are
-ignored. The public MCP JSON-RPC client in `tools/vcc_mcp.py` takes an exported
+and state C files are retained for toolchain-only builds. Generated build outputs
+are ignored; the root-level `CAPITAL.DSK` is the checked-in playable release.
+The public MCP JSON-RPC client in `tools/vcc_mcp.py` takes an exported
 private grant path; keep that grant outside Git. See [test evidence](docs/TESTING.md)
 for baseline emulator coverage, [feedback tests](docs/FEEDBACK_TESTING.md)
 for the sound and automatic-advance checks, and [credits](assets/CREDITS.md)
@@ -88,3 +95,19 @@ This builds the advertised Test configuration, plays two complete quizzes with
 ordinary physical keys, checks actual framebuffer text and state fill pixels,
 and retains the test disks. Evidence stays outside the checkout until tests
 finish so VCC Plus's watched source revision remains stable.
+
+## Sample screens
+
+Screenshots of Capital Quest running in VCC Plus.
+
+### Title and mode selection
+
+![Title screen with a U.S. map and choices for multiple-choice or typed answers](docs/images/title.png)
+
+### Multiple choice
+
+![Multiple-choice question asking for Ohio's capital, with Ohio highlighted on the map](docs/images/multiple-choice.png)
+
+### Results
+
+![Results screen showing 47 out of 50 correct answers and a score of 94 percent](docs/images/results.png)