Lucas WintherandClaude Opus 5.5 6f576940b7 fix: module 10 review round 1 (module-local SpellGrid cards, cast target check, CLI without panic hook)
- SpellGrid cards move to course/10-spellgrid/cards; start-module and
  verify-references stage course/cards plus module-local cards up to the module,
  so M5-M9 workspaces get exactly the pre-M10 card set.
- cast() rejects a chosen-target spell without a target (checkCast/checkPlay);
  new test_10_targeted_spell_needs_target.
- Rust CLI pre-validates instead of swapping the global panic hook.
- Catalog: CRIER noun; DEATHRATTLE/BATTLECRY note on lexicon vs catalog role.
- Lesson: design note on mid-movement reparse.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-29 05:11:09 +01:00
2026-10-29 04:28:17 +01:00
2026-10-29 00:07:14 +01:00

Systemic Design Course

A free, hands-on course on systemic game design. You learn by rebuilding the rules machinery of two games, then extending it:

  • Part I: Hearthstone (cards, zones, triggers, death phases, auras, text assembly)
  • Part II: Baba Is You (rules as pushable text, parsing, movement, win/lose)
  • Part III: SpellGrid, a small original game that combines both systems

Every module follows the same beats: Observe, Predict, Spec, Build, Name it, Expansion Drop, Further reading. The Expansion Drop is the test of your design: you add new content without touching the engine.

Two paths

  • Designer path: read the lessons and scenarios, predict outcomes, and reason about the design.
  • Builder path: also make the tests pass in your own engine.

Two tracks

Builder path exercises exist in Rust and TypeScript. Both tracks have identical test names, matching the scenarios in each module's scenarios.md.

Quick start

node --version        # Node 24 for the course tooling
npm run test:tools    # tooling tests
npm run check         # test names agree across Rust, TS and scenarios
node tools/start-module.mjs 01 path/to/your/workspace

start-module copies a module's tests for your track (from your workspace's .course.json) and refuses to start a module if you have not yet taken the previous one. Module 00 uses the naive-engine/ project and is not started this way.

Other tools: tools/coupling-audit.mjs <workspace> (engine code must not name specific cards or nouns), tools/expansion-check.mjs <workspace> <baseRef> (an Expansion Drop must change content only), tools/verify-references.mjs [NN] (reference solutions pass the tests).

Licence

MIT, for both prose and code. See LICENSE. The course is and stays free.

Disclaimer

Not affiliated with Blizzard or Hempuli. See the disclaimer.

S
Description
No description provided
Readme MIT
747 KiB
Languages
Rust 51.7%
TypeScript 42.5%
JavaScript 5.6%
MDX 0.2%